If you press the help key (PF1), the following panels are displayed:
CETR Help: CICS Trace control facility FUNCTION OF THE MAIN PANEL. This panel displays the current state of CICS Internal, Auxiliary and GTF trace and the settings of the master system and user trace flags. The current values are obtained from the system on initial entry and subsequently every time ENTER or a PF key is pressed. The values can be altered by over-typing and pressing ENTER. The APPLID of the CICS system being queried is displayed in the top right corner of the screen. Further help information follows: 1. Data entry and alteration. 2. Description of fields. 3. Function key use on the main panel. PF 3=End 8=Next ENTER=End
CETR Help: CICS Trace control facility (1) DATA ENTRY AND ALTERATION. This is achieved by simply over-typing the existing data, and then pressing ENTER. Abbreviations may be used, provided they are not ambiguous. The minimum possible abbreviations are listed in capitals to the right hand side of the input fields. For example STO may be entered for STOPPED, but ST would not be allowed as it could mean STARTED or STOPPED. Erased or blank fields will redisplay the current level settings as known to CICS. These will be the levels current when ENTER was last pressed. They may have been changed from the previously displayed values by other activity in the system. All input will be validated when ENTER is pressed, and no internal settings will be made until all errors have been removed. PF 3=End 7=Back 8=Next ENTER=End
CETR Help: CICS Trace control facility (2) DESCRIPTION OF FIELDS. The values that can be set from the main panel are:- Internal Trace Status - Whether tracing to the main storage trace table is required. Internal Trace Table Size - The size of the main storage trace table. Auxiliary Trace Status - Whether tracing to the current auxiliary trace data set is required. Auxiliary Trace Dataset - The current data set. A = DFHAUXT, B = DFHBUXT. Auxiliary Switch Status - Whether a switch to the alternate extent is required at next or all end-of-extents. GTF Trace Status - Whether CICS is writing its trace data to GTF. Note that GTF must have been started to MVS. Master System Trace Flag - This flag must be on if CICS system-requested entries are to be written for STANDARD tracing tasks. Master User Trace Flag - This flag must be on if user-requested trace entries are to be produced. PF 3=End 7=Back 8=Next ENTER=End
CETR Help: CICS Trace control facility (3) FUNCTION KEY USE ON THE MAIN PANEL. Key Name Function ENTER Change Execute any changes. PF1 Help Display this help information. PF3 Quit Terminate the transaction. PF4 Components Display or set STANDARD or SPECIAL trace levels for individual CICS components. PF5 Ter/Trn Query or set current trace status for terminal or transaction. PF6 JVM Query or set current JVM trace options PF9 Messages Display any messages created, these can be warning (informative) messages, or errors. PF 3=End 7=Back ENTER=End
If you press the help key (PF1) while viewing the component trace options screen, the following panels are displayed:
CETR Help: CICS Component Trace FUNCTION OF THE COMPONENT TRACE PANEL The component trace panel is used to inquire and set the STANDARD and SPECIAL trace levels for the individual components of the CICS system. Every component of CICS has a number of trace points. Associated with each is a trace level. These levels are numbers from one to thirty-two. For the trace entry associated with the trace point to be made, the associated level must be active (except for exception traces). Each CICS task is either a STANDARD tracing task or a SPECIAL tracing task. This distinction is made at task attach time when the STANDARD or SPECIAL attributes of the terminal id and transaction id are examined. These can be set on the Terminal and Transaction Trace panel of CETR. Further help information follows: 1. Data entry and alteration 1 2. Data entry and alteration 2 3. Meanings of Component abbreviations. 4. Function key use on the component trace panels. PF 3=End 8=Next ENTER=End
CETR Help: CICS Component Trace (1) DATA ENTRY AND ALTERATION 1 From this panel detailed tracing levels can be set for each component. Each level is specified by a number between one and three, the presence of the number indicates that the level is set, the omission of a number indicates that the level is not set. Multiple consecutive levels are displayed as xx-yy, where xx is the lower of the consecutive values, and yy is the higher. For example, if 1-3 was displayed, then trace levels 1,2 and 3 would all be set. There is more than one page of components. Function keys PF7 and PF8 can be used in the usual way to switch pages. The page may only be switched when the displayed page contains no errors. Changes to the level settings are automatically validated when the current page is changed, but these levels are only set within CICS when ENTER is pressed. Until this time it is possible to quit from the program (PF3) without altering internal values. PF 3=End 7=Back 8=Next ENTER=End
CETR Help: CICS Component Trace (2) DATA ENTRY AND ALTERATION 2 The level settings may be changed by simply over-typing the existing data and then pressing ENTER. To set a single level enter the number. To set consecutive levels enter the first and last levels separated by a hyphen. Erased or blank fields will redisplay the current level settings as known to CICS. These will be the levels set when ENTER was last pressed. All levels may be set by entering ALL and none by entering OFF. To provide identical level settings for more than one component: - type the setting(s) for the first component, do not press ENTER. - type = in fields where you want this setting duplicated. NOTE: Although levels up to 32 may be set for most components, only levels 1,2 and 3 are currently used. PF 3=End 7=Back 8=Next ENTER=End
CETR Help: CICS Component Trace
(3) MEANINGS OF COMPONENT ABBREVIATIONS.
AP . . . Application domain IE . . . ECI over TCP/IP domain
BA . . . Business Application Manager II . . . IIOP domain
BM . . . Basic Mapping Support IS . . . ISC
BR . . . Bridge KC . . . Task Control
CP . . . CPI-C interface KE . . . Kernel
DC . . . Dump compatibility layer LC . . . Local Catalog domain
DD . . . Directory manager LD . . . Loader domain
DH . . . Document Handler domain LG . . . Log Manager domain
DM . . . Domain Manager domain LM . . . Lock Manager domain
DP . . . Debugging Profiles domain ME . . . Message domain
DS . . . Dispatcher domain MN . . . Monitoring domain
DU . . . Dump domain NQ . . . Enqueue Manager
EI . . . Exec interface OT . . . Object Transaction domain
EJ . . . Enterprise Java domain PA . . . Parameter Manager
EM . . . Event Manager domain PC . . . Program control
FC . . . File control PG . . . Program Manager domain
GC . . . Global Catalog domain
PI . . . Pipeline Manager domain
IC . . . Interval control PT . . . Partner Management
PF 3=End 7=Back 8=Next ENTER=End
CETR Help: CICS Component Trace (4) MEANINGS OF COMPONENT ABBREVIATIONS. RI . . . RMI WB . . . Web Domain RM . . . Recovery Manager XM . . . Transaction manager RX . . . RRMS domain XS . . . Security domain RZ . . . Request Streams SC . . . Storage control SH . . . Scheduler Services domain SJ . . . JVM domain SM . . . Storage manager domain SO . . . Sockets domain ST . . . Statistics domain SZ . . . Front End Prog Interface TC . . . Terminal control TD . . . Transient data TI . . . Timer domain TR . . . Trace domain TS . . . Temporary storage UE . . . User exit interface US . . . User domain PF 3=End 7=Back 8=Next ENTER=End
CETR Help: CICS Component Trace (5) FUNCTION KEY USE ON THE COMPONENT TRACE PANELS. Key Name Function ENTER Change Execute any Changes. PF1 Help Display this help information. PF3 Quit Return to main Trace Control panel. PF7 Backward Scroll backward one page. PF8 Forward Scroll forward one page. PF9 Messages Display any messages created, these can be warning (informative) messages, or errors. PF 3=End 7=Back ENTER=End
If you press the help key (PF1) while viewing the terminal and transaction trace screen, the following panels are displayed:
CETR Help: CICS Terminal and Transaction Trace FUNCTION OF THE TERMINAL AND TRANSACTION PANEL. This panel has two main functions. (1) To allow STANDARD/SPECIAL tracing to be set for tasks to be run from particular terminals or with particular transaction ids. It is also possible to suppress tracing for particular transaction ids. STANDARD tracing tasks use the STANDARD component flags. SPECIAL tracing tasks use the SPECIAL component flags. See the help information for the component panel for more detail. (2) To allow the setting of VTAM EXIT and ZCP tracing. The current settings will be displayed if transaction id, terminal id or netname are specified without other values. Further help information follows: 1. VTAM EXIT trace. 2. ZCP trace. 3. Function key use on the terminal and transaction panel. PF 3=End 8=Next ENTER=End
CETR Help: CICS Terminal and Transaction Trace (1) VTAM EXIT trace. CICS VTAM EXIT tracing consists of entries on GTF made by the CICS supplied VTAM exits that run asynchronously with the rest of CICS. The exits that are related directly to a particular terminal have their tracing activated by specifying the terminal id and/or netname and setting ON in the Terminal VTAM Exit Trace field. There are also non-terminal related exits for which tracing is enabled by specifying SYSTEM in the VTAM Exit override field. A setting of ALL in the exit override field will turn on exit tracing for all non-terminal exits, and for all terminal exits for all terminals. NOTES: (a) Setting trace for any terminal related exit will also turn on trace of all non-terminal related exits. (b) CICS GTF tracing need not be STARTED (main panel) to use this facility. (c) An unknown netname is assumed to be an autoinstall terminal. (d) Pressing PF6 cancels all tracing from all exits. (e) Connection name in the termid field causes setting of all sessions. PF 3=End 7=Back 8=Next ENTER=End
CETR Help: CICS Terminal and Transaction Trace (2) ZCP TRACE ZCP trace is the activate scan trace facility. Turning it on for a particular terminal means that the activate scan routine of the terminal control program (DFHZCP) will start to monitor the activate scan queue for the Terminal Control Table Terminal Entry (TCTTE) for that terminal. When the TCTTE is found, indicating that there is activity on the terminal, a trace entry is made for the activate scan ZCP routine. PF 3=End 7=Back 8=Next ENTER=End
CETR Help: CICS Terminal and Transaction Trace (3) FUNCTION KEY USE ON THE TERMINAL AND TRANSACTION PANEL. Key Name Function ENTER Change Execute any Changes. PF1 Help Display this help information. PF3 Quit Return to main Trace Control panel. PF6 Cancel Cancel all exit tracing. This turns off VTAM EXIT tracing for all terminals and for all the non-terminal EXITs. PF9 Messages Display any messages created. PF 3=End 7=Back ENTER=End
If you press the help key (PF1) while viewing any of the JVM trace options screens, the following panels are displayed:
CETR Help: JVM Trace Options FUNCTION OF THE JVM TRACE OPTIONS PANEL The JVM Trace Options panel is used to inquire and set the STANDARD and SPECIAL trace levels for tracing the JVM in the CICS system. It also allows setting of the JVM Trace Options used for each trace level. There are 4 trace levels defined, LEVEL 0, LEVEL 1, LEVEL 2 and USER. LEVEL 0, LEVEL 1 and LEVEL 2 are intended to correspond to trace levels 0, 1, and 2 for JVMs, and the USER level can be used to specify deeper levels of tracing or complex trace options. The default value for these options can be overridden by SIT parameters: JVMLEVEL0TRACE, JVMLEVEL1TRACE, JVMLEVEL2TRACE and JVMUSERTRACE. Further help information follows: 1. Data entry and alteration 2. Function key use on the JVM Trace Options panels. PF 3=End 8=Next ENTER=End
CETR Help: JVM Trace Options (1) DATA ENTRY AND ALTERATION The fields are spread over 2 screens, Level 0 and 1 on the first and Level 2 and User on the second screen. PF7 and PF8 are used to move between them. The page may only be switched when the displayed page contains no errors. For each level of tracing there are 2 ON / OFF fields to set tracing for STANDARD and SPECIAL transactions. There is a 240 character "free-form" field to set the JVM Trace Options to use. The meaning of these options is defined by documentation for the JVM. PF6 can be used to reset all the Trace Option fields to the CICS defined default values. Changes to the ON / OFF fields are validated when the current page is changed, but all values are only set within CICS when ENTER is pressed. Until this time it is possible to quit from the program (PF3) without altering internal values. PF 3=End 7=Back 8=Next ENTER=End
CETR Help: JVM Trace Options (2) FUNCTION KEY USE ON THE JVM TRACE OPTIONS PANELS. Key Name Function ENTER Change Execute any Changes. PF1 Help Display this help information. PF3 Quit Return to main Trace Control panel. PF6 Reset Set all Option strings back to default values. PF7 Backward Scroll backward one page. PF8 Forward Scroll forward one page. PF9 Messages Display any messages created, these can be warning (informative) messages, or errors. PF 3=End 7=Back ENTER=End