Chapter 4 - Monitoring

4.3.1 CONNECT:Direct Stuck Process Check

• Enabling and Disabling CONNECT:Direct Stuck Process Check
  
• Modifying the CONNECT:Direct Stuck Process Check
  

• Enabling and Disabling CONNECT:Direct Audit Log Scan
  
• Modifying the CONNECT:Direct Audit Log Scan
  

• Enabling and Disabling Gentran Stuck Document Check
  
• Modifying the Gentran Stuck Document Check
  

• Enabling and Disabling Gentran Queue Length Check
  
• Inserting a Gentran Queue Length Check
  
• Deleting a Gentran Queue Length Check
  
• Modifying a Gentran Queue Length Check
  

4.3.1 CONNECT:Direct Stuck Process Check

The CONNECT:Direct Stuck Process Check will examine the Process (TCQ) queue of CONNECT:Direct searching for documents that have not been processed in a timely manner. You may instruct eLerter that you wish to know about processes that have not been processed ‘x’ minutes passed the scheduled process start time.

Enabling and Disabling CONNECT:Direct Stuck Process Check

To enable the CONNECT:Direct Stuck Process Check, use the right mouse key to select CONNECT:Direct Stuck Process Check in the left hand pane of the configuration manager. This action will enable you to click on the Change Next Run Time option – see Figure 4.3.1.1. For assistance on changing the next run time or changing properties, click here.

Figure 4.3.1.1 CONNECT:Direct Stuck Process Check

Modifying the CONNECT:Direct Stuck Process Check

To change the properties of the CONNECT:Direct Stuck Process Check, select the CONNECT:Direct Stuck Process Check from the left-hand pane of the configuration manager. Right mouse click on the option and select Properties from the menu. The following dialog box will appear (Figure 4.3.1.2).

Figure 4.3.1.2 CONNECT:Direct Stuck Process Check Properties

This dialog box provides CONNECT:Direct information and the ability to modify parameters. The table below describes the contents:

Property	Description
Last run time	Time of most recent action
Time taken for last run	How long it took the system to run the process (recorded in seconds)
Next Run Time	The time the next action will begin
Run period	How regularly the process will occur. Eg. ‘15’ would indicate the process will run every 15 minutes
Continuous Breaches	The number times this CONNECT:Direct check has failed consecutively
Total Breaches	The total number of failures for this CONNECT:Direct Check
Run After Breach	Specifies the IntelliStart command to run on failure of the CONNECT:Direct Check
Local Node	The CONNECT:Direct node on which to run this check
Age Limit	The maximum acceptable time threshold (in hours) post the scheduled process start time. Example: If a process was scheduled to start at 08.00 and the Age limit was set at 2 hours. If at 10.01 the process did not start, an error will be raised by eLerter

Table 4.3.1.1 CONNECT:Direct Stuck Process Check Properties

4.3.2 CONNECT:Direct Audit Log Scan

The CONNECT:Direct Audit Log Scan scans the CONNECT:Direct STAT table for entries that:

• Possess a Record ID (‘RecId’) as specified by the CONNECT:Direct user; and
• Possess a condition code greater then or equal to a value as specified by the user.

CONNECT:Direct currently allows the user to enter a comma separated list of RecIds, ensuring that these records are logged in the NT Event Log, no matter what the condition code. There are advantages in using the eLerter scan as opposed to the native CONNECT:Direct scan. These are as follows:

• It will not impact on the performance of CONNECT:Direct;
• It will not fill the NT Event Log with unnecessary entries;
• CONNECT:Direct does not need to be stopped and started each time the RecId list is changed; and
• Support staff do not have to memorise the RecIds of the codes required.

For a list of CONNECT:Direct RecIds, please refer to Appendix A.

Enabling and Disabling CONNECT:Direct Audit Log Scan

To enable the CONNECT:Direct Audit Log Scan, use the right mouse key to select CONNECT:Direct Audit Log Scan in the left hand pane of the configuration manager. This action will enable you to click on the Change Next Run Time option – see Figure 4.3.2.1. For assistance on changing the next run time or changing properties, click here.

Figure 4.3.2.1 CONNECT:Direct Audit Log Scan

Modifying the CONNECT:Direct Audit Log Scan

To change the properties of the CONNECT:Direct Audit Log Scan, select the CONNECT:Direct Audit Log Scan from the left-hand pane of the configuration manager. Right mouse click on the option and select Properties from the menu. The following dialog box will appear (Figure 4.3.2.2).

Figure 4.3.2.2 CONNECT:Direct Audit Log Scan Properties

This dialog box provides CONNECT:Direct information and the ability to modify parameters. The table below describes the contents:

Property	Description
Last run time	Time of most recent action
Time taken for last run	How long it took the system to run the process (recorded in seconds)
Next Run Time	The time the next action will begin
Run period	How regularly the process will occur. Eg. ‘15’ would indicate the process will run every 15 minutes
Continuous Breaches	The number times this CONNECT:Direct check has failed consecutively
Total Breaches	The total number of failures for this CONNECT:Direct Check
Run After Breach	Specifies the IntelliStart command to run on failure of the CONNECT:Direct Check
Local Node	The CONNECT:Direct node on which to run this check.Generally there is only one node per server
Min Condition Cd	The minimum CONNECT:Direct condition code on which to report
Record ID List	User-friendly list of Record IDs from which to choose. Hint: Hold down the Control key when selecting Rec IDs to select one or more at a time

Table 4.3.2.1 CONNECT:Direct Audit Log Scan Properties

