For introductory information about CICS® monitoring, see the CICS Performance Guide.
The CICS-defined fields in performance class monitoring records are organized in groups. The BTS-related fields are in group DFHCBTS. All the CICS-defined fields, including those in the DFHCBTS group, are listed in the CICS Performance Guide. In the CICS Performance Guide, each of the data fields is presented as a field description, followed by an explanation of the contents. The field description has the format shown in Figure 65.
001 (TYPE-C, 'TRAN', 4 BYTES)
| | | |
| | | Length of the field (as re-
| | | presented by CMODLENG in the
| | | dictionary entry).
| | |
| | Informal name for the field, as used,
| | perhaps, in column headings when the
| | monitoring output is processed
| | (CMODHEAD of the dictionary entry).
| |
| Data type, which may be one of the following:
| A - a 32-bit count
| C - a byte string
| P - a packed decimal value
| S - a clock comprising a 32-bit accumulation
| of 16-microsecond units followed by an
| 8-bit flag followed by a 24-bit count
| (modulo-16 777 216) of the number of
| intervals included in the accumulation.
| T - a time stamp derived directly from the
| output of an STCK instruction.
| (CMODTYPE of the dictionary entry)
|
Field identifier by which the field may be individually
excluded or included during MCT preparation (CMODIDNT of
the dictionary entry).
For information about how to add your own fields to performance class monitoring records, and how to include or exclude specific CICS-defined groups of fields, see the CICS Customization Guide.
DFH$MOLS is a CICS-supplied sample utility program for printing monitoring data. You can select and sort the monitoring records to be printed by means of control statements. For definitive information about DFH$MOLS, see the CICS Operations and Utilities Guide. This section describes only the BTS-related options of the DFH$MOLS control statements. These allow you to specify that DFH$MOLS should include or exclude BTS-related monitoring records in the set of records to be printed.
You can specify each of the APPLID, PRCSTYPE, TERMID, TRANID, and USERID parameters in the same SELECT/IGNORE GROUP, but you cannot specify an IGNORE and SELECT for the same type of parameter. For example, you can specify SELECT TERMID= and IGNORE PRCSTYPE=, but you cannot specify SELECT PRCSTYPE= and IGNORE PRCSTYPE=.
The DFH$MOLS program pads, with trailing blanks, operands that have less characters than the permitted maximum. You cannot continue control statements on another line, but the program logically chains multiple control statements of the same keyword in the same IGNORE group. If you specify IGNORE for more than one parameter, those IGNORE statements form a logical OR function.
Examples:
If you specify:
IGNORE TRANID=CEMT
IGNORE USERID=OP7
the program excludes all records for transaction CEMT (regardless of user ID), and exclude all records containing userid OP7 (regardless of transaction ID). It includes all other records.
If you specify:
SELECT TRANID=CEMT
IGNORE TERMID=TRM3
the program includes only records for transaction CEMT, except for those from terminal TRM3.
You can specify each of the APPLID, PRCSTYPE, TERMID, TRANID, and USERID parameters in the same SELECT/IGNORE GROUP, but you cannot specify an IGNORE and SELECT for the same type of parameter. For example, you can specify SELECT TERMID= and IGNORE PRCSTYPE=, but you cannot specify SELECT PRCSTYPE= and IGNORE PRCSTYPE=.
You cannot continue control statements on another line, but the program logically chains multiple control statements of the same keyword in the same SELECT group. If you specify SELECT for more than one parameter, those SELECT statements form a logical AND function.
Examples:
If you specify:
SELECT TERMID=TRM3
SELECT TRANID=CEMT
the program includes only records with a transaction identifier of CEMT and with a terminal identifier of TRM3. It does not include any other records.
If you specify:
SELECT APPLID=DBDCCICS
SELECT TRANID=CEMT
IGNORE TERMID=TRM3
the program includes only those records that are from the CICS region with the generic APPLID DBDCCICS, and are for transaction CEMT, but do not have the terminal identifier TRM3.