Convert CMRDETL records into CICS 110 SMF format
BMC AMI OpsM for CICS provides support to create the SMF 110 Performance records for the following versions of CICS Transaction Server:
- CICS Transaction Server Version 6.2
- CICS Transaction Server Version 6.1
- CICS Transaction Server Version 5.6
- CICS Transaction Server Version 5.5
- CICS Transaction Server Version 5.4
Conversion is performed by the CMRCMPWN utility program. CMRCMPWN enables you to control the output format by using one of several input parameters. CMRCMPWN supports the following input parameters:
- FORMAT=6.2 or 6.2Y
- FORMAT=6.1 or 6.1Y
- FORMAT=5.6 or 5.6Y
- FORMAT=5.5 or 5.5Y
- FORMAT=5.4 or 5.4Y
The requested output format is constructed regardless of the CICS release that is used for input. For example, if the T6E input is from CICS/TS 5.5 and you specify FORMAT=5.6, CICS TS 5.6 SMF format data records are built. In this case, however, all new CICS TS 5.6 data fields that are unavailable in CICS TS 5.5 are initialized to binary zeros or blanks as appropriate.
The Y in the second format sets the date format to YYYYDDDF. The default format is CCYYDDDF.
The converted data contains SMF formatted records: the SMF header followed by the SMF product section followed by the blocked data records. The transaction data records are blocked to fit below 32K with each blocked area preceded by the dictionary field connectors. The SMF header and SMF product section do not have the OPSYS, MCT Options, or Entry Time information.
The first record written is the CICS dictionary record, which is almost equivalent to the complete dictionary for the CICS specified on the FORMAT= statement. The difference is in the DBCTL section; instead of 256 bytes of DBCTL data area, the CMRCMPWN SMF dictionary has 14 USER fields with DBCTL data. The dictionary record is followed by the SMF transaction data record. The data section is structured as follows:
Area | Format |
|---|---|
CICS data area | DFHMNTDS |
DFHRMI area | DFHMNCBD |
TCP/IP area | Based on TCP/IP MCT |
USER 1-4 | T6EUCLKx |
USER 1-10 | T6EUCNTx |
BMCMCT | See the T6EBMCMCT field in CMRQT6E |
CMR data area | CMRNDATA |
CMR DB2 area | CMRNDB2 |
The BMCMCT area identifies task indicators that indicate the status of various agents and interfaces at the time the history record was built. The description of each of the indicators is available in the CMRQT6E record format description of the BMCMCT data field.
The CMRNDATA and CMRNDB2 areas are defined in the SMF record as if the your site had specified an MCT, including the BMC AMI OpsM for CICS MCT definitions in the BBSAMP members CMRNDMCT and CMRN2MCT, respectively.
Starting at offset 8, the DFHMNTDS dsect describes the CICS data area. The DFHRMI area is described by the DFHMNCBD dsect. The BMC AMI OpsM for CICS user counts and clocks areas consist of four 12-byte clocks followed by 10 four-byte counts. These areas contain some DBCTL information that BMC AMI OpsM for CICS calculates. The dictionary entries for these fields are identified by USER fields 001-004 for the clocks and USER fields 001-010 for the counts. There is no macro or copy book available for the format of the USER fields.
The clock fields are based on the the IMS DFSDSTA control block and the following list shows their definitions:
(DBC$SCHT/16)
USER 002 delta between PSB schedule start and stop (
DBC$DATN-DBC$DATS)
USER 003 not used
USER 004 elapsed time for database I/O (DBC$TMIO/16)
The count fields are as follows:
USER 002 database GN calls (DBC$GH)
USER 003 database GNP calls (DBC$GNP)
USER 004 database GHU calls (DBC$GHU)
USER 005 database GHN calls (DBC$GHN)
USER 006 database GHNP calls (DBC$GHNP)
USER 007 database ISRT calls (DBC$ISRT)
USER 008 database DLET calls (DBC$DLET)
USER 009 database REPL calls (DBC$REPL)
USER 010 total database calls (DBC$TOTC)
The CMRNDATA assembler dsect (or the CMRNDSAS SAS field identifications) formats the BMC AMI OpsM for CICS data area. The CMRDATA name identifies the dictionary entry.
The CMRNDB2 assembler dsect (or the CMRN2SAS SAS field identifications) formats the BMC AMI OpsM for CICS DB2 data area. The CMRDB2 name identifies the dictionary entry.
The TCP/IP data area is based on the data provided in the MCT as defined by the TCP/IP Supplied MCT information. BMC AMI OpsM for CICS supplies all of the available TCP/IP information, but what is built in the SMF record is based on the TCP/IP information provided by the user in the MCT used by the CICS target.
This section contains the following topics: