Interpreting CICS monitoring

Product-sensitive programming interface

All of the exception class data and all of the system-defined performance class data that can be produced by CICS® monitoring is listed below. 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 4, which is taken from the performance data group DFHTASK.

Figure 4. Format of the descriptions of the data fields
001 (TYPE-C, 'TRAN', 4 BYTES)
 
001 - Field identifier by which the field may be
individually excluded or included during MCT
preparation (CMODIDNT of the dictionary entry).

TYPE-C - Data type, which may be one of the following:
  A - a 32-bit count, a 64-bit count, a string of 64-bit counts
  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)

'TRAN' - Informal name for the field, as used,
perhaps, in column headings when the monitoring output
is postprocessed (CMODHEAD of the dictionary entry).

4 BYTES - Length of the field (as represented by CMODLENG
in the dictionary entry).
Note:
References in Figure 4 to the associated dictionary entries apply only to the performance class data descriptions. Exception class data is not defined in the dictionary record.

This section covers:

End of Product-sensitive programming interface

Clocks and time stamps

Product-sensitive programming interface

In the descriptions that follow, the term clock is distinguished from the term time stamp.

A clock is a 32-bit value, expressed in units of 16 microseconds, accumulated during one or more measurement periods. The 32-bit value is followed by 8 reserved bits, which are in turn followed by a 24-bit value indicating the number of such periods.

Neither the 32-bit timer component of a clock nor its 24-bit period count are protected against wraparound. The timer capacity is about 18 hours, and the period count runs modulo 16 777 216.

The 8 reserved bits have the following significance:

Bits 0, 1, 2 and 3
Used for online control of the clock when it is running, and should always be zeros on output.
Bits 4 and 7
Not used.
Bits 5 and 6
Used to indicate, when set to 1, that the clock has suffered at least one out-of-phase start (bit 5) or stop (bit 6).

A time stamp is an 8-byte copy of the output of an STCK instruction.

Note:
All times produced in the offline reports are in GMT (Greenwich Mean Time) not local time. Times produced by online reporting can be expressed in either GMT or local time.
End of Product-sensitive programming interface

Related tasks
Controlling CICS monitoring
Processing CICS monitoring facility output

Related concepts
The CICS monitoring facility
The classes of monitoring data: Overview
Event monitoring points
The monitoring control table (MCT)

Related reference
Notes on the performance data
Performance class data
Exception class data
Transaction resource class data
[[ Contents Previous Page | Next Page Index ]]