Specifying trace options at initialization

To start TCP/IP with a specific trace member, use the following command:

S tcpip_procedure_name,PARMS=CTRACE(CTIEZBxx)

where CTIEZBxx is the component trace SYS1.PARMLIB member.

You can create this member yourself, or you can update the default SYS1.PARMLIB member, CTIEZB00. For a description of trace options available in the CTIEZB00, see Table 1.

Tip: Besides specifying the TCP/IP traces that you want, you can also change the component trace buffer size.

You can use IBM® Health Checker for z/OS® to check whether TCP/IP Event Trace (SYSTCPIP) is active with options other than the default options (MINIMUM, INIT, OPCMDS, or OPMSGS). For more details about IBM Health Checker for z/OS, see IBM Health Checker for z/OS.

/********************************************************************/
/*                                                                  */
/*  IBM Communications Server for z/OS                              */
/*  SMP/E Distribution Name: CTIEZB00                               */
/*                                                                  */
/*  MEMBER:  CTIEZB00                                               */
/*                                                                  */
/*                                                                  */
/* Copyright:    Licensed Materials - Property of IBM               */
/*                                                                  */
/*               5694-A01                                           */
/*                                                                  */
/*               Copyright IBM Corp. 1996, 2011.                    */
/*                                                                  */
/*     STATUS =  CSV1R13                                            */
/*                                                                  */
/*  DESCRIPTION = This parmlib member causes component trace for    */
/*                the TCP/IP product to be initialized with a       */
/*                trace buffer size of 8 megabytes.                 */
/*                                                                  */
/*                This parmlib member only lists those TRACEOPTS    */
/*                value specific to TCP/IP.  For a complete list    */
/*                of TRACEOPTS keywords and their values see        */
/*                z/OS MVS INITIALIZATION AND TUNING REFERENCE.     */
/*                                                                  */
/* $MAC(CTIEZB00) PROD(TCPIP): Component Trace SYS1.PARMLIB member  */
/*                                                                  */
/********************************************************************/
 TRACEOPTS
 /* ---------------------------------------------------------------- */
 /*   ON OR OFF: PICK 1                                              */
 /* ---------------------------------------------------------------- */
           ON
 /*        OFF                                                       */
 /* ---------------------------------------------------------------- */
 /*   BUFSIZE: A VALUE IN RANGE 1M TO 1024M                          */
 /* ---------------------------------------------------------------- */
           BUFSIZE(8M)
 /*        JOBNAME(jobname1,...)                                     */
 /*        ASID(Asid1,...)                                           */
 /*        WTR(wtr_procedure)                                        */
 /* ---------------------------------------------------------------- */
 /*   Note, the following groups of trace options are supported:     */
 /*                                                                  */
 /*   ALL     = All options except MISC, PFSMIN, ROUTE, SERIAL,      */
 /*             SOCKAPI, STORAGE, TCPMIN, and TIMER                  */
 /*   CSOCKET = PFS + SOCKET                                         */
 /*   DLC     = CLAW + INTERNET + LCS + VTAM + VTAMDATA              */
 /*   IN      = CONFIG + INIT + IOCTL + OPCMDS + OPMSGS              */
 /*   LATCH   = SERIAL                                               */
 /*   MINIMUM = INIT + OPCMDS + OPMSGS                               */
 /*   ALLMIN  = INIT + OPCMDS + OPMSGS + MINPFS + MINTCP             */
 /*   OETCP   = ENGINE + PFS + QUEUE + TCP                           */
 /*   OEUDP   = ENGINE + PFS + QUEUE + UDP                           */
 /*   PING    = ARP + ICMP + RAW + ND                                */
 /*   RW      = ENGINE + PFS + QUEUE + RAW + SOCKET                  */
 /*   SMTP    = ENGINE + IOCTL + PASAPI + PFS + QUEUE + SOCKET + TCP */
 /*   SYSTEM  = INIT + OPCMDS + OPMSGS + SERIAL + STORAGE + TIMER +  */
 /*             WORKUNIT                                             */
 /*   TC      = ENGINE + PFS + QUEUE + SOCKET + TCP                  */
 /*   TN      = PFS + TCP + TELNET + TELNVTAM                        */
 /*   UD      = ENGINE + PFS + QUEUE + SOCKET + UDP                  */
 /*                                                                  */
 /* ---------------------------------------------------------------- */
 /*                                                                  */
 /*   PFSMIN  = Reduced set of PFS trace data                        */
 /*   TCPMIN  = Reduced set of TCP trace data                        */
 /*   ALLMIN  = PFSMIN + TCPMIN                                      */
 /*                                                                  */
 /*                                                                  */
 /*   NOTE:    The xxxMIN and the corresponding xxx options should   */
 /*            not be active at the same time.  The will collect     */
 /*            duplicate information.                                */
 /*                                                                  */
 /*   OPTIONS: NAMES OF FUNCTIONS OR GROUPS TO BE TRACED:            */
 /*                                                                  */
 /* ---------------------------------------------------------------- */
 /*        OPTIONS(             */
 /*                'ALL     '   */
 /*               ,'ALLMIN  '   */
 /*               ,'ACCESS  '   */
 /*               ,'AFP     '   */
 /*               ,'ARP     '   */
 /*               ,'CLAW    '   */
 /*               ,'CONFIG  '   */
 /*               ,'CSOCKET '   */
 /*               ,'DLC     '   */
 /*               ,'EID(hhhhhhh,hhhhhhhh) '             */
 /*               ,'ENGINE  '   */
 /*               ,'FIREWALL'   */
 /*               ,'ICMP    '   */
 /*               ,'IN      '   */
 /*               ,'INIT    '   */
 /*               ,'INTERNET'   */
 /*               ,'IOCTL   '   */
 /*               ,'IPADDR(nnn.nnn.nnn.nnn/mmm.mmm.mmm, */
 /*                        nnn.nnn.nnn.nnn/pp,          */
 /*                        hhhh::hhhh/ppp)              */
 /*               ,'IPSEC   '   */
 /*               ,'LATCH   '   */
 /*               ,'LCS     '   */
 /*               ,'MESSAGE '   */
 /*               ,'MINIMUM '   */
 /*               ,'MISC    '   */
 /*               ,'ND      '   */
 /*               ,'NONE    '   */
 /*               ,'OETCP   '   */
 /*               ,'OEUDP   '   */
 /*               ,'OPCMDS  '   */
 /*               ,'OPMSGS  '   */
 /*               ,'PASAPI  '   */
 /*               ,'PFS     '   */
 /*               ,'PFSMIN  '   */
 /*               ,'PING    '   */
 /*               ,'POLICY  '   */
 /*               ,'PORT(ppppp,ooooo,rrrrr,ttttt) ' */
 /*               ,'QUEUE   '   */
 /*               ,'RAW     '   */
 /*               ,'ROUTE   '   */
 /*               ,'RW      '   */
 /*               ,'SERIAL  '   */
 /*               ,'SMTP    '   */
 /*               ,'SNMP    '   */
 /*               ,'SOCKAPI '   */
 /*               ,'SOCKET  '   */
 /*               ,'STORAGE '   */
 /*               ,'SYSTEM  '   */
 /*               ,'TC      '   */
 /*               ,'TCP     '   */
 /*               ,'TCPMIN  '   */
 /*               ,'TELNET  '   */
 /*               ,'TELNVTAM'   */
 /*               ,'TIMER   '   */
 /*               ,'TN      '   */
 /*               ,'UD      '   */
 /*               ,'UDP     '   */
 /*               ,'VTAM    '   */
 /*               ,'VTAMDATA'   */
 /*               ,'WORKUNIT'   */
 /*               ,'XCF     '   */
 /*                )            */

