Logging levels for transaction monitoring

Edit online

The message logs for transaction monitoring are always in JSON format. The logging levels can be 0, 1, 2, or 3.

CH51 Simple Monitor or level 0 means that logging is not enabled for transaction monitoring. After you enable transaction monitoring with level 1, 2, or 3, a log message is issued to specify the type of ECI based flow along with the type and the date and time through the Gateway daemon, as follows:

  • type – The value is CH51.
  • datetime – The date and time at which the message is issued.
  • flow – The flow type, which can be one of the following:
    • EciStatus – Invoked by a request from a list system.
    • EciSynconreturn – For non-transactional ECI requests.
    • ExtendedModeEci, ExtendedModeCommit, and ExtendedModeRollback – For 1pc extended units-of-work
    • XAEci – For ECI requests in a 2pc XA global transactions from WAS.
    • XAStart, XAPrepare, XACommit, XARollback, and Recover – XA control flows for XA global transactions
Additional data will be provided based on the following information, if present in the ECI request:
  • Abend – The CICS abend code.
  • cics_rc – The return code from ECI call (if non-zero).
  • ctg_rc – The return code from Gateway (if non-zero).
  • CICScall – Time in millisecond (ms) for CICS to respond to the request from the Gateway daemon.
  • ClientApplid – Fully-qualified applid specified in the JCA connection factory for the Java™ client invoking this request (requires a resource adapter 7.1 or later).
  • ClientIP – The IP address of the Java client that sent the request.
  • DistID – The distributed identity, if specified.
  • Pgm – The name of the CICS® program to be invoked.
  • RespTime – The time (in millisecond) required by the Gateway or Java client to process the request (including any CICS call time).
  • Retries – The number of retry attempts when using the dynamic server selection (using a CICS request exit) process.
  • Srv – The name of the CICS server (and the remapped server name if server name remapping is in use). This field is always displayed even when null.
  • EIBTrnid/MirrorTrnid – The mirror transaction name, if specified. This field is displayed as Trnid (null), if not specified. The value defaults to CSMI for CICS Transaction Gateway on z/OS.
  • Userid – The flow userid, if specified.
  • wait – The worker wait time if requests are queued in the Gateway daemon.

Sample of a message output at logging level 1:

{"Type":"CH51", "datetime":"05/30/24 16:41:29:998", "message":" CH51 Starting CH51SimpleMonitor V1.9 OS details(z/OS) JVM encoding(UTF-8)"} 
{"Type":"CH51", "datetime":"05/30/24 16:41:30:002", "message":"Logging enabled", "level":"1"} 
{"Type":"CH51", "datetime":"05/30/24 16:41:50:305", "Flow":"EciSynconreturn", "Srv":"SERVERA", "Pgm":"EC01", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "commarea":"18", "RespTime":"84", "CICScall":"2"}
 {"Type":"CH51", "datetime":"05/30/24 16:41:50:519", "Flow":"XaStart", "Srv":"SERVERA", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "RespTime":"1"}
 {"Type":"CH51", "datetime":"05/30/24 16:41:51:317", "Flow":"XaEci", "Srv":"SERVERA", "Pgm":"EC01", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "commarea":"18", "RespTime":"4", "CICScall":"0"}

For logging level 2, additional information is provided to indicate the COMMAREA and socket data sizes; and the time of the input (request) and return (response) messages.

Sample of a message output at logging level 2:

{"Type":"CH51", "datetime":"05/30/24 16:43:52:409", "message":" CH51 Starting CH51SimpleMonitor V1.9 OS details(z/OS) JVM encoding(UTF-8)"} 
{"Type":"CH51", "datetime":"05/30/24 16:43:52:413", "message":"Logging enabled", "level":"2"} 
{"Type":"CH51", "datetime":"05/30/24 16:44:01:250","Event":"request", "RequestNo":"1", "Flow":"EciSynconreturn", "Srv":"SERVERA", "Pgm":"EC01", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "commarea":"18", "SocketData":"135"} 
{"Type":"CH51", "datetime":"05/30/24 16:44:01:331","Event":"response", "RequestNo":"1", "Flow":"EciSynconreturn", "Srv":"SERVERA", "Pgm":"EC01", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "commarea":"18", "SocketData":"147", "RespTime":"81", "CI CScall":"2"}
 {"Type":"CH51", "datetime":"05/30/24 16:44:01:541","Event":"request", "RequestNo":"2", "Flow":"XaStart", "Srv":"SERVERA", "ClientIP":"X.XX.XXX.XXX", "SocketData":"160"}
 {"Type":"CH51", "datetime":"05/30/24 16:44:01:542","Event":"response", "RequestNo":"2", "Flow":"XaStart", "Srv":"SERVERA", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "SocketData":"39", "RespTime":"1"} 
{"Type":"CH51", "datetime":"05/30/24 16:44:01:723","Event":"request", "RequestNo":"3", "Flow":"XaEci", "Srv":"SERVERA", "Pgm":"EC01", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "commarea":"18", "SocketData":"233"} 
{"Type":"CH51", "datetime":"05/30/24 16:44:01:726","Event":"response", "RequestNo":"3", "Flow":"XaEci", "Srv":"SERVERA", "Pgm":"EC01", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "commarea":"18", "SocketData":"147", "RespTime":"3", "CICScall":"2" } 
{"Type":"CH51", "datetime":"05/30/24 16:44:01:907","Event":"request", "RequestNo":"4", "Flow":"Xa1PhaseCommit", "Srv":"SERVERA", "ClientIP":"X.XX.XXX.XXX", "SocketData":"160"}

