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 ctgws
| SMF Field | DB Column name | Description | Unit |
|---|---|---|---|
| ctghd_rty | Value is always CTG8 | ||
| 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_WS_CREQ | ctgws_creq | Number of inflight web service transactions. These transactions might or might not be active in CICS. However, they represent one mirror transaction, which might be in a suspended state | |
| CTG_WS_CWAITING | ctgws_cwaiting | Number of web services waiting for a worker thread to become available | |
| CTG_WS_IALLREQ | ctgws_iallreq | Number of web service requests that have been processed. Successful and failed requests are included | |
| CTG_WS_IAVRESP | ctgws_iavresp | The average time for web services to respond to requests from remote clients. Successful and failed requests are included. This value includes the CICS response time, as provided by the corresponding CS_LAVRESP statistic | millisecond |
| CTG_WS_IREQHI | ctgws_ireqhi | Peak number of concurrent web service transactions that have been in flight at the same time | |
| CTG_WS_IREQDATA | ctgws_ireqdata | The amount of application request data received from clients of all web services | byte |
| CTG_WS_IRESPDATA | ctgws_irespdata | The amount of application response data returned to clients of all web services. | byte |
| CTG_WS_LALLREQ | ctgws_lallreq | Number of web service requests that have been processed. Successful and failed requests are included | |
| CTG_WS_LAVRESP | ctgws_lavresp | The average time for web services to respond to requests from remote clients. Successful and failed requests are included. This value includes the CICS response time, as provided by the corresponding CS_LAVRESP statistic. | millisecond |
| CTG_WS_LREQHI | ctgws_lreqhi | Peak number of concurrent web service transactions that have been in flight at the same time | |
| CTG_WS_LREQDATA | ctgws_lreqdata | The amount of application request data received from clients of all web services. | byte |
| CTG_WS_LRESPDATA | ctgws_lrespdata | The amount of application response data returned to clients of all web services. | byte |
| CTG_WS_SCOUNT | ctgws_scount | Number of web services defined in the configuration file | |
| CTG_WS_SMAXHTTP | ctgws_smaxhttp | Maximum number of HTTP client threads |