Modifying with the PARMLIB member
Because TCP/IP, OMPROUTE, RESOLVER, IKE daemon, NSS server, DMD, and the trace command are accessing the PARMLIB data sets, they need to be authorized for read access to these data sets by RACF® or another security product.
To change component trace options using a PARMLIB member, create a SYS1.PARMLIB member and specify the component member on the PARM= keyword of the TRACE CT command.
Use the following syntax:
TRACE CT,ON,COMP=component_name,SUB=(procedure_jobname)
,PARM=parmlib_member
Following
are descriptions of the parameters:
- COMP
- Indicates the component name:
- SYSTCPDA
- TCP/IP packet trace. There is no parmlib member. Options are specified by the VARY TCPIP,,PKTTRACE command (see Packet trace (SYSTCPDA) for TCP/IP stacks).
- SYSTCPDM
- Defense Manager daemon, parmlib = CTIDMD00 (see TCP/IP services component trace for the Defense Manager daemon).
- SYSTCPIK
- IKE daemon, parmlib = CTIIKE00 (see TCP/IP services component trace for the IKE daemon).
- SYSTCPIP
- TCP/IP event trace, parmlib = CTIEZBxx, where xx is any 2 alphanumeric characters (see Event trace (SYSTCPIP) for TCP/IP stacks and Telnet).
- SYSTCPIS
- TCP/IP intrusion detection service, parmlib = CTIIDSxx (see Intrusion Detection Services trace (SYSTCPIS)).
- SYSTCPNS
- Network security services server, parmlib = CTINSS00 (see TCP/IP services component trace for the network security services (NSS) server).
- SYSTCPOT
- TCPIP OSA-Express® Network Traffic Analyzer (OSAENTA) trace. TCP/IP event trace, parmlib = CTINTA00, (see OSAENTA trace (SYSTCPOT)). An alternate CTINTA00 member cannot be specified on the EXEC statement of the TCPIP procedure. CTINTA00 will always be used when starting TCPIP. Only an alternate buffer size or external writer procedure can be specified. All options are provided by the OSAENTA command.
- SYSTCPRE
- Resolver, parmlib = CTIRESxx (see Diagnosing resolver problems).
- SYSTCPRT
- OMPROUTE, parmlib = CTIORA00 (see TCP/IP services component trace for OMPROUTE).Tip: An optional suffix, CTIORAxx, is also available.
- SUB
- Indicates the started procedure name for TCP/IP, the OMPROUTE
application, the RESOLVER, the IKE daemon started task name, the network
security services (NSS) server started task name, the Defense Manager
daemon (DMD) started task name, or the Telnet started task name for
which the trace is run. If you use the S procname,jobname method to start TCP/IP, OMPROUTE, IKE daemon, network security services
(NSS) server, DMD, or Telnet, you must specify the same value for
the SUB parameter that is specified for the jobname value. There can be as many as eight TCP/IP sessions and eight Telnet
sessions active in one system. Restrictions:
- Only one OMPROUTE application can be active on each TCP/IP stack.
- Only one RESOLVER application can be active with each operating system.
- Only one IKE daemon application can be active with each operating system.
- Only one network security services (NSS) server application can be active with each operating system.
- Only one Defense Manager daemon (DMD) application can be active with each operating system.
- PARM
- Identifies the PARMLIB member that contains the trace options (see COMP). All options can be respecified. However, the buffer size cannot be changed if OMPROUTE, the IKE daemon, the NSS server, the DMD, or the RESOLVER are running. If a different size is required, you must stop OMPROUTE, IKE daemon, network security services server, DMD, or the RESOLVER, and then restart it after modifying the PARMLIB member.
If the incorrect parmlib member is specified,
one of the following messages might be issued:
- An incorrect CTIEZBxx member is specified
on the TRACE CT,ON command:
IEE538I CTIEZBxx MEMBER NOT FOUND IN SYS1.PARMLIB ITT010I COMPONENT TRACE PROCESSING FAILED FOR PARMLIB MEMBER=CTIEZBxx: PARMLIB MEMBER NOT FOUND.
- An incorrect CTIEZBxx member is specified
on the CTRACE() keyword of the EXEC statement of the TCP/IP started
procedure:
IEE538I CTIEZBxx MEMBER NOT FOUND IN SYS1.PARMLIB
- An incorrect CTIORAxx member is specified
on the TRACE CT,ON command:
IEE5381 CTIORAxx MEMBER NOT FOUND in SYS1.PARMLIB ITT01011 COMPONENT TRACE PROCESSING FAILED FOR PARMLIB MEMBER=CTIORAxx: PARMLIB MEMBER NOT FOUND
- An incorrect CTINTA00 member is specified on the TRACE CT,ON command:
IEE5381 CTINTA00 MEMBER NOT FOUND in SYS1.PARMLIB ITT01011 COMPONENT TRACE PROCESSING FAILED FOR PARMLIB MEMBER=CTINTA00: PARMLIB MEMBER NOT FOUND