DFM Service Maintenance
This program lets you view the status of the DFM services and change configuration values without having to access the configuration files.
Exploring
Any configuration changes made using the DFM Service Maintenance program only takes effect when next the service polls for a change in configuration information.
All changes are saved to and read from the database. If no information is found on the database, the DFM Service Maintenance program reads the configuration file.
Although you can amend values by changing the service configuration file (e.g. for debugging purposes) you should rather maintain these values using this program as the saved values defined here are the ones used by the service.
Things you can do in this program include:
- Pause the services.
-
Specify that logging is required.
-
Change the polling interval that defaults to 30 seconds.
-
Change the time interval to determine if there is a change to the configuration.
- Change the file delete interval.
This program is accessed from the Program List pane of the SYSPRO menu:
-
Program List > Administration > Document Flow Manager
Starting
You can restrict operator access to programs by assigning them to groups and applying access control against the group (configured using the Operator Groups program).
- The following flags can't be maintained in this program, but can be edited in the SYSPRODFMQueuePoller.exe.config and SYSPRODFMFolderPoller.exe.config configuration files.
- zeroFileSizeDeleteTime
- ConfigPollType (defaults to ss - seconds)
- FolderPollType (defaults to ss - seconds)
PollType (defaults to ss - seconds)
Solving
Although the following flags can't be maintained in the DFM Service Maintenance program, you can edit them in the SYSPRODFMQueuePoller.exe.config and SYSPRODFMFolderPoller.exe.config configuration files:
- ZeroFileSizeDeleteTime
- ConfigPollType (defaults to ss - seconds)
- FolderPollType (defaults to ss - seconds)
-
PollType (defaults to ss - seconds)
The password held against the operator used to start the services may have changed. This could occur automatically by the operating system, depending on the password policy setup.
Solution
-
Review the password settings defined against the operator who is starting the services.
-
Review the message logs within the Event Viewer.
This is most likely due to an invalid operator/password combination or the operator doesn't have sufficient permission to access the folder contents.
Solution
Review the message logs within the Event Viewer.
You can define the FileSizeDeleteTime at the File delete interval column of the DFM Service Maintenance program.
Any configuration changes made using the DFM Service Maintenance program only takes effect when next the service polls for a change in configuration information.
This interval can be specified at the Config Interval column of the DFM Service Maintenance program.
The event log is created when DFM is installed. The log is output to the following folder, which you can review for diagnosing any problems you may encounter:
Control Panel > System and Security Administrative Tools > Event Viewer > Applications and Service Logs
You can open each entry in the log to view the error or warning details.
The event log is only available if you have selected Yes at the Log required option in the list view of the DFM Service Maintenance program.
Likely causes are that the document is not being picked up at all, or is being picked up but the Document Flow Manager user doesn't have permission to delete the original document from the folder.
If the document is not being processed, then there are a number of possible causes:
-
The contract is configured to poll a different folder.
Check the relative pathing from which the service is run.
If the folder is on a remote workstation, ensure that the machine is running and that the SYSPRO application server can see both the machine and the share/mapped drive.
-
The file does not match the file type defined against the contract.
-
The contract is disabled.
-
The SYSPRO 8 Document Flow Manager Folder Poller service doesn't have permission to access the folder.
-
The file is defined as read-only.
Review the properties against the file.
-
The SYSPRO 8 Document Flow Manager Folder Poller service is not running.
The SYSPRO 8 Document Flow Manager Queue Poller service is not running, or the contract is not configured to output the results from the business object.
Solution
-
Review the contract to ensure that it is configured to output the results from the business object and that the correct folder is specified.
-
Check that the operating system user who is starting the SYSPRO 8 e.net Communications Load Balancer service has been granted write-access to the folder.
-
Check that the user for the SYSPRO 8 e.net Communications Load Balancer service has been granted write-access to the Failed folder.
Using
-
Any configuration changes made using the DFM Service Maintenance program only takes effect when next the service polls for a change in configuration information.
This interval can be specified at the Config Interval column of the DFM Service Maintenance program.
-
Columns in a list view are sometimes hidden by default. You can reinstate them using the Field Chooser option from the context-sensitive menu (displayed by right-clicking a header column header in the list view). Select and drag the required column to a position in the list view header.
-
Press Ctrl+F1 within a list view or form to view a complete list of functions available.
Referencing
Field | Description |
---|---|
File | |
Save |
This saves the details you entered or changed. |
Save and Close |
This saves the details you entered or changed and returns to the previous screen. |
Exit | This exits the program. |
Refresh |
This refreshes the pane information. |
Field | Description |
---|---|
Server name |
This indicates the DFM service you are maintaining. |
Type |
This indicates whether the service relates to the Folder poller or Queue poller. |
Instance |
This is an internal flag. |
Description |
This indicates a description of the service for identification purposes. |
Status |
This indicates the current status of the service (e.g. paused, running, etc). |
Paused flag |
This indicates whether the service is currently paused (Yes or No). |
Log required |
This indicates whether a diagnostic trace log is required for the service (Yes or No). |
Poll interval |
This indicates how often the service will poll for new files in configured contract folders and is measured in the unit of time specified at the PollType flag. This defaults to 30 seconds, but can be changed here. |
Configuration interval |
This indicates how often (in seconds) the service will poll for changes made to the configuration information. If the service can't reach the SYSPRO 8 e.net Communications Load Balancer or business object, it will retry once this interval has lapsed. |
Service started date |
This indicates the date the service was last started. |
Service started time | This indicates the time the service was last started. |
Last updated date |
This indicates the last date the configuration of the service was changed. |
Last updated time | This indicates the time the configuration of the service was last updated. |
File delete interval | This lets you define the intervals in which 0KB files will be deleted from the polling folder. |
Copyright © 2021 SYSPRO PTY Ltd.