TM TRACE | TM T
This command activates and deactivates the ThruPut Manager tracing facility. The trace facility is provided to allow you to trace installation exit activity. Tracing can also be used to gather data for problem reporting to Customer Support, but these options should only be activated on the explicit recommendation of Customer Support, and therefore are not documented here. If there is a need for this capability, Customer Support will provide the specific commands you should use.
Scope: System
Duration: Until next IPL.
TM TRACE | [? | HELP] |
Requests the command syntax from HELP.
Adds the specified trace request to the tracing queue for the job name supplied. Tracing is performed only if the Job Analyzer processes a job that has the same job name.
The short form for this keyword is A.
Deletes the specified trace request from the tracing queue. If no ID is specified, all trace requests are deleted.
Display the status of exits. This is the default.
Specifies the trace identification value. For an ADD, this identifier is needed if the trace request is to be deleted later.
The short form for this keyword is ID.
- id - A one to four character trace identification.
Indicates that a job is to be traced. Tracing begins when this jobname is processed by the Job Analyzer. This option is effective only for Job Analyzer exits.
- jobname - Name of the job to be traced.
Activates global tracing for all exits and all jobs.
Deactivates tracing.
Examples:
/TM TRACE DELETE ID(T1)
/TM TRACE ON
Notes:
- Job Analyzer exit tracing can be enabled with either the TM TRACE ADD or the TM TRACE ON command. Using the ADD option allows you to trace specific jobs.
- Both the TM TRACE command with the ON keyword and the TM EXIT command with the TRACE keyword must be issued to enable tracing for a specific installation exit.
- Tracing for Job Analyzer exits goes to the job's SYSMSGS data set.
- GTF must be active to trace TMSS exits. The GTF trace options must include tracing for USR event number 249.