Figure 1. SYS1.PARMLIB member CTIEZB00

A group activates multiple trace options. The group name identifies traces that should be activated for a specific problem area, and trace groups provide a way to collect trace data by problem type.

Table 1 describes the available trace options and groups.

Table 1. Trace options and groups
Trace Event	Description
ALL	All types of records except MISC, PFSMIN, ROUTE, SERIAL, STORAGE, TCPMIN, and TIMER. Slow Performance: Using this option slows performance considerably, so use with caution. Also available for the TN3270E Telnet server running in its own address space.
ALLMIN	Turns on the following trace options: INIT OPCMDS OPMSGS PFSMIN TCPMIN
ACCESS	Trace creation, modification, and manipulation of the Network Access tree, along with results of all Network Access queries.
AFP	Turns on trace for fast response cache accelerator.
ARP	Shows address resolution protocol (ARP) cache management and ARP timer management. This option also shows all outbound and inbound ARP packets. Tip: The information provided differs depending on the type of device. Guideline: The ARP and ND options are aliases. If you turn one on, you turn on the other option, and if you turn one off, you turn off the other option. When formatting the trace, these options can be filtered separately.
CLAW	Shows all control flows for a CLAW device.
CONFIG	Turns on trace for configuration updates.
CSOCKET	Turns on the following trace options: PFS SOCKET
DLC	Turns on the following trace options: CLAW INTERNET LCS VTAM® VTAMDATA
EID(list)	Turns on trace by event identifier. The event identifiers are 8 hexadecimal digits. Up to 16 can be specified. Use only under the direction of IBM Support.
ENGINE	Turns on trace for stream head management. Guideline: The ENGINE and QUEUE options are aliases. If you turn one on, you turn on all related options, and if you turn one off, you turn off all related options. These alias options are only for recording the trace. When formatting the trace, these options can be filtered separately.
FIREWALL	Turns on trace for firewall events. Tip: Synonymous with IPSEC option.
ICMP	Turns on trace for the ICMP protocol.
IN	Turns on the following trace options: CONFIG INIT IOCTL OPCMDS OPMSGS
INIT	Turns on trace for TCP/IP Initialization/Termination. Note: The INIT, OPCMDS, and OPMGS options are aliases. If you turn one on, you turn on all related options, and if you turn one off, you turn off all related options. These alias options are only for recording the trace. When formatting the trace, these options can be filtered separately. Also available for the TN3270E Telnet server running in its own address space.
INTERNET	Turns on trace for Internet Protocol layer. Tip: Using this option slows performance considerably, so use with caution.
IOCTL	Turns on trace for IOCTL processing.
IPADDR(list)	Turns on trace by IP address.
IPSEC	Turns on trace for IP security events. Tip: Synonymous with FIREWALL option.
LATCH	Turns on the following trace option: SERIAL
LCS	Shows all control flows for an LCS device.
MESSAGE	Turns on trace for message triple management. Tip: Using this option slows performance considerably, so use with caution. Also available for the TN3270E Telnet server running in its own address space.
MINIMUM	Turns on the following trace options: INIT OPCMDS OPMSGS
MISC	Turns on trace for miscellaneous TCP/IP internal diagnostic tests.
NONE	Turn off all traces but exception traces, which always stay on. Also available for the TN3270E Telnet server running in its own address space.
ND	Enable Neighbor Discovery trace option. Guideline: The ARP and ND options are aliases. If you turn one on, you turn on the other option, and if you turn one off, you turn off the other option. When formatting the trace, these options can be filtered separately.
OETCP	Turns on the following trace options: ENGINE PFS QUEUE TCP
OEUDP	Turns on the following trace options: ENGINE PFS QUEUE UDP
OPCMDS	Turns on traces of operator commands. Guideline: The INIT, OPCMDS, and OPMGS options are aliases. If you turn one on, you turn on all related options, and if you turn one off, you turn off all related options. These alias options are only for recording the trace. When formatting the trace, these options can be filtered separately.
OPMSGS	Turns on message trace for console messages. Guideline: The INIT, OPCMDS, and OPMGS options are aliases. If you turn one on, you turn on all related options, and if you turn one off, you turn off all related options. These alias options are only for recording the trace. When formatting the trace, these options can be filtered separately.
PASAPI	Turns on traces for transforms that handle Pascal APIs.
PFS	Turns on trace for the physical file system layer. Tip: The PFS and PFSMIN options should not be specified together; the PFS option gathers all the information that the PFSMIN option gathers.
PFSMIN	Turns on the minimum PFS trace option. Tip: The PFS and PFSMIN options should not be specified together; the PFS option gathers all the information that the PFSMIN option gathers.
PING	Turns on the following trace options: ARP ICMP RAW
POLICY	Trace the stack usage of Policy Rules and Actions.
PORT(list)	Turns on trace by port number.
QUEUE	Turns on trace for stream queue management. Guideline: The ENGINE and QUEUE options are aliases. If you turn one on, you turn on all related options, and if you turn one off, you turn off all related options. These alias options are only for recording the trace. When formatting the trace, these options can be filtered separately.
RAW	Turns on trace for the RAW transport protocol.
ROUTE	Trace manipulation of IP Routing Tree.
RW	Turns on the following trace options: ENGINE PFS QUEUE RAW SOCKET
SERIAL	Turns on trace for lock obtain and release. Tip: Using this option slows performance considerably, so use with caution. Also available for the TN3270E Telnet server running in its own address space.
SMTP	Turns on the following trace options: ENGINE IOCTL PASAPI PFS QUEUE SOCKET TCP
SNMP	Turns on trace for SNMP SET requests.
SOCKAPI	Trace Macro and Call Instruction API calls (see Socket API traces).
SOCKET	Turns on trace for the Sockets API layer.
STORAGE	Turns on trace for storage obtain and release. Tip: Using this option slows performance considerably, so use with caution. Also available for the TN3270E Telnet server running in its own address space.
SYSTEM	Turns on the following trace options: INIT OPCMDS OPMSGS SERIAL STORAGE TIMER WORKUNIT
TC	Turns on the following trace options: ENGINE PFS QUEUE SOCKET TCP
TCP	Turns on trace for the TCP transport protocol. Restriction: The TCP and TCPMIN options should not be specified together; the TCP option gathers all the information that the TCPMIN option gathers. Slow Performance: Using this option slows performance considerably, so use with caution.
TCPMIN	Turns on the minimum TCP trace option. Slow Performance: The TCP and TCPMIN options should not be specified together; the TCP option gathers all the information that the TCPMIN option gathers. The same is also true for the PFS and PFSMIN options.
TELNET	Turns on trace for TELNET events. Only useful when used by the TN3270E Telnet server.
TELNVTAM (an alias for TELNET)	Turns on trace for TELNET events.
TIMER	Turns on trace for TCP timers. Slow Performance: Using this option slows performance considerably, so use with caution. Also available for the TN3270E Telnet server running in its own address space.
TN	Turns on the following trace options for TCP: PFS TCP Turns on the following trace option for the TN3270E Telnet server running in its own address space: TELNET
UD	Turns on the following trace options: ENGINE PFS QUEUE SOCKET UDP
UDP	Turns on trace for UDP transport protocol. Slow Performance: Using this option slows performance considerably, so use with caution.
VTAM	Shows all of the nondata-path signaling occurring between IF and VTAM.
VTAMDATA	Shows data-path signaling between IF and VTAM, including a snapshot of media headers and some data. Slow Performance: Using this option slows performance considerably, so use with caution.
WORKUNIT	Turns on trace for work unit scheduling.
XCF	Turns on trace for XCF events.