MONITOR, MONUSERS, ROUTCODE, DESCCODE
The MONITOR, MONUSERS, ROUTCODE, and DESCCODE keywords are valid with the BUILD, CLONE, DBSCAN, RELOAD, REORG (Online Reorg function and Reorg function), UNLOAD, and OREORG commands.
The DESC and ROUTCDE options are valid with the Prefix Resolution/Update function. You can specify the MONITOR option in the environment setup member (DLIGSET0) or in PLUSIN. The ROUTCODE and DESCCODE keywords are available in PLUSIN; they are not available as global options. The following table describes the keywords.
Monitoring keywords
To do this | Specify this in PLUSIN |
|---|---|
Monitor job progress at specified interval (issue message every nnnnnnnn seconds). | MONITOR(nnnnnnn) |
Send messages to TSO user ID. | MONUSERS(user01,user02,...) |
Send messages to OS consoles. | ROUTCODE(n,n,n,...) DESCCODE(n,n,n,...) |
Send messages to OS consoles. (Prefix Resolution/Update function) | ROUTCDE(n,n,n,...) DESC(n,n,n,...) |
Internal default: No automatic monitoring, send monitor messages to the console and BMCMSG, ROUTCODE(2,7), DESCCODE(7). | |
The MONITOR and MONUSERS keywords let you monitor the job. Monitoring is always available through the MVS MODIFY command; however, if you assign a value to the MONITOR keyword, MAXM Reorg solutions issue a message at a user-specified interval.
If you specify a TSO user ID with the MONUSERS keyword, MAXM Reorg/EP solutions send the messages to that TSO user’s terminal. You can specify as many as 10 user IDs. The user IDs are not checked for validity (for example, all messages sent to an invalid user ID are lost).
You can issue commands to request various monitoring tasks. To receive monitoring messages at specified intervals, you must specify a value for the MONITOR keyword.
The ROUTCODE and DESCCODE keywords allow you to specify routing and descriptor codes for MAXM Reorg solutions messages. If you specify routing and descriptor codes, MAXM Reorg/EP solutions send the WTO to the MVS consoles indicated by the codes.
Routing codes send MAXM Reorg solutions messages to the MVS system consoles where they can be displayed. More than one routing code can be assigned to a message to send it to more than one console. You can specify a maximum of 10 routing codes, separated by commas. The defaults are 2 (master console) and 7 (unit record pool). For the Prefix Resolution/Update function, the defaults are 1,7,11.
Descriptor codes describe the significance of messages. These codes determine how the system displays and deletes messages. You can specify a maximum of 10 descriptor codes, separated by commas. The default is 7.
For a description of message routing and descriptor codes, see the IBM MVS/ESA Routing and Descriptor Codes manual.
Use the MVS MODIFY command (F) to manipulate monitoring keywords. With the MODIFY command, you can show the monitor intervals and TSO user IDs in effect, display the progress of the job, and set or change values that were set with the MONITOR and MONUSERS keywords.
The commands are described in the next section. Use the following format for all MODIFY commands, where jobName is the MVS job name and command is the specific utility command:
This section contains the following topics:
Related topic