INQUIRE TRACETYPE
Retrieve information about CICS® system tracing.
Description
The INQUIRE TRACETYPE command tells you which levels of tracing are currently in effect for particular CICS system 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 ask about either type for any number of components in an INQUIRE TRACETYPE command, but you can ask about only one type per command.
For each component that you specify, the trace levels are returned as a 32-bit string (in a 4-character data area). 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. A value of X'80000000' thus represents trace level 1. Bits for trace levels that are not defined are set to zero.
Options
- COMPID(data-area)
- Returns
the trace levels for the CICS component
identified by COMPID in the format described above. CICS components can be identified by a 2-character identifier or, in some cases, a descriptive keyword. For example, to determine the trace levels for the directory manager component of CICS, you can specify either:
orINQUIRE TRACETYPE DD(data-area)
The following list shows all the 2-character identifiers, and the keywords for those components that have them.INQUIRE TRACETYPE DIRMGR(data-area)
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 (previously called System Management RESTful API) W2 WEB2 Web 2.0 domain XM TRANMGR Transaction manager XS SECURITY Security manager - FLAGSET(cvda)
- Indicates
whether the standard or special flags for the specified component
are to be returned. CVDA values are as follows:
- SPECIAL
- Indicates that CICS returns the trace levels for special tracing.
- STANDARD
- Indicates that CICS returns the trace levels for standard tracing.
Conditions
- INVREQ
- RESP2 values:
- 1
- An incorrect value was specified for FLAGSET.
- NOTAUTH
- RESP2 values:
- 100
- The user associated with the issuing task is not authorized to use this command.
- NOTFND
- RESP2 values:
- 1
- CICS was initialized without support for at least one of the components listed in the command; trace levels were returned for all other components.