SET TRACETYPE

Description

Use the SET TRACETYPE command to change the levels of tracing for one or more CICS components.

Each CICS component has trace levels defined separately for standard CICS tracing and special tracing. See Using traces in problem determination for definitions of these terms and for information about CICS tracing in general. You can set either type for any number of components in a SET TRACETYPE command, but you can set only one type per command.

For each component that you specify, you define the trace levels as a bit string. The bits are read from left to right; that is, the first bit corresponds to trace level 1, the second to trace level 2, and so on. A value of 1 turns on the trace level; 0 turns it off. For example, X'C0000000' turns on trace levels 1 and 2 and turns off all others.

Although most components define only a few trace levels, you must provide a 32-bit (4 byte) data value. CICS ignores bits that do not correspond to trace levels, and thus it does not matter whether you specify 0 or 1 for them.

Options

COMPID(data-value)

Sets the trace levels for the CICS component identified by COMPID, using the bits in the data value as described above.

CICS components can be identified by a 2 character designation or, in some cases, a descriptive keyword. For example, to set the trace levels for the storage manager component of CICS, you can specify either:

    SET TRACETYPE SM(data-value)

or

    SET TRACETYPE STORAGE(data-value)

The following list shows all the 2 character identifiers, and the keywords for those components that have them.

ID	Keyword	Application
AP	APPLICATION	Application
BA	BUSAPPMGR	Business applications manager
BM*		Basic mapping support
BR*	BRIDGE	3270 Bridge
CP*	CPI	Common programming interface
DC*		Dump control
DD	DIRMGR	Directory manager
DH	DOCUMENT	Document handling
DM	DOMAINMGR	Domain manager
DP	DEBUGTOOL	Debugging Profiles domain
DS	DISPATCHER	Dispatch manager
DU	DUMP	Dump manager
EC*	EVENTCAPTURE	Event capture
EI*		EXEC interface
EJ	ENTJAVA	Enterprise Java™ domain
EM	EVENTMGR	Event manager
EP	EVENTPROC	Event processing domain
FC*		File control and DL/I
GC	GLOBALCATLG	CICS global catalog manager
IC*		Interval control
IE	IPECI	ECI over TCP/IP domain
IS*		Intersystem communication
KC*		Task control
KE	KERNEL	Kernel
LC	LOCALCATLG	CICS local catalog manager
LD	LOADER	Program load manager
LG	LOGGER	Log manager
LM	LOCKMGR	Lock manager
ME	MESSAGE	Message manager
ML		Markup language domain
MN	MONITOR	Monitoring manager
MP	MANAGEDPLAT	Managed platform domain
NQ	ENQUEUE	Enqueue domain
OT	OBJECTTRAN	Object Transaction Service (OTS) domain
PA	PARAMGR	Parameter manager
PC*		Program control
PG	PROGMGR	Program manager
PI	PIPEMGR	Pipeline manager domain
PT	PARTNER	Partner manager
RA*	RMIADAPTERS	Resource manager adapters
RI*	RMI	Resource manager interface (RMI)
RL	RESLIFEMGR	Resource life-cycle domain
RM	RECOVERY	Recovery manager
RS	REGIONSTAT	Region status
RX	RRS	Resource recovery services
RZ	REQUESTSTRM	Request streams domain
SC*		Storage control
SH	SCHEDULER	Scheduler services domain for BTS
SJ	SJVM	CICS JVM domain
SM	STORAGE	Storage manager
SO	SOCKETS	Sockets
ST	STATISTICS	Statistics manager
SZ*		Front-end programming interface
TC*		Terminal control
TD*		Transient data
TI	TIMER	Timer manager
TR	TRACE	Trace manager
TS	TEMPSTORAGE	Temporary storage
UE*		User exit interface
US	USER	User interface
WB	WEB	Web domain
WU	WEBRESTMGR	CICS Management Client Interface (CMCI) domain
W2	WEB2	Web 2.0 domain
XM	TRANMGR	Transaction manager
XS	SECURITY	Security manager

Components marked * are subcomponents of the AP domain, and the trace entries for these components are produced with a trace point ID of AP nnnn.

FLAGSET(cvda)

Indicates whether the standard or special flags, for the specified component, are to be set. CVDA values are as follows:

SPECIAL

Specifies that you want to set levels for special tracing, for the components listed.

STANDARD

Specifies that you want to set levels for standard tracing, for the components listed.

Conditions

INVREQ

RESP2 values:

1

An incorrect value was specified for FLAGSET.

2

Invalid flag settings were applied to a domain. Make sure that you define the trace levels as a bit string (for example, X'C000000). Do not use character data (for example, 1-2), which can only be used to specify trace levels in the CETR transaction.

NOTAUTH

RESP2 values:

100

The user associated with the issuing task is not authorized to use this command.

NOTFND

RESP2 values:

1

At least one CICS component was not accessible. Trace levels were set for the other components.