Function
Limits output to the job's monitoring file to a specified set of categories unless a FULLTRACE command has been issued, in which case no TRACE command in the job will have any effect. The minimum selection of categories allowable is determined by the Installation Parameter MINTRACE.
Format
TRACE action on monitoring file
| Monitoring Categories | |
| ALL | Everything is to be printed |
| ALLBUT (AB) | The whole file is to be printed apart from the categories that follow ALLBUT |
| FULL (FU) | The whole file is to be printed apart from the categories |
| FULLBUT (FB) | The whole file is to be printed apart from the categories that follow FULBUT |
| NONE | No printing is required |
| BROADCAS (BC) | Output as a result of a BROADCAST command given by the operator or internally by GEORGE. This can never be suppressed by a REPORT command and is therefore not relevant to that command, but is relevant to commands operating on the monitoring file |
| CENTRAL (CN) | ? |
| CLUSTER (CL) | ? |
| COMERR (CE) | Command error reporting |
| COMMANDS (CM) | A copy of each command |
| COMMENT (CT) | Command responses giving a track of the job's progress |
| DISPLAY (DP) | Output from the DISPLAY, QUESTION and ANSWER commands |
| ENGINEER (EN) | ? |
| FILES (FL) | Output converning file movements and changes in the filestore |
| JOURNAL (JL) | ? |
| LISTING (LS) | Output from the LISTFILE and LISTDIR commands |
| LOGGING (LG) | Log analysis information |
| OBJECT (OJ) | Output concerned with or sent by object programs |
| ONLINE (OL) | Output from object programs (see the ONLINE command |
| OPERATOR (OP) | Equivalent to CENTRAL and CLUSTER combined |
| POSTMORT (PM) | Output from the POSTMORTEM and PRINT commands |
Forbidden contexts
NO USER
Execution
When a job is started, hte categories of output to its monitoring file are determined by installation parameter (JOBTRACE for background jobs, MOPTRACE for MOP jobs.
The first TRACE command in a job changes the set of categories to that specified in its parameter list. A TRACE command supercedes any previous TRACE commands issued at the same command processor level. Any subsequent TRACE command issued at a lower level changes the category set to include those categories specified in its parameter list which have not been excluded by a TRACE command at a higher level. When control returns to the higher level (at the end of a macro) the category set reverts to that which obtained when the macro was issued.
The minimum tracing level is set by the Installation Parameter MINTRACE and the categories specified by this parameter will always be included in the categories set by a TRACE command, even if they were not specified in its parameter list.
If a FULLTRACE command is issued, any further TRACE commands in the job will have no effect.
Examples
TRACE ALLBUT,COMMANDS
TRACE LISTING,COMERR
Error Messages
z IS AN UNKNOWN MONITORING CATEGORY