Introduction
When you install CICS® Transaction Gateway, a C header file and a IBM® z/OS® assembler copy macro are provided to define the SMF record structure. The C header file is CTGSMF, located in the SCTGINCL data set and the IBM z/OS assembler copy macro is file CTGSMFA, located in the SCTGMAC data set.
Figure 1. SMF record format
- SMF header data structure
The format of the header for the SMF record for type 111 records is fixed and is common to SMF records from other CICS products. The Gateway daemon completes the following fields that are marked with "*". The SMF subsystem fills in the rest of the fields. User applications are not required to complete any SMF fields. - SMF product section data structure
The Gateway daemon fills in all the fields in the generic product section for the SMF record for type 111 records. Parts of the record are of fixed format and common to all SMF products. Some parts of this record are specific to CICS Transaction Gateway and have the prefix "CTG". - Statistics record header
The data section contains a number of statistics records. Each statistics record has a header. The header is common to all CICS Transaction Gateway statistics records. You can work out the type of data that follows the record from the CTG_RECORDID and CTG_RECVER fields. - Connection Manager (CM) statistics SMF data
CICS Transaction Gateway CM statistics use this format for writing SMF records. - CICS Server all (CS) statistics SMF data
CICS Transaction Gateway CS statistics use this format for writing SMF records. - CICS Server Instance (CSx) SMF statistics for EXCI
CICS Transaction Gateway statistics records normally have only one instance. The exceptions are CSx and WSx statistics. - CICS Server Instance (CSx) SMF statistics for IPIC
CICS Transaction Gateway statistics records normally have only one instance. The exceptions are CSx and WSx statistics. - Gateway daemon (GD) statistics SMF data
CICS Transaction Gateway daemon statistics use this format for writing SMF records. - Protocol handler (PH) statistics SMF data
CICS Transaction Gateway PH statistics have this format. - System environment (SE) statistics SMF data
CICS Transaction Gateway SE statistics have this format. - Worker thread (WT) statistics SMF data
CICS Transaction Gateway WT statistics have this format. - Web service all (WS) statistics SMF data
CICS Transaction Gateway WS statistics use this format for writing SMF records. - Web service instance (WSx) SMF statistics
CICS Transaction Gateway statistics records normally have only one instance. The exceptions are CSx and WSx statistics. - SMF date format - byte packed date format
Definition of the format used to represent dates in SMF. - SMF data format - sample values
Sample values for CTG_COLTIME and CTG_LOCOFFSET.
Fields
Stored in ctgcx
| SMF Field | DB Column name | Description | Unit |
|---|---|---|---|
| ctghd_rty | Value is always CTG2 | ||
| SMF11_SID | ctghd_sid | SID | |
| SMF111_SDTE | ctghd_dttm | Date-Time the record was written | |
| SMF111_VRM | ctghd_vrm | Record version | |
| SMF111_PRN | ctghd_prn | Generic Product Name | |
| SMF111_SPN | ctghd_spn | Gateway daemon identifier | |
| CTG_STATTYPE | ctghd_statype | Statistics type. This event drives the statistic to be recorded | |
| CTG_COLDATE CTG_COLTIME |
ctghd_coldttm | Collection date and time | |
| CTG_LOCOFFSET | ctghd_locoffset | Offset from GMT to local time | second |
| CTG_LSTRESET | ctghd_lstreset | Last reset time or initialization time | second |
| CTG_INTERVAL | ctghd_interval | Length of time remaining before the next interval. | second |
| CTG_INTVCOUNT | ctghd_intvcount | A sequence number that increments each time an interval is requested | |
| CTG_STARTDATE CTG_STARTTIME |
ctghd_startdttm | Gateway start date and time | |
| CTG_CSX_EXCI_EXCISERVER | ctgcx_exci_exciserver | Name of CICS server | |
| CTG_CSX_EXCI_CALLOC | ctgcx_exci_calloc | Number of EXCI pipes allocated | |
| CTG_CSX_EXCI_LALLOCFAIL | ctgcx_exci_lallocfail | Number of EXCI pipe allocate failures | |
| CTG_CSX_EXCI_LALLREQ | ctgcx_exci_lallreq | Number of requests processed | |
| CTG_CSX_EXCI_IALLOCFAIL | ctgcx_exci_iallocfail | Number of EXCI pipe allocate failures | |
| CTG_CSX_EXCI_IALLREQ | ctgcx_exci_iallreq | Number of requests processed | |
| CTG_CSX_EXCI_IAVRESP | ctgcx_exci_iavresp | Average CICS response time | millisecond |
| CTG_CSX_EXCI_LAVRESP | ctgcx_exci_lavresp | Average CICS response time | millisecond |
| CTG_CSX_EXCI_LCOMMSFAIL | ctgcx_exci_lcommsfail | Number of CICS communication failures | |
| CTG_CSX_EXCI_IREQDATA | ctgcx_exci_ireqdata | Amount of CICS request data | |
| CTG_CSX_EXCI_LREQDATA | ctgcx_exci_lreqdata | Amount of CICS request data | |
| CTG_CSX_EXCI_IRESPDATA | ctgcx_exci_irespdata | Amount of CICS response data | |
| CTG_CSX_EXCI_LRESPDATA | ctgcx_exci_lrespdata | Amount of CICS response data | |
| CTG_CSX_EXCI_SPROTOCOL | ctgcx_exci_sprotocol | CICS server protocol | |
| CTG_CSX_EXCI_ICOMMSFAIL | ctgcx_exci_icommsfail | Number of CICS communication failures | |
| CTG_CSX_EXCI_CWAITING | ctgcx_exci_cwaiting | Number of requests waiting on a response |