4.3.3 Gentran Stuck Document Check

This check finds Gentran Documents that are left in the In or Out Documents area and Interchanges in the Interchange Queue that have a ‘Sent Time’ set to blank and that were created more then ‘x’ minutes ago. Entries will be written in the NT Event Log as:

• Warning if they are older then minutes old; and
• Error if they are older then minutes old.

Enabling and Disabling the Gentran Stuck Document Check

To enable the Gentran Stuck Document Check, use the right mouse key to select Gentran Stuck Document Check in the left hand pane of the configuration manager. This action will enable you to click on the Change Next Run Time option – see Figure 4.3.3.1. For assistance on changing the next run time or changing properties, click here.

Figure 4.3.3.1 Gentran Stuck Document Check

Modifying the Gentran Stuck Document Check

To change the properties of the Gentran Stuck Document Check, select the Gentran Stuck Document Check from the left-hand pane of the configuration manager. Right mouse click on the option and select Properties from the menu. The following dialog box will appear (Figure 4.3.3.2).

Figure 4.3.3.2 Gentran Stuck Document Check Properties

This dialog box provides Gentran information and the ability to modify parameters. The table below describes the contents:

Property	Description
Last run time	Time of most recent action
Time taken for last run	How long it took the system to run the process (recorded in seconds)
Next Run Time	The time the next action will begin
Run period	How regularly the process will occur. Eg. ‘15’ would indicate the process will run every 15 minutes
Continuous Breaches	The number times this Gentran check has failed consecutively
Total Breaches	The total number of failures for this Gentran Check
Run After Breach	Specifies the IntelliStart command to run on failure of the Gentran Check
Gentran ODBC DSN	ODBC DSN to connect to the Gentran database
Warning Level	Warning level time in minutes
Error Level	Error level time in minutes

Table 4.3.3.1 Gentran Stuck Document Check Properties

4.3.4 Gentran Queue Length Check

There are a number of document and interchange queues in the Gentran software. For Documents these queues are:

• In Drawer
• Out Drawer
• In Documents
• In ?
• Out Documents
• Out ?
• Workspace
• Queued

For Interchanges these queues are:

• Received
• Sent
• Ready to Send
• Queued
• Hold
• Overdue

A backlog of documents in these Gentran queues may simply indicate a temporary build-up of documents or it may indicate a potential problem. The eLerter Gentran Queue Length check allows you to be notified when there are more then ‘x’ documents or interchanges in a queue.

Enabling and Disabling the Gentran Queue Length Check

To enable the Gentran Queue Length Check, use the right mouse key to select Gentran Queue Length Check in the left hand pane of the configuration manager. This action will enable you to click on the Change Next Run Time option – see Figure 4.3.4.1. For assistance on changing the next run time or changing properties, click here.

Figure 4.3.4.1 Gentran Queue Length Check

To change the properties of the Gentran Queue Length Check, select the Gentran Queue Length Check from the left-hand pane of the configuration manager. Right mouse click on the option and select Properties from the menu. The following dialog box will appear (Figure 4.3.4.2).

Figure 4.3.4.2 Gentran Queue Length Check Properties

This dialog box provides Gentran information and the ability to modify parameters. The table below describes the contents:

Property	Description
Last run time	Time of most recent action
Time taken for last run	How long it took the system to run the process (recorded in seconds)
Next Run Time	The time the next action will begin
Run period	How regularly the process will occur. Eg. ‘15’ would indicate the process will run every 15 minutes
Gentran ODBC DSN	ODBC DSN to connect to the Gentran database

Table 4.3.4.1 Gentran Queue Length Check Properties

Inserting a Gentran Queue Length Check

To add a new check to the Gentran Queue Length Check, use the right mouse click to select Insert in the left-hand pane of the configuration manager, see Figure 4.2.4.3. This action will enable you to begin adding a new Gentran Queue Length check.

Figure 4.3.4.3 Gentran Queue Length Insert

The following dialog box will be displayed.

Figure 4.3.4.4 Gentran Queue Length Properties

Table 4.3.4.2 describes the field properties.

Property	Description
Queue Name	Select the Gentran Queue Name from the list
Count Threshold	The maximum allowable error count
Notify After	Instruct eLerter to notify personnel after x consecutive breaches

Table 4.3.4.2 Gentran Queue Length Properties

Deleting a Gentran Queue Length Check

Highlight the Gentran Queue Length check (or checks) you wish to delete from the Queue Name column (as shown in Figure 4.3.4.5). Either left mouse click to bring up the delete option or delete the file using the keyboard delete button.

Figure 4.3.4.5 Gentran Queue Length Check Delete

Modifying a Gentran Queue Length Check

To change the properties of a Gentran Queue Length Check, select the Queue from the Queue Name column in the right-hand pane of the configuration manager. Double click on the selected Queue and the following dialog box will appear (Figure 4.3.4.6).

Figure 4.3.4.6 Gentran Queue Length Check Properties

This dialog box provides Queue information and the ability to modify parameters. The table below describes the contents:

Property	Description
Continuous Breaches	The number times this Gentran check has failed consecutively
Total Breaches	The total number of failures for this Gentran Check
Run After Breach	Specifies the IntelliStart command to run on failure of the Gentran Check
Queue Name	Select the Gentran Queue Name from the list
Count Threshold	The maximum allowable error count
Notify After	Instruct eLerter to notify personnel after x consecutive breaches

Table 4.3.4.3 Gentran Queue Length Check Properties