Enabling CTRACE at IKE daemon startup
A default minimum component trace is always started during IKE daemon initialization. Use a parmlib member to customize the parameters that are used to initialize the trace. The default IKE daemon component trace parmlib member is the SYS1.PARMLIB member CTIIKE00. The parmlib member name can be changed using the IKED_CTRACE_MEMBER environment variable.
Tip: The IKE daemon reads the IKED_CTRACE_MEMBER
environment variable only during initialization. Changes to IKED_CTRACE_MEMBER
after daemon initialization have no affect.
For a description of trace options, see Table 1.
Restriction: In addition to specifying the trace options, you
can also change the IKE daemon trace buffer size. The buffer size
can be changed only at IKE initialization and has a maximum of 256
MB.
If the CTIIKE00 member or the member that is specified in IKE_CTRACE_MEMBER is not found when starting the IKE daemon, the following message is issued:
IEE5381 memberName MEMBER NOT FOUND IN PARMLIB
When this occurs, the IKE daemon component trace is started with a buffer size of 1 MB and the MINIMUM tracing option.
/*********************************************************************/
/* */
/* z/OS Communications Server */
/* SMP/E Distribution Name: CTIIKE00 */
/* */
/* PART Name: CTIIKE00 */
/* */
/* */
/* Copyright: */
/* Licensed Materials - Property of IBM */
/* 5694-A01 */
/* (C) Copyright IBM Corp. 2005 */
/* Status: CSV1R7 */
/* */
/* */
/* DESCRIPTION = This parmlib member causes component trace for */
/* the TCP/IP IKE application to be initialized */
/* with a trace buffer size of 1M */
/* */
/* This parmlib members only lists those TRACEOPTS */
/* values specific to IKE. For a complete list */
/* of TRACEOPTS keywords and their values see */
/* z/OS MVS Initialization and Tuning Reference. */
/* */
/* */
/* */
/*********************************************************************/
TRACEOPTS
/* ---------------------------------------------------------------- */
/* Optionally start external writer in this file (use both */
/* WTRSTART and WTR with same wtr_procedure) */
/* ---------------------------------------------------------------- */
/* WTRSTART(wtr_procedure) */
/* ---------------------------------------------------------------- */
/* ON OR OFF: PICK 1 */
/* ---------------------------------------------------------------- */
ON
/* OFF */
/* ---------------------------------------------------------------- */
/* BUFSIZE: A VALUE IN RANGE 128K TO 256M */
/* CTRACE buffers reside in IKE daemon Private storage */
/* which is in the regions address space. */
/* ---------------------------------------------------------------- */
BUFSIZE(1M)
/* WTR(wtr_procedure) */
/* ---------------------------------------------------------------- */
/* OPTIONS: NAMES OF FUNCTIONS TO BE TRACED, OR "ALL" */
/* ---------------------------------------------------------------- */
/* OPTIONS( */
/* 'ALL ' */
/* , 'MINIMUM ' */
/* , 'INIT ' */
/* , 'TERM ' */
/* , 'EXCEPT ' */
/* , 'CONFIG ' */
/* , 'WORKUNIT' */
/* , 'SERIAL ' */
/* , 'IKE ' */
/* , 'CRYPTO ' */
/* , 'OPMSGS ' */
/* , 'LOGMSGS ' */
/* , 'MSGQ ' */
/* , 'TIMER ' */
/* , 'SOCKETS ' */
/* , 'IOCTL ' */
/* , 'REQUESTS' */
/* , 'FLOW ' */
/* , 'STORAGE ' */
/* , 'EVENT ' */
/* , 'POLICY ' */
/* , 'CONTROL ' */
/* , 'MISC ' */
/* , 'DEBUG ' */
/* ) */Figure 1. SYS1.PARMLIB
member CTIIKE00