Controlling GTF for JES3 *TRACE

Function

Use the following procedure to invoke GTF to trace message routing in your installation:

Enter the MVS™ Start GTF command and specify at least the following keywords:
- Identifier that specifies the GTF session at your installation.
- MEMBER=mbrname.
```
S GTF.identifier,MEMBER=mbrname
```
Reply U to message AHL125A so that GTF uses the options specified in the specified SYS1.PARMLIB member (mbrname as specified on the MEMBER= parameter). If you do not respond with U, you must specify new GTF options.
Issue the *Trace command for JES3 using the following format and parameters.

Syntax


           .-,--INQ--,--ALL----------------.   
>>-*TRACE--+-------------------------------+-------------------><
           +-| ,INQ (Inquiry Parameters) |-+   
           +-| ,ON (On/Off Parameters) |---+   
           '-| ,OFF (On/Off Parameters) |--'   

Inquiry Parameters

   .-,--ALL-------.   
|--+-,--nn*-------+---------------------------------------------|
   +-,--WTOSSI----+   
   +-,--WTLSSI----+   
   +-,--WLMENF----+   
   +-,--WLMMDSFCT-+   
   +-,--WLMMDSJOB-+   
   +-,--WLMGMSFCT-+   
   +-,--WLMGMSJOB-+   
   +-,--WLMSAMPRC-+   
   +-,--WLMSAMPSC-+   
   +-,--SAPI------+   
   +-,--WLMWLMFCT-+   
   +-,--JOBDELAY--+   
   '-,--MBSTATS---'   

On/Off Parameters

|--+-,--ALL-------+---------------------------------------------|
   +-,--nn*-------+   
   +-,--WTOSSI----+   
   +-,--WTLSSI----+   
   +-,--WLMENF----+   
   +-,--WLMMDSFCT-+   
   +-,--WLMGMSFCT-+   
   +-,--WLMMDSJOB-+   
   +-,--WLMGMSJOB-+   
   +-,--WLMSAMPRC-+   
   +-,--WLMSAMPSC-+   
   +-,--SAPI------+   
   +-,--WLMWLMFCT-+   
   +-,--JOBDELAY--+   
   '-,--MBSTATS---'

Parameters

INQ: Displays the GTF trace record identifiers you are currently tracing. INQ,ALL is the default. If you specify INQ without an option, the command will default to INQ,ALL. You can specify a generic trace name using nn*. See z/OS JES3 Diagnosis for more information about the trace records.
ON: Enables the tracing of all JES3 GTF trace records, or you can trace a subset of JES3 GTF records by specifying a trace name with the ON parameter. You can also specify a generic trace name using nn*.
OFF: Disables the tracing of all JES3 GTF trace records, or you can disable the tracing of a subset of JES3 GTF trace records by specifying a trace name with the OFF parameter. You can also specify a generic trace name using nn*.

Example

Enable tracing for messages issued by the WTO macro (SVC 35):

*TRACE,ON,WTOSSI

IAT7136 JES3 GTF TRACE STATUS
  TRACE ID  TRACE NAME     STATUS      TRACE ID  TRACE NAME    STATUS
  --------  ------------  --------     --------  ----------    ------
         1  WTOSSI        ACTIVE              2  WTOSSI        ACTIVE
         3  WTOSSI        ACTIVE              8  WTOSSI        ACTIVE
         9  WTOSSI        ACTIVE             11  WTOSSI        ACTIVE
        12  WTOSSI        ACTIVE

Note: Unless the console where you issued the *TRACE command receives messages that are issued with a routing code of ten or its destination class equivalent, you will not receive message IAT7136 at the console where you issued the command.