CXGCICS Statistics

The ConnecX Attachment Facility (CXGCICS) provides the following statistics information:

  • System-specific statistics provide information collected during the lifetime of the service (from the time when the service was started until the service was instructed to terminate). The statistic information is issued during the final stage of termination. System-specific statistics are always collected and issued.

  • Task-specific statistics are collected during the lifetime of a task (from the initial application call to the TRUE until CICS issues the end-of-task request. Statistics information is issued during the final stage or task termination. Collection and processing of task-specific statistics can be controlled by the setting of the STATISTICS parameter of the CXGMCONN macro.

All statistic information is written to either the CICS Statistics Log (CSSL) or to the destination identified by the setting of the STATSQUEUE parameter of the CXGMCONN macro. The sample CSD definitions use the queue names UQM1 for message queue 1 and UQS1 for statistics queue 1.

This document describes both types of statistics.

System Statistics

System statistics are issued in informational message CXGK100I. This message consists of blocks of information providing the message number (CXGK100I), system information, and statistics information, in the following format: 

CXGK100I system-information statistics-information

The content of each block of information is described in the table below:

Information Block Information Subtype Length Value/Description Subtype Data Subtype Data Value/Description
Message Number Constant 8 CXGK100I --- ---
System Information SYSID 4 System identification. --- ---
TRUE name 8 CXGCIEX1 --- ---
TRUE entry point 8 CXGCIEX1 --- ---
Service task orientation 4 UQST --- ---
Timestamp 23 Date and time of the message. --- ---
Statistics Information ConnecX Gateway 60 Information about the start, end, and duration of the service. Started The date and time at which the service was started.
Ended The date and time at which the service was terminated.
Duration The amount of time the service was active.
Session 60 Information on the number of sessions processed by the service. Max. Concurrent Sessions The largest number of concurrent sessions.
Sessions (Total) The total number sessions processed.
Sessions (Active) The total number of session active at shutdown.
Recovery Sessions (CRSY) The number of recovery sessions processed.
Abends (Appl) The number of application abnormal terminations for with the TRUE was called by CICS.
Authorization 60 Information on the number of signon attempts. UQST Signon The number of signons performed by the service task.
APPL Signon The number of signons performed by the application.
APPL Errors The number of signon errors encountered.
Application 60 Information on the number of calls issued by the application. APPL Calls The number of SQL statements issued by the application.
APPL Errors The number of SQL errors received by the application.
Syncpoint 60 Information on the number and types of syncpoint, which were requested by CICS. 2-phase Commit The number of 2-phase commit syncpoints processed.
1-phase Commit The number of 1-phase commit syncpoints processed.
Rollback The number of rollback syncpoints processed.
Forget The number of forget syncpoints processed.
Lost The number of lost syncpoints processed.
Wait The number of wait syncpoints processed.
SYNC Errors The number of syncpoint errors encountered.

The following is an example of the system statistics:

CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    Started......: 2013-23-05 14:36:23
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    Ended........: 2013-23-05 14:37:22
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    Duration.....: 00:00:59.170
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990  SESSION
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    Max.Concurrent Sessions:      1
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    Sessions (Total).......:      3
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    Sessions (Active)......:      0
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    RECOVERY (CRSY)........:      0
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    RESYNC.................:      0
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    ABENDS.................:      0
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990  AUTHORIZATION
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    SignOn (APPL)..........:      3
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    Errors (APPL)..........:      0
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    SignOn (UQST)..........:      1
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    Errors (UQST)..........:      0
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990  APPLICATION
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    Calls  (APPL)..........:     20
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    Errors (Calls).........:      0
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990  SYNCPOINT
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    COMMIT,2-PHASE.........:      0
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    COMMIT,1-PHASE.........:      1
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    ROLLBACK...............:      1
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    FORGET ................:      0
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    LOST ..................:      0
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    WAIT ..................:      0
CXGK100I  CI02 CXGCIEX1/CXGCIEX1 UQST 2013-23-05 14:37:22.990    Error (Sync)...........:      0

Task Statistics

Task statistics are issued in informational message CXGK110I. This message consists of blocks of information providing the message number (CXGK110I), system information, and statistics information, in the following format: 

CXGK110I system-information statistics-information

This section covers the following topics:

Task Statistic Contents

The content of each block of information is described in the table below:

Information Block Information Subtype Length Value/Description
Message Number Constant 8 CXGK110I
System Information SYSID 4 System identification
Terminal/Session ID 4 Terminal or session ID (UOW)
User ID 8 User ID (UOW)
Transaction ID 4 Transaction ID (UOW)
Timestamp 23 Date and time of the message
Statistic Information Record Type 4 Type of statistic record. Read Task Statistic Record Types.
Record Data 60 Payload of the record. Read Task Statistic Record Payloads.

Task Statistic Record Types

The following table describes the different types of task statistics records.

Record Type Description
TIM1 Timestamp: Session Begin
TIM2 Timestamp: Session End
TIM3 Duration of Session (Elapsed Time)
TIM4 Duration of RI processing: TRUE
TIM5 Duration of RA processing: CXGSERV Services, Sign-On and Transaction processing
TIM6 Duration of SQL processing: CXGSERV, JDBC-/Data-Server and database
AUTH Number Sign-On: Errors, Successful
RCI1 Number Commands: Error, Total, READ, Modify
RCI2 Statement Types: DML, DYNAMIC, DDL, DCL
RCI3 Command Types: Access, Insert, Delete, Update
RCI4 Command Types: Diagnostic, Setting, Transaction, Session
SYN1 Number SYNCPOINTS: Errors, Rollbacks, 1-Phase and 2-Phase Commits
SYN2 Number SYNCPOINTS: Waits, Forgets, Lost
SESS Number of Sessions: Overall Maximum, Currently Active
SRV1 CONNECT Information: CXG-Server Hostname
SRV2 CONNECT Information: CXX-Server Hostname
SRV3 CONNECT Information: User Identification

Task Statistic Record Payloads

The payload of each record type is provided in this section.

TIMn Records

Information Block Section Length Value/Description
TIM1 – Session Begin Prefix, Constant 4 TIM1
Timestamp 23 Date and Time of Session BEGIN
TIM2 – Session End Prefix, Constant 4 TIM2
Timestamp 23 Date and Time of Session END
TIM3 – Duration of Session Prefix, Constant 4 TIM3
Timestamp 23 Days, Hours, Minutes, Seconds, Milliseconds
TIM4 – Duration (RI) Prefix, Constant 4 TIM4
Timestamp 23 Days, Hours, Minutes, Seconds, Milliseconds
TIM5 – Duration (RA) Prefix, Constant 4 TIM5
Timestamp 23 Days, Hours, Minutes, Seconds, Milliseconds
TIM5 – Duration (SQL Statement) Prefix, Constant 4 TIM6
Timestamp 23 Days, Hours, Minutes, Seconds, Milliseconds

AUTH Records

Information Block Section Length Value/Description
AUTH – Session Begin Prefix, Constant 4 AUTH
Signon Errors 8 Integer
Signon Successful 8 Integer

RCIx Records

Information Block Section Length Value/Description
RCI1 – Number SQL Commands Prefix, Constant 4 RCI1
SQL Errors 8 Integer
Total Number of Commands 8 Integer
Number of Read-Only 8 Integer
Number of Modify 8 Integer
RCI2 – Statement Types Prefix, Constant 4 RCI2
Number of DML 8 Integer
Number of Dynamic 8 Integer
Number of DDL 8 Integer
Number of DCL 8 Integer
RCI3 – Command Types Prefix, Constant 4 RCI3
Number of Access 8 Integer
Number of Insert 8 Integer
Number of Delete 8 Integer
Number of Update 8 Integer
RCI4 – Command Types Prefix, Constant 4 RCI4
Number of Diagnostic 8 Integer
Number of Settings 8 Integer
Number of Transaction 8 Integer
Number of Session 8 Integer

SYNn Records

Information Block Section Length Value/Description
SYN1 – Number Syncpoints Prefix, Constant 4 SYN1 Prefix, Constant 4 SYN1
Error Conditions 8 Integer
Number of Rollback 8 Integer
Number of 1-Phase Commits 8 Integer
Number of 2-Phase Commits 8 Integer
SYN2 – Number Syncpoints Prefix, Constant 4 SYN2
Number of WAIT 8 Integer
Number of FORGET 8 Integer
Number of LOST 8 Integer

SESS Records

Information Block Section Length Value/Description
SESS – Number Sessions Prefix, Constant 4 SESS
Max. Number of Sessions 8 Integer
Number of Active Sessions 8 Integer

SRVx Records

Information Block Section Length Value/Description
SRV1 – CONNECT Information (CXG) Prefix, Constant 4 SRV1
CXG-Server Hostname 60 Character
SRV2 – CONNECT Information (CXX) Prefix, Constant 4 SRV2
CXX-Server Hostname 60 Character
SRV3 – CONNECT Information (User) Prefix, Constant 4 SRV3
User Identification 60 Character

Task Statistics Example

CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  TIM1: 2013-23-05 14:37:18
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  TIM2: 2013-23-05 14:37:19
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  TIM3:     00:00:00.930
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  TIM4:     00:00:00.500
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  TIM5:     00:00:00.410
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  AUTH:        0       1
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  RCI1:        0       4       4       0
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  RCI2:        4       0       0       0
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  RCI3:        4       0       0       0
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  RCI4:        0       0       0       0
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  SYN1:        0       0       0       0
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  SYN2:        0       0       0        
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  SESS:               1                1
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  SRV1: my.cxghost.org:7937             
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  SRV2: DD=CXGCICS;GATEWAY=my.host1.org:7500
CXGK110I  CI02 TC53BVT0 CICSUSER BVT0 2013-23-05 14:37:19.840  SRV3: CICSUSER