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 ctgcm
| SMF Field | DB Column name | Description | Unit |
|---|---|---|---|
| ctghd_rty | Value is always CTG0 | ||
| 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_CM_CALLOC | ctgcm_calloc | Currently allocated connection managers | |
| CTG_CM_CCURR | ctgcm_ccurr | Number of connection managers | |
| CTG_CM_CWAITING | ctgcm_cwaiting | Number of connection managers waiting | |
| CTG_CM_LTIMEOUT | ctgcm_ltimeouts | Number of times connect timeout reached | |
| CTG_CM_SINIT | ctgcm_sinit | Initial number of connection managers | |
| CTG_CM_SMAX | ctgcm_smax | Maximum number of connection managers | |
| CTG_CM_ITIMEOUTS | ctgcm_itimeouts | Number of times connect timeout reached | |
| CTG_CM_IALLOCHI | ctgcm_iallochi | Peak number of allocated connection manager threads | |
| CTG_CM_ICREATED | ctgcm_icreated | Number of connection manager threads created | |
| CTG_CM_IALLOC | ctgcm_ialloc | Number of times a connection manager thread was allocated | |
| CTG_CM_LALLOC | ctgcm_lalloc | Number of allocations for connection manager threads representing the number of connections that have been established from remote clients |