BTS monitoring data

For introductory information about CICS® monitoring, see the CICS Performance Guide.

Performance class data

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.

Figure 65. Format of the descriptions of the data fields
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.

Using the monitoring data print program, DFH$MOLS

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.

DFH$MOLS control statements that include BTS options

IGNORE[APPLID|PRCSTYPE|TERMID|TRANID|USERID]
specifies that all records from a CICS region that has the specified generic APPLID, or all records associated with a specified process-type, terminal, transaction, or user identifier, are to be excluded.
APPLID=xxxxxxxx[,yyyyyyyy,.,.]
Specify one or more generic APPLIDs to exclude monitoring data from a CICS region, or regions.
PRCSTYPE=xxxxxxxx[,yyyyyyyy,.,.]
Specify one or more 8-character process-type identifiers to exclude monitoring data associated with these BTS process-types.
TERMID=xxxx[,yyyy,.,.]
Specify one or more terminal identifiers to exclude monitoring data associated with these terminals.
TRANID=xxxx[,yyyy,.,.]
Specify one or more transaction identifiers to exclude monitoring data for these transactions.
USERID=xxxxxxxx[,yyyyyyyy,.,.]
Specify one or more user identifiers to exclude monitoring data for transactions submitted by these users.

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.

SELECT [APPLID|PRCSTYPE|TERMID|TRANID|USERID]
specifies that all records from a CICS region that has the specified generic APPLID, or all records associated with a specified process-type, terminal, transaction, or user identifier, are to be included.
APPLID=xxxxxxxx[,yyyyyyyy,.,.]
Specify one or more generic APPLIDs to include monitoring data from the CICS regions identified by these APPLIDs.
PRCSTYPE=xxxxxxxx[,yyyyyyyy,.,.]
Specify one or more 8-character process-type identifiers to include monitoring data associated with these BTS process-types.
TERMID=xxxx[,yyyy,.,.]
Specify one or more terminal identifiers to include monitoring data associated with these terminals.
TRANID=xxxx[,yyyy,.,.]
Specify one or more transaction identifiers to include monitoring data for these transactions.
USERID=xxxxxxxx[,yyyyyyyy,.,.]
Specify one or more user identifiers to include monitoring data for transactions submitted by these users.

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.

Related concepts
Tuning BTS performance
Monitoring in BTS
[[ Contents Previous Page | Next Page Index ]]