Enabling CTRACE at Defense Manager daemon startup
A default minimum component trace is always started during DMD initialization. Use a parmlib member to customize the parameters that are used to initialize the trace. The default DMD component trace parmlib member is the SYS1.PARMLIB member CTIDMD00. The parmlib member name can be changed using the DMD_CTRACE_MEMBER environment variable.
Rule: The DMD reads the DMD_CTRACE_MEMBER
environment variable only during initialization. Changes to DMD_CTRACE_MEMBER
after server initialization have no affect.
Restriction: In addition to specifying the trace
options, you can also change the DMD trace buffer size. The buffer
size can be changed only at DMD initialization and has a maximum size
of 256 MB.
If the CTIDMD00 member or the member that is specified
in DMD_CTRACE_MEMBER is not found when starting the DMD, the following
message is issued:
IEE5381 memberName MEMBER NOT FOUND IN PARMLIB When this occurs, the DMD component trace is started with a buffer size of 1 MB and the MINIMUM tracing option.
Figure 1. SYS1.PARMLIB member CTIDMD00
/*********************************************************************/
/* z/OS Communications Server */
/* SMP/E Distribution Name: CTIDMD00 */
/* */
/* PART Name: CTIDMD00 */
/* */
/* Copyright: */
/* Licensed Materials - Property of IBM */
/* 5694-A01 */
/* Copyright IBM Corp. 2008 */
/* Status: CSV1R10 */
/* */
/* DESCRIPTION = This parmlib member causes component trace for */
/* the TCP/IP Defense Manager daemon application to be initialized */
/* with a trace buffer size of 1M */
/* */
/* This parmlib member only lists those TRACEOPTS */
/* values specific to DM. 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 THE RANGE OF 128K TO 256M */
/* CTRACE buffers reside in the Defense Manger daemon's private */
/* storage which is in the region's address space. */
/* ---------------------------------------------------------------- */
BUFSIZE(1M)
/* WTR(wtr_procedure) */
/* ---------------------------------------------------------------- */
/* OPTIONS: NAMES OF FUNCTIONS TO BE TRACED, OR "ALL" */
/* ---------------------------------------------------------------- */
/* OPTIONS( */
/* 'ALL ' */
/* , 'MINIMUM ' */
/* , 'INIT ' */
/* , 'TERM ' */
/* , 'EXCEPT ' */
/* , 'CONFIG ' */
/* , 'ROUTING ' */
/* , 'COMMANDS' */
/* , 'LOGMSGS ' */
/* , 'SERIAL ' */
/* , 'EVENT ' */
/* , 'SOCKETS ' */
/* , 'REQUESTS' */
/* , 'FLOW ' */
/* , 'STORAGE ' */
/* , 'CONTROL ' */
/* , 'VERBOSE ' */
/* , 'DEBUG ' */
/* , 'PERFORM ' */
/* ) */