TRACE command

Use the MVS™ TRACE command to start, modify, or stop the trace after TCP/IP has been started. The TRACE command replaces all prior settings except the buffer size. When modifying the options, be sure to specify the SOCKAPI option.

The examples below show how to start the trace.

The SUB option is the subtrace name, which for TCP/IP, is the job name of the stack ( this is the TCP/IP start procedure name). In the following examples, the subtrace is TCPIPROC (the name of the sample procedure), and the variable fields are in lowercase.

To activate the trace with just the SOCKAPI option, code the following:

   TRACE CT,ON,COMP=SYSTCPIP,SUB=(tcpiproc)                
   R n,JOBNAME=(ezasokjs),OPTIONS=(sockapi),end

To specify a PARMLIB member, which contains the trace options, code the following:

   TRACE CT,ON,COMP=SYSTCPIP,SUB=(tcpiproc),PARM=ctiezban

To stop the trace, either use the TRACE CT,OFF command or reissue the TRACE CT,ON command with different parameters.

The following is an example of the OFF option:

   TRACE CT,OFF,COMP=SYSTCPIP,SUB=(tcpiproc)

When using the TRACE command, be sure to notice message ITT038I, which indicates whether the command was successful or not. The following is an example of ITT038I:

  14.11.29  ITT038I NONE OF THE TRANSACTIONS REQUESTED VIA THE TRACE CT 
  COMMAND WERE SUCCESSFULLY EXECUTED.                                  
or
  14.11.40  ITT038I ALL OF THE TRANSACTIONS REQUESTED VIA THE TRACE CT   
  COMMAND WERE SUCCESSFULLY EXECUTED.

See z/OS MVS System Commands for more information about the TRACE command.