Go to Home Page
Questions?
Call 1-800-572-5517
 
  Go to Home Page  
  See all products
  See price schedules
  See manuals, tutorials, articles
  Download a free 30-day trial
  See user testimonials
  About Pacific Systems Group
 
 
SMF Tools
  See SMF Record Layouts
  See Sample SMF Reports
  Learn How to Export SMF Data
  Download Free SMF Reporting Software (30 days)
 
One of the greatest SMF record parsing programming languages I've ever seen. Chief, Large Systems Services Branch, NIH
  Choose Spectrum Writer to add 4GL to your product
  Free 60-Page Book (PDF) - How to Make an SMF Report
Spectrum DCOLLECT Reporter - the 4GL DCOLLECT Report Writer.

Spectrum SMF Writer - the 4GL SMF Report Writer.

SMF Type 111 Record

This table shows the record layout for type 111 SMF records
(CICS Transaction Gateway - V7.1).

List of other SMF record layouts available.
List of sample SMF reports.

Purpose: SMF 111 records contain statistics for the CICS Transaction Gateway.

End of day and shutdown statistics

End of day and shutdown statistics will always be attempted to be written to SMF regardless of whether the stats recording parameter is set to on or off. A message will be logged if this attempt fails.

Interval correlation number

Interval Statistics are captured at predefined intervals by issuing requests for them to be recorded at the correct time.

The interval statistics component, will periodically request the SMF recording facility, to record statistics information. The interval statistics component will take a snapshot of all current statistics and send them to the SMF recorder. The SMF recorder will format the statistics into the documented SMF record format. This data will then be output to the SMF facility. Every time the interval statistics component issues a request to record statistics, a unique number will be generated. This number is known as the interval correlation number and is unique, for a specific CICS TG instance, over the lifetime of that CICS TG.

The interval correlation number is included as an external field in every SMF record header.

The SMF subsystem allows a maximum of 30KB per record. If the formatted data for a statistics request exceeds 30KB, the data is split across multiple SMF records. Each SMF record is given the same interval correlation number. This correlation allows the records relevant to an individual statistics interval to be linked together

Correlating multiple SMF records within the same interval

The timestamp and datestamp fields, SMF111_COLTIME and SMF111_COLDATE are used to correlate records for a specific CICS TG APPLID. A CICS TG instance can not have intervals of less than 1 minute, so these fields can be used to identify the record. This correlation is valid if the CICS TG is stopped and restarted, where as the interval count gets reset at a stop and restart.

It is anticipated that there will not be a need for multiple records unless there are a large number of servers, as the CICS TG will write data of a size of greater than 30KB.

It's easy to report on SMF 111 data!

SMF Spectrum Writer
We have a low-cost 4GL report writer especially for SMF files. It's called Spectrum SMF Writer.

Spectrum SMF Writer handles the difficult SMF record parsing for you automatically. You just specify which fields you want to see.

Spectrum SMF Writer also converts the arcane date and time fields and reformats them into an attractive report.

Plus, Spectrum SMF Writer can export SMF data as comma delimited files to use on your PC.
 
Try It FREE Now!

SMF Type 111 Record -- CICS Transaction Gateway - V7.1
Offset
(Dec.)
Offset
(Hex)
NameLengthFormatDescription
00SMF111LEN2binary
Record length.
22SMF111SEG2binary
Segment descriptor.
44SMF111FLG1binary
Operating system indicator. The Gateway daemon sets this value to X'C0' to indicate that the CICS TG record supports triplets.
55SMF111RTY1binary
Record type 111 (X'6F')
66SMF111TME4packed
Time since midnight, in hundredths of a second, when the record was moved into the SMF buffer.
10ASMF111DTE4packed
Date that the record was moved into the SMF buffer, in the form 0cyydddF.
14ESMF111SID4EBCDIC
System identification (from the SID parameter).
18SMF111_
SSI
4EBCDIC
Subsystem identification (C'CTGZ')
22SMF111_
STY
2binary
Record subtype. CICS TG only uses one subtype. This value will always be zero.
24SMF111_
TRN
2Binary
Number of triplets 2
26--2
28SMF111_
APS
4binary
Offset to product section
32SMF111_
LPS
2binary
Length of product section.
34SMF111_
NPS
2binary
Number of product sections. Always 1.
36SMF111_
ASS
4binary
Offset to DATA section
40SMF111_
ASL
2binary
Length of DATA section. (The total length of all the CICS TG records included in the data section.)
42SMF111_
ASN
2binary
Number of DATA sections. Always 1.
Product Section

