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 of the SYSPRO menu:

  • Program List > Administration > Document Flow Manager

Overview topic

Document Flow Manager

Services

SYSPRO 8 Document Flow Manager Folder Poller

SYSPRO 8 Document Flow Manager Queue Poller

PDF and Video Resources

Install Guides

Feature Guides

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 listview 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 listview 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 listview). Select and drag the required column to a position in the listview header.

  • Press Ctrl+F1 within a listview 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.