SMF 111-8 Webservice all Statistics

Updated on 18 Mar 2024
4 Minutes to read
Contributors

Print
Share
Dark
Light

Article summary

Did you find this summary helpful?

Thank you for your feedback

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

What's Next

SMF 111-9 Webservice Instance Statistics

Table of contents

Introduction
Fields