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