This section describes the generic product section for the SMF record for type 111 records.

The Gateway daemon fills in all the fields in this section. Parts of the record are of fixed format and common to all SMF products. Some parts of this record are specific to CICS TG.

(Offset from beginning of record: SMF111_APS)
0SMF111_
RVN
2binary
Record version (X'0VRM') Each letter represents a numeric digit from values 0 to 9
V = Version
R = Release
M = Maintenance
Version 7.1.0 of CICS TG would be represented as X'0710'
2SMF111_
PRN
8EBCDIC
Generic product name (C'CICSTGGW')
10SMF111_
SPN
8EBCDIC
Gateway daemon identifier. CICS TG APPLID will be used. If the APPLID is not set the Jobname will be used.
18SMF111_
MFL
2binary
Record maintenance indicator 0
20--2
22SMF111_
STATTYPE
1binary
Statistics type - This is the event that drives the statistic to be recorded.
X'00' for interval
X'01' for end of day
X'02' for shutdown
23--1
24SMF111_
COLDATE
4packed
Collection date (OCYYDDD+) Local time. Set to the time the Gateway daemon requests that records for a statistics interval are cut. This represents the time that the interval is initially requested. Time to process the interval data and perform the I/O is not included. The value corresponds to the statint and stateod values in the CICS TG .ini file. The date that the record is written is filled in by SMF in SMF111_SMFSTDTE.
28SMF111_
COLTIME
4packed
Collection time (OOHHMMSS) Local time. The last byte is used, it is not reserved or set to +. Set to the time the Gateway daemon requests that records for a statistics interval are cut. This represents the time that the interval is initially requested. Time to process the interval data and perform the I/O is not included. The value corresponds to the statint and stateod values in the CICS TG .ini file. The time that the record is written is filled in by SMF in SMF111_SMFTME. 32 NN MF111_LOCOFFSET 4 Signed binary Offset from GMT to local time is seconds. Signed integer Number to add to the system local time to derive GMT
36SMF111_
LSTRESET
4binary
The period of time (in seconds) since the last reset. If the first time stats have been issued in the lifetime of the CICS TG this represents time since initialization. The reset is performed each time that interval statistics are cut.
40SMF111_
INTERVAL
4binary
Interval seconds. (Length of time remaining before the next interval.)
44SMF111_
INTVCOUNT
4binary
Interval number. (A sequence number that increments each time an interval is requested. The scope of this is within a specific CICS TG gateway daemon instance, for the lifetime of that gateway daemon. The first interval is defined as 1.)
CICS TG Statistics record header

This section describes the CICS TG 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 TG statistics records. It is possible to work out the type of data that follows the record from the SMF111_RECID and SMF111_RECVER fields.

There is one instance of each CICS TG statistics record except for CSX statistics for EXCI and IPIC where there are multiple instances of the records within one SMF record. This is because there is one CSX statistics record for each server, uniquely identified by the netname of the server. The netname (SMF111_CSX_SAPPLID) is unique for each CSX statistics record.

