Modifying or displaying the monitoring parameters *START,MONITOR

Function

Use the following command to modify or display the monitoring parameters:

Syntax


>>-+-*START-+--,--MONITOR--------------------------------------->
   '-*S-----'               

>--+-,--ID--=--+-ALLOCQ---+--+-| COUNT= Option |---+-+---------><
   |           +-CIFSS----+  +-| INTERV= Option |--+ |   
   |           +-DSPWAIT--+  +-| SUMMARY= Option |-+ |   
   |           +-IOWAIT---+  '-| THRESH= Option |--' |   
   |           +-JSSWAIT--+                          |   
   |           +-LOCATE---+                          |   
   |           +-RESOURCE-+                          |   
   |           +-SYSSELQ--+                          |   
   |           +-SYSVERQ--+                          |   
   |           '-VERIFYQ--'                          |   
   '-,--DISPLAY--------------------------------------'   

COUNT= Option

|--,--COUNT--=--+-ALL-+--+-------------------+--+-------------------------+--+-------------------+--|
                '-nnn-'  '-,--INTERV--=--nnn-'  '-,--SUMMARY--=--+-YES--+-'  '-,--THRESH--=--nnn-'   
                                                                 +-ONLY-+                            
                                                                 '-NO---'                            

INTERV= Option

|--,--INTERV--=--nnn--+----------------------+--+-------------------------+--+-------------------+--|
                      '-,--COUNT--=--+-ALL-+-'  '-,--SUMMARY--=--+-YES--+-'  '-,--THRESH--=--nnn-'   
                                     '-nnn-'                     +-ONLY-+                            
                                                                 '-NO---'                            

SUMMARY= Option

|--,--SUMMARY--=--+-YES--+--+----------------------+--+-------------------+--+-------------------+--|
                  +-ONLY-+  '-,--COUNT--=--+-ALL-+-'  '-,--INTERV--=--nnn-'  '-,--THRESH--=--nnn-'   
                  '-NO---'                 '-nnn-'                                                   

THRESH= Option

|--,--THRESH--=--nnn--+----------------------+--+-------------------+--+-------------------------+--|
                      '-,--COUNT--=--+-ALL-+-'  '-,--INTERV--=--nnn-'  '-,--SUMMARY--=--+-YES--+-'   
                                     '-nnn-'                                            +-ONLY-+     
                                                                                        '-NO---'

Parameters

ID=

Specifies the name of the monitoring definition to modify. The name is defined by the ID= parameter on the MNTRDEF macro.

You can display the name, other information, by entering the *START,MONITOR,DISPLAY command.

The following are the JES3 supplied values.

RESOURCE

Specifies monitoring of an unavailable JES3 resource. A JES3 resource is anything that can be used by an FCT and that can become unavailable. The monitor DSP allows you to monitor the following JES3 resources:

Generalized subtasks
AENQ resources
JQEs
Job numbers
File directory entries
JSAM buffers
Spool space.

ALLOCQ

Specifies monitoring of jobs waiting in the MDS allocate queue for a resource to become available.

CIFSS

Specifies monitoring of jobs scheduled to a converter/interpreter functional subsystem (C/I FSS).

DSPWAIT

Specifies monitoring of jobs waiting for a particular DSP to become available.

IOWAIT

Specifies monitoring of the ending function waiting for I/O to complete.

JSSWAIT

Specifies monitoring of a job on a job segment scheduler (JSS) wait queue waiting for an event to occur or a resource to become available. For example:

Jobs waiting for a PROCLIB to become available.
Jobs waiting for a main processor, class, or group to become available.
Jobs waiting for DFSMS-managed user catalogs to become available.
Jobs waiting for a main processor to become available for catalog locate.

LOCATE

Specifies monitoring of jobs in catalog locate.

SYSSELQ

Specifies monitoring of jobs waiting in the MDS system select queue for DFSMS-managed resources to become available.

SYSVERQ

Specifies monitoring of jobs waiting in the system verify queue.

VERIFYQ

Specifies monitoring of jobs waiting in the MDS verify queue for one or more volume mounts to complete.

COUNT=

Specifies the number of FCTs or jobs over the threshold value that are displayed. The monitor DSP displays the jobs or FCTs in descending order based on the amount of time they have been waiting.

The count value must be in the range of 0 to 999, or ALL.

If you specify COUNT=ALL, all jobs or FCTs over the threshold value are displayed. If you specify COUNT=nnn, nnn number of jobs or FCTs are displayed. If you specify COUNT=0, no jobs or FCTs are displayed.

INTERV=

Specifies the time interval, in minutes, that the resource or queue is monitored and displayed. The interval value must be in the range of zero to 999.

If you change the interval from zero to a non-zero value, you activate monitoring for the particular queue or resource. If you change the interval from a non-zero value to 0, you deactivate monitoring for the particular queue or resource.

SUMMARY=YES|NO|ONLY

Specifies whether the monitor DSP issues a summary message describing the number of jobs or FCTs waiting.

If you specify SUMMARY=YES, a summary message is issued in addition to the messages issued for each job or FCT. If you specify SUMMARY=NO, messages are issued for each job or FCT; no summary message is issued. If you specify SUMMARY=ONLY, only the summary message is issued; no messages are issued for each job or FCT.

THRESH=

Specifies the minimum amount of time, in minutes, that a job or FCT must have been waiting on the specified queue or for the specified resource before the monitor DSP will display it. The threshold value must be in the range of 0 to 999.

If you specify THRESH=0, the job or FCT is displayed regardless of the amount of time it has been waiting.

DISPLAY

Specifies the name of the monitoring definition to display. You can display the name, or other information, by entering the *START,MONITOR,DISPLAY command.

Rule

You must specify at least one of the following parameters:

COUNT=
INTERV=
SUMMARY=
THRESH=

Examples

The MONITOR DSP issues messages IAT6399 and IAT6400 in response to the *START,MONITOR,DISPLAY command to describe the monitor parameters currently in effect. The below sample output of the *START,MONITOR,DISPLAY command shows the default parameters JES3 uses for each resource and queue if you do not change them.

IAT6399 ID       INTERVAL THRESHOLD COUNT SUMMARY STATUS
IAT6400 RESOURCE   005       001     ALL   YES    ACTIVE
IAT6400 LOCATE     005       001     ALL   YES    ACTIVE
IAT6400 CIFSS      005       001     ALL   YES    ACTIVE
IAT6400 SYSSELQ    005       005     ALL   YES    ACTIVE
IAT6400 ALLOCQ     000       000     ALL   YES    INACTIVE
IAT6400 VERIFYQ    000       000     ALL   YES    INACTIVE
IAT6400 SYSVERQ    005       001     ALL   YES    ACTIVE
IAT6400 DSPWAIT    005       005     ALL   ONLY   ACTIVE
IAT6400 JSSWAIT    005       005     ALL   ONLY   ACTIVE
IAT6400 IOWAIT     030       001     ALL   YES    ACTIVE

All of the information, with the exception of STATUS, is described in Modifying or displaying the monitoring parameters *START,MONITOR.

Note: If COUNT=0 and SUMMARY=NO, no messages are issued.

Changes made with the *START,MONITOR,ID= command take effect immediately. If you cancel the monitor DSP, the same values come back into effect when you reactivate the monitor DSP. However, when you restart JES3, the default parameters go back into effect.

When the modify is complete, the monitor DSP issues the following message:

IAT6402  MONITOR MODIFY PROCESSING COMPLETE

If any of the modify parameters are incorrect, the monitor DSP issues the following message:

IAT6401  MONITOR START COMMAND REJECTED - reasontext