Appendix E - OmniTRACS Job Monitor

The Job Monitor watches selected batch processes that are critical for the functioning of QTRACS and related applications. When one of the monitored processes is determined to have a problem, then a problem notification is made to inform the specified user(s) of the problem condition. Problem notification is made via QTRACS unless a problem is detected with the Notification Router. When it is detected that the Notification Router is either not at a normal running condition or the Notification Router's input queue is backlogged, notification is made via OS/400 messaging.
The monitor will detect and report the following conditions:

The absence of a monitored job.
A monitored job that has gone to a status of MSGW (message wait).
A communications manger that has a status of INACTIVE.
A data queue that is backlogged.
A data queue that has an access problem (damaged).

By default, the monitor is delivered with the following jobs defined: OMQCOMMB, OMRTR, OMRTRNFY, OMSTRFWD, OMPBMGR, OMSENSOR, OMTRAILER, OMJTRACS. However, only jobs pertaining to the products that are installed will be monitored.

Preparation

Notification

Notification can be made to a single user or to multiple users. If the notification is to be made to multiple users, then an Address List must be setup in QTRACS for this purpose. Even if you decide to notify a single user, it is easier to setup the Address List now with one user, which will make it easier to add additional users later.

QTRACS Communications Manager / Router Subsystem

Determine the AS/400 Subsystem under which the Comm Manager and Router run. Use the DSPSBSD (Display Subsystem Description) to view the details of this subsystem. DSPSBSD provides several pages of information with a menu to select the display page. You should review the pages noting the maximum number of jobs. The monitor will add an additional job to this subsystem and therefore, the maximum job settings may need to be changed. A subsystem can specify a maximum number of jobs for the subsystem, a maximum number of jobs for a routing entry, or a maximum number of jobs for a job queue. Make note of the job queue for the subsystem. Usually the subsystem is QUALCOMM and the job queue is also QUALCOMM.

Monitor Configuration

Monitor is a Registered External Application

The Monitor has been registered in QTRACS as an external application. The application name is MONITOR and the input data queue is MTMONITOR. The remaining parameters are set to the default values.

Monitor Configuration

To enter the Monitor Configuration screen, type 23 from the QTRACS Command Menu. From the list that is displayed, select "Batch Job Monitor".

The "Work with Monitor Configuration" screen is now displayed. Select 1 to invoke the main configuration display from which you can view or change the global configuration values. If desired, F11 may be pressed to set the configuration parameters to the default values. Otherwise, enter the Notification Type and Notification User. While it is possible to specify a notification type of *PROGRAM, it is recommended that *USER or *BOTH be used at this time. The notification user must be a QTRACS user or Address List. Review the Monitor Check Frequency, Job Problem Notification Delay and Data Queue Backlog Notification Delay with the current installation in mind. Make any changes that are necessary.

Configure Monitored Jobs

Take option 2 (Work with Jobs to Monitor) from the Work with Monitor Configuration menu.
From the list of monitored jobs that are displayed, one can view (option 5) or change (option 2) the monitored jobs configuration values. Use the F6 key to add any jobs to the list that you wish to monitor, and are not already shown. If desired, press the F10 key to view the WRKACTJOB display for all jobs and subsystems that are currently running. Use F3 to exit the WRKACTJOB display.

For each job, a data queue can also be monitored for backlog. The time in minutes that defines a backlog for the data queue should be reviewed and changed if necessary. Take note that if the QTRACS Router's queue (OMRECVQ) normally runs 15 minutes behind, then consider using 30 or 45 minutes as the backlog definition for that queue.

When finished, press Enter to save your changes return.

MTMONITOR Job Description

Monitor v2.1 is delivered with a predefined job description that will be adequate for most customers. The monitor can produce logs which can be useful in diagnosing problems, and as a means of reviewing the operational history of the monitor. Job switches control logging.

U1	ON	Log will be produced
	OFF	Log will not be produced
U2	ON	Log all checks
	OFF	Log only exception conditions
U3 - U7		Not used
U8	ON	Produce status summary

The Log and Status summaries are intended for Qualcomm use and not customers. The primary purpose is to verify monitor actions, and to summarize monitored job status. The MTMONITOR job description has been preset with the following job switches: 11000001

It is possible that one or more of the following items in the MTMONITOR job description may need to be changed:

Job Queue	The job queue should be the same as the job queue specified in the configuration.
Output Queue	Select an output queue where the Log and Status Summary will be placed. This queue should not be cleared by the user and should not print.
User	Set this to the same user profile under which the Comm Manager and Router run. This has been preset to QPGMR.
Initial Library List	Verify that the list is correct for the current installation.

Use the CHGJOBD command to make any necessary changes to these values.

Setup Subsystem

The monitor has been setup as an auto start job entry for the subsystem to which it was installed. Therefore, no setup should be required here. However, if the monitor is ever removed from your list of auto start jobs, it can easily be added to the subsystem with the command:
ADDAJE SBSD(QUALCOMM) JOB(MONITOR) JOBD(MTMONITOR)

Note: If the subsystem used by the installation is not QUALCOMM then substitute the correct subsystem in the above command.

Start/Stop the Monitor

The monitor can be started or stopped from the command line with the following commands:
SBMMNTR
ENDMNTR