Specifying trace options at initialization
- S tcpip_procedure_name,PARMS=CTRACE(CTIEZBxx)
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.
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 ' */
/* ) */
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.
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:
|
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:
|
DLC | Turns on the following trace options:
|
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:
|
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:
|
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:
|
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:
|
OEUDP | Turns on the following trace options:
|
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:
|
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:
|
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:
|
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:
|
TC | Turns on the following trace options:
|
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:
Turns on the following trace option for the TN3270E Telnet
server running in its own address space:
|
UD | Turns on the following trace options:
|
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. |