(Offset from beginning of record: SMF111_ASS)
0SMF111_
DATALEN
2binary
Length of record Length of this header record + the length of the data that follows
2SMF111_
RECID
2binary
Record ID resource group Each CICS TG stats resource group will have a numeric ID allocated to it.
X'00' CM
X'01' CS
X'02' CSx for EXCI
X'03' GD
X'04' PH
X'05' WT.
4SMF111_
RECVER
1binary
Data section version (A combination of SMF111_RECID and SMF111_RECVER controls the version of the struct. As structs are fixed length, we need to change SMF111_RECVER every time a stat is added to a resource group (in between releases).)
5SMF111_
ALIGN1
3
Connection Manager (CM) statistics SMF data

This section describes the CICS TG CM statistics format for writing SMF records.

(Offset from beginning of record: SMF111_CM_OFF)
0SMF111_
CM_
CALLOC
4binary
Currently allocated connection managers
4SMF111_
CM_
CCURR
4binary
Current number of connection managers
8SMF111_
CM_
CWAITING
4binary
Number of connection managers waiting
12SMF111_
CM_
LTIMEOUTS
4binary
Number of times connect time out reached
16SMF111_
CM_
SINIT
4binary
Initial number of connection managers
20SMF111_
CM_
SMAX
4Signed binary
Maximum number of connection managers
24SMF111_
CM_
ITIMEOUTS
4binary
Number of times connect time out reached
28SMF111_
CM_
IALLOCHI
4binary
Peak number of allocated connection manager threads
32SMF111_
CM_
ICREATED
4binary
Number of connection manager threads created
36SMF111_
CM_
IALLOC
4binary
Number of times a connection manager thread was allocated
CICS Server all (CS) statistics SMF data

This section describes the CICS TG CS statistics format for writing SMF records.

(Offset from beginning of record: SMF111_CS_OFF)
0SMF111_
CS_
CALLOC
4binary
Number of EXCI pipes allocated
4SMF111_
CS_
LALLOCFAIL
4binary
Number of EXCI pipe allocate failures
8SMF111_
CS_
LALLREQ
4binary
Number of requests processed
12SMF111_
CS_
LCOMMSFAIL
4binary
Number of CICS communication failures
16SMF111_
CS_
LCOUNT
4binary
Number of CICS servers
20SMF111_
CS_
LREALLOC
4binary
Number of EXCI pipe reallocations
24SMF111_
CS_
SLOGONLIM
4binary
EXCI pipe limit
28SMF111_
CS_
SNETNAME
8EBCDIC
EXCI NETNAME
36SMF111_
CS_
IALLOCFAIL
4binary
Number of EXCI pipe allocate failures
40SMF111_
CS_
IALLREQ
4binary
Number of requests processed
44SMF111_
CS_
ICOMMSFAIL
4binary
Number of CICS communication failures
48SMF111_
CS_
ICOUNT
4binary
Number of CICS servers
52SMF111_
CS_
IREALLOC
4binary
Number of EXCI pipe reallocations
56SMF111_
CS_
IREQDATA
8binary
Amount of CICS request data
64SMF111_
CS_
LREQDATA
8binary
Amount of CICS request data
72SMF111_
CS_
IRESPDATA
8binary
Amount of CICS response data
80SMF111_
CS_
LRESPDATA
8binary
Amount of CICS response data
88SMF111_
CS_
SCOUNT
4binary
Number of defined CICS servers
92SMF111_
CS_
ICONNFAIL
4binary
Number of connect failures
96SMF111_
CS_
LCONNFAIL
4binary
Number of connect failures
100SMF111_
CS_
ILOSTCON
4binary
Number of lost connections
104SMF111_
CS_
LLOSTCON
4binary
Number of lost connections
108SMF111_
CS_
LIDLETIMEOUT
4binary
Number of timed out connections
112SMF111_
CS_
CSESSCURR
4binary
Number of IPIC sessions in use
116SMF111_
CS_
CSESSMAX
4binary
Number of negotiated IPIC sessions
120SMF111_
CS_
LSESSFAIL
4binary
Number of IPIC session failures
124SMF111_
CS_
ISESSFAIL
4binary
Number of IPIC session failures
128SMF111_
CS_
CWAITING
4binary
Number of requests waiting on a response
132SMF111_
CS_
IIDLETIMEOUT
4binary
Number of timed out connections
136SMF111_
CS_
IAVRESP
4binary
Average CICS response time
140SMF111_
CS_
LAVRESP
4binary
Average CICS response time
CICS Server Instance (CSx) SMF statistics for EXCI

This section describes the CICS® TG CSx statistics format for EXCI.

There is one instance of each CICS TG statistics record, except for CSx statistics for EXCI and IPIC, where there are multiple instances of the records within one SMF record. This is because there is one CSx statistics record for each server, uniquely identified by the netname of the server. The netname (SMF111_CSx_SAPPLID) is unique for each CSx statistics record.

One record is written in an SMF interval, when the data collected is less than 30 Kbytes. If the data exceeds 30 Kbytes, multiple records are written. Correlation of multiple SMF records is achieved using the COLTIME field, in the product section data structure, as this is unique for each interval.

(Offset from beginning of record: SMF111_CSX_OFF)
0SMF111_
CSX_
EXCI_
SAPPLID
8EBCDIC
CICS server name
8SMF111_
CSX_
EXCI_
CALLOC
4binary
Number of EXCI pipes allocated
12SMF111_
CSX_
EXCI_
LALLOCFAIL
4binary
Number of EXCI pipe allocate failures
16SMF111_
CSX_
EXCI_
LALLREQ
4binary
Number of requests processed
20SMF111_
CSX_
EXCI_
IALLOCFAIL
4binary
Number of EXCI pipe allocate failures
24SMF111_
CSX_
EXCI_
IALLREQ
4binary
Number of requests processed
28SMF111_
CSX_
EXCI_
IAVRESP
4binary
Average CICS response time
32SMF111_
CSX_
EXCI_
LAVRESP
4binary
Average CICS response time
36SMF111_
CSX_
EXCI_
LCOMMSFAIL
4binary
Number of CICS communication failures
40SMF111_
CSX_
EXCI_
IREQDATA
8binary
Amount of CICS request data
48SMF111_
CSX_
EXCI_
LREQDATA
8binary
Amount of CICS request data
56SMF111_
CSX_
EXCI_
IRESPDATA
8binary
Amount of CICS response data
64SMF111_
CSX_
EXCI_
LRESPDATA
8binary
Amount of CICS response data
72SMF111_
CSX_
EXCI_
SPROTOCOL
8EBCDIC
CICS server protocol
80SMF111_
CSX_
EXCI_
ICOMMSFAIL
4binary
Number of CICS communication failures
84SMF111_
CSX_
EXCI_
CWAITING
4binary
Number of requests waiting on a response
CICS Server Instance (CSx) SMF statistics for IPIC

This section describes the CICS® TG CSx statistics format for IPIC.

There is one instance of each CICS TG statistics record, except for CSx statistics for EXCI and IPIC, where there are multiple instances of the records within one SMF record. This is because there is one CSx statistics record for each server, uniquely identified by the netname of the server. The server name that is configured in the configuration file (SMF111_CSx_SININAME) is unique for each CSx statistics record.

One record is written in an SMF interval, when the data collected is less than 30 Kbytes. If the data exceeds 30 Kbytes, multiple records are written. Correlation of multiple SMF records is achieved using the COLTIME field, in the product section data structure, as this is unique for each interval.

(Offset from beginning of record: SMF111_CSX_OFF)
0SMF111_
CSX_
IPIC_
SININAME
8EBCDIC
CICS server name
8SMF111_
CSX_
IPIC_
IREQDATA
8binary
Amount of CICS request data
16SMF111_
CSX_
IPIC_
LREQDATA
8binary
Amount of CICS request data
24SMF111_
CSX_
IPIC_
IRESPDATA
8binary
Amount of CICS response data
32SMF111_
CSX_
IPIC_
LRESPDATA
8binary
Amount of CICS response data
40SMF111_
CSX_
IPIC_
IALLREQ
4binary
Number of requests processed
44SMF111_
CSX_
IPIC_
LALLREQ
4binary
Number of requests processed
48SMF111_
CSX_
IPIC_
ICONNFAIL
4binary
Number of connection failures
52SMF111_
CSX_
IPIC_
LCONNFAIL
4binary
Number of lost connections
56SMF111_
CSX_
IPIC_
ILOSTCONN
4binary
Number of lost connections
60SMF111_
CSX_
IPIC_
LLOSTCONN
4binary
Number of lost connections
64SMF111_
CSX_
IPIC_
IIDLETIMEOUT
4binary
Number of timed out connections
68SMF111_
CSX_
IPIC_
LIDLETIMEOUT
4binary
Number of timed out connections
72SMF111_
CSX_
IPIC_
SIPADDR
104EBCDIC
CICS server TCP/IP address
176SMF111_
CSX_
IPIC_
SIPPORT
4binary
CICS server TCP/IP port
180SMF111_
CSX_
IPIC_
CSESSCURR
4binary
Number of IPIC sessions in use
184SMF111_
CSX_
IPIC_
CSESSMAX
4binary
Number of negotiated IPIC sessions
188SMF111_
CSX_
IPIC_
SSESSMAX
4binary
Number of requested IPIC sessions
192SMF111_
CSX_
IPIC_
LSESSFAIL
4binary
Number of IPIC session failures
196SMF111_
CSX_
IPIC_
ISESSFAIL
4binary
Number of IPIC session failures
200SMF111_
CSX_
IPIC_
SPROTOCOL
8EBCDIC
CICS server protocol
208SMF111_
CSX_
IPIC_
LCOMMSFAIL
4binary
Number of CICS communication failures
212SMF111_
CSX_
IPIC_
ICOMMSFAIL
4binary
Number of CICS communication failures
216SMF111_
CSX_
IPIC_
CWAITING
4binary
Number of requests waiting on a response
220SMF111_
CSX_
IPIC_
IAVRESP
4binary
Average CICS response time
224SMF111_
CSX_
IPIC_
LAVRESP
4binary
Average CICS response time
228--4
Gateway daemon (GD) statistics SMF data

This section describes the CICS TG Gateway daemon statistics format for writing SMF records.

(Offset from beginning of record: SMF111_GD_OFF)
0SMF111_
GD_
CHEALTH
4binary
Gateway daemon health
4SMF111_
GD_
CSTATUS
16EBCDIC
Gateway daemon status
20SMF111_
GD_
LALLREQ
4binary
Number of requests processed
24SMF111_
GD_
LLUWTXNC
4binary
Extended LUW transactions committed
28SMF111_
GD_
LLUWTXNR
4binary
Extended LUW transactions rolled back
32SMF111_
GD_
LRUNTIME
8binary
Gateway daemon running time
40SMF111_
GD_
LSYNCTXN
4binary
Successful SYNCONRETURN transactions
44SMF111_
GD_
LXATXNC
4binary
XA commit requests successfully processed
48SMF111_
GD_
LXATXNR
4binary
XA rollback requests successfully processed
52SMF111_
GD_
SNAME
8EBCDIC
Gateway daemon name
60SMF111_
GD_
IALLREQ
4binary
Number of requests processed
64SMF111_
GD_
IRUNTIME
4binary
Interval running time
68SMF111_
GD_
ISYNCTXN
4binary
Successful SYNCONRETURN transactions
72SMF111_
GD_
IXATXNC
4binary
XA commit requests successfully processed
76SMF111_
GD_
IXATXNR
4binary
XA rollback requests successfully processed
80SMF111_
GD_
ILUWTXNC
4binary
Extended LUW transactions committed
84SMF111_
GD_
ILUWTXNR
4binary
Extended LUW transactions rolled back
88SMF111_
GD_
IAVRESP
4binary
Average Gateway daemon response time
92SMF111_
GD_
LAVRESP
4binary
Average Gateway daemon response time
96SMF111_
GD_
IREQDATA
8binary
Amount of Java client request data
104SMF111_
GD_
LREQDATA
8binary
Amount of Java client request data
112SMF111_
GD_
IRESPDATA
8binary
Amount of Java client response data
120SMF111_
GD_
LRESPDATA
8binary
Amount of Java client response data
128SMF111_
GD_
CSYNCTXN
4binary
Number of SYNCONRETURN transactions
132SMF111_
GD_
CLUWTXN
4binary
Number of Extended LUW transactions
136SMF111_
GD_
CXATXN
4binary
Number of XA transactions
140SMF111_
GD_
LXAREQ
4binary
Number of XA requests
144SMF111_
GD_
IXAREQ
4binary
Number of XA requests
148SMF111_
GD_
SAPPLID
8EBCDIC
CICS TG APPLID
156SMF111_
GD_
SAPPLIDQ
8EBCDIC
CICS TG APPLID qualifier
164SMF111_
GD_
SSTATINT
6EBCDIC
Length of the statistics interval HHMMSS
170SMF111_
GD_
SSTATEOD
6EBCDIC
Logical End Of Day time HHMMSS
176SMF111_
GD_
CNEXTRESET
6EBCDIC
End of interval time HHMMSS
182--2
Protocol handler (PH) statistics SMF data

This section describes the CICS TG PH statistics format.

(Offset from beginning of record: SMF111_PH_OFF)
0SMF111_
PH_
SPORTSSL
4Signed binary
SSL protocol handler port number
4SMF111_
PH_
SPORTTCP
4Signed binary
TCP protocol handler port number
System environment (SE) statistics SMF data

This section describes the CICS TG SE statistics format.

(Offset from beginning of record: SMF111_SE_OFF)
0SMF111_
SE_
SELIM
4binary
Amount of available memory ELIM
4SMF111_
SE_
CELOAL
4binary
Amount of used memory ELOAL
8SMF111_
SE_
CHEAPGCMIN
8binary
JVM heap size after GC
16SMF111_
SE_
SHEAPINIT
8binary
JVM initial heap size
24SMF111_
SE_
SHEAPMAX
8binary
JVM maximum heap size
32SMF111_
SE_
IGCTIME
8binary
JVM GC time
40SMF111_
SE_
LGCTIME
8binary
JVM GC time
48SMF111_
SE_
IGCCOUNT
8binary
JVM GC count
56SMF111_
SE_
LGCCOUNT
8binary
JVM GC count
Worker thread (WT) statistics SMF data

This section describes the CICS TG WT statistics format.

(Offset from beginning of record: SMF111_WT_OFF)
0SMF111_
WT_
CALLOC
4BINARY
Currently allocated worker threads
4SMF111_
WT_
CCURR
4binary
Current number of worker threads
8SMF111_
WT_
LTIMEOUTS
4binary
Number of times worker time out reached
12SMF111_
WT_
SINIT
4binary
Initial number of worker threads
16SMF111_
WT_
SMAX
4signed binary
Maximum number of worker threads
20SMF111_
WT_
ITIMEOUTS
4binary
Number of times worker time out reached
24SMF111_
WT_
IALLOCHI
4binary
Peak number of allocated worker threads
28--4

The table above is based on the description provided by IBM in its "MVS Systems Management Facilities (SMF)" manual.

Copyright 2017.
Pacific Systems Group.
All rights reserved.


Spectrum Writer 4GL - the economical alternative to SAS, Easytrieve, DYL-280...

Home | Products | Prices | Documentation | 30-Day Trials | Customer Reviews | Company | FAQ | Sample Reports | SMF Records
Send Your Comments or Questions