GTRACE

Edit online

Collects trace data and passes it to GTF.

Type

CUA Operator command

Format

GTRACE resource CLASS([TERM|ACB])[ON|OFF] GTRACE CLASS(INT)  option [ON|OFF]
resource
The resource name to be traced. It can be a physical terminal LU name or the name of an ACB, depending on the specification of the CLASS operand. This operand is required if ON or OFF is specified.
CLASS
The class of the object being traced. The default for CLASS is CLASS(TERM). If you specify CLASS(INT) you can specify option, but resource is not applicable.
option
One of the following internal trace options that are described under the TRACE command. The default is ALL.
ALL
DEFAULT
DISPATCH
ERROR
LOGICRES
PSM
STORAGE
VSAM
VTAM®

Usage Notes

  1. This command is used for gathering information for diagnostic purposes, usually at the direction of IBM Support.
  2. This command is used in conjunction with the GTF command, which should be issued first. (See the GTF command in this manual.) If the GTF ON command was not issued, GTRACE ON generates a warning message.
  3. The object being traced need not be active when the GTRACE command is issued. If the object is not active, a pending trace request is queued. Upon activation of the object, it is traced automatically.
  4. GTRACE CLASS(TERM) can be used only to trace physical terminal sessions. If a virtual terminal is specified, an error message is generated. If tracing of the virtual terminal session is desired, specify CLASS(ACB) or use the VSSTRACE command if you are using CL/SuperSession.
  5. If no ON or OFF operand is specified, the trace status of resource, if specified, is displayed. If no resource is specified, the trace status of all the objects of the CLASS specified, is displayed. If CLASS is not specified, trace status of all objects of all classes is displayed.
  6. Internal trace options are the same as for the TRACE command. The GTRACE command can be used in place of the TRACE command.
  7. The recorded trace information can be formatted and printed by the supplied KLSUSR20 module located in TLSSAMP.

Example

To collect trace data for terminal L618A15:
   GTRACE L618A15 CLASS(TERM) ON
To trace all sessions using the ACB AALVM010: 
   GTRACE AALVM010 CLASS(ACB) ON
To display the trace status of the ACB AALVM010:
   GTRACE AALVM010 CLASS(ACB)
To display all ACBs that are being traced:
   GTRACE CLASS(ACB)
To display the trace status of ACBs and physical terminals being traced, together with the internal trace status:
   GTRACE
To trace all internal DISPATCH and VTAM events:
   GTRACE 'DISPATCH,VTAM' CLASS(INT) ON