For logging level 3, additional tracking data is added to the log messages as given below:

  • TrnGrpId – The transaction group ID tracking token for use with IPIC connections. This can also be viewed in the CICS task association data.
  • LuwToken – The logical unit of work token for 1pc extended units of work. This value can be used to correlate multiple requests inside the CICS Transaction Gateway.
  • Xid – The XA transaction identifier for 2pc XA requests from JCA clients, consisting of the GTRID.BQUAL. This can be used to correlate the XA requests with requests within the WebSphere® Application Server and CICS.
  • Urid – The RRS UR ID. This can be used to correlate the XA requests using EXCI with RRS URs and CICS units of work.
  • NetworkUOW – Used to correlate synconreturn requests through EXCI connections with associated CICS tasks.

Sample of a message output at logging level 3:

{"Type":"CH51", "datetime":"05/30/24 16:32:17:122", "message":" CH51 Starting CH51SimpleMonitor V1.9 OS details(z/OS) JVM encoding(UTF-8)"}
 {"Type":"CH51", "datetime":"05/30/24 16:32:17:130", "message":"Logging enabled", "level":"3"} 
{"Type":"CH51", "datetime":"05/30/24 16:33:34:163","Event":"request", "RequestNo":"1", "Flow":"EciSynconreturn", "Srv":"SERVERA", "Pgm":"EC01", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "commarea":"18", "SocketData":"135"} 
{"Type":"CH51", "datetime":"05/30/24 16:33:34:240","Event":"response", "RequestNo":"1", "Flow":"EciSynconreturn", "Srv":"SERVERA", "Pgm":"EC01", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "commarea":"18", "SocketData":"147", "RespTime":"77", "CI CScall":"2", "TrnGrpId":"170DD4E5F2C7F6F42ED5C9E3C9D5D4DF2BDDFC54E08200"} 
{"Type":"CH51", "datetime":"05/30/24 16:33:34:582","Event":"request", "RequestNo":"2", "Flow":"XaStart", "Srv":"SERVERA", "ClientIP":"X.XX.XXX.XXX", "SocketData":"160", "Xid":"0000018FCA22922F00000001288A48C41278D2B086E885F7C417C60FD0F215660A89D CEC.0000018FCA22922F00000001288A48C41278D2B086E885F7C417C60FD0F215660A89DCEC000000010000000000000000000000000001"} 
{"Type":"CH51", "datetime":"05/30/24 16:33:34:584","Event":"response", "RequestNo":"2", "Flow":"XaStart", "Srv":"SERVERA", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "SocketData":"39", "RespTime":"2", "Xid":"0000018FCA22922F00000001288A48C41278D 2B086E885F7C417C60FD0F215660A89DCEC.0000018FCA22922F00000001288A48C41278D2B086E885F7C417C60FD0F215660A89DCEC000000010000000000000000000000000001"} 
{"Type":"CH51", "datetime":"05/30/24 16:33:34:774","Event":"request", "RequestNo":"3", "Flow":"XaEci", "Srv":"SERVERA", "Pgm":"EC01", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "commarea":"18", "SocketData":"233", "Xid":"0000018FCA22922F00000001 288A48C41278D2B086E885F7C417C60FD0F215660A89DCEC.0000018FCA22922F00000001288A48C41278D2B086E885F7C417C60FD0F215660A89DCEC000000010000000000000000000000000001"}
 {"Type":"CH51", "datetime":"05/30/24 16:33:34:780","Event":"response", "RequestNo":"3", "Flow":"XaEci", "Srv":"SERVERA", "Pgm":"EC01", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "commarea":"18", "SocketData":"147", "RespTime":"6", "CICScall":"2" , "Xid":"0000018FCA22922F00000001288A48C41278D2B086E885F7C417C60FD0F215660A89DCEC.0000018FCA22922F00000001288A48C41278D2B086E885F7C417C60FD0F215660A89DCEC000000010000000000000000000000000001", "TrnGrpId":"170DD4E5F2C7F6F42ED5C9E3C9D5D4DF2BDDFCDA AA8400"}
 {"Type":"CH51", "datetime":"05/30/24 16:33:35:000","Event":"request", "RequestNo":"4", "Flow":"Xa1PhaseCommit", "Srv":"SERVERA", "ClientIP":"X.XX.XXX.XXX", "SocketData":"160", "Xid":"0000018FCA22922F00000001288A48C41278D2B086E885F7C417C60FD0F215 660A89DCEC.0000018FCA22922F00000001288A48C41278D2B086E885F7C417C60FD0F215660A89DCEC000000010000000000000000000000000001"} 
{"Type":"CH51", "datetime":"05/30/24 16:33:35:003","Event":"response", "RequestNo":"4", "Flow":"Xa1PhaseCommit", "Srv":"SERVERA", "Trnid":"null", "ClientIP":"X.XX.XXX.XXX", "SocketData":"39", "RespTime":"3", "CICScall":"1", "Xid":"0000018FCA2292 2F00000001288A48C41278D2B086E885F7C417C60FD0F215660A89DCEC.0000018FCA22922F00000001288A48C41278D2B086E885F7C417C60FD0F215660A89DCEC000000010000000000000000000000000001"}