Monitoring transaction-level statistics

IMS logs statistical data about transactions to the OLDS in the X'56FA' log record. You can use this log record to collect, analyze, and interpret statistical data for general business purposes.

This statistical information is only a subset of the information that is logged to the X'07' log record. Transactions within a specific scope (such as a unit of recovery) from the X'07' log record are collected. Since the statistical information about the transactions is also logged separately in the X'56FA' log record, you can access this information more easily than extracting it from the X'07' log record.

IMS logs statistical information about the transactions within a unit of recovery (work done by an application program between sync points) in log record X'56FA' for non-message-driven applications, or when either:

• The keyword MODE=SNGL is specified in the TRANSACT macro
• The CMTMODE(SNGL) parameter is specified on a CREATE TRAN or UPDATE TRAN command

IMS logs statistical information about the transactions after each message in log record X'56FA' for message-driven applications when either:

• The keyword MODE=MULT is specified in the TRANSACT macro
• The CMTMODE(MULT) parameter is specified on a CREATE TRAN or UPDATE TRAN command

You can enable or disable this logging on a program basis for non-message driven applications, and on a transaction-by-transaction basis for message-driven applications. Use the following commands to enable or disable this logging on a transaction-by-transaction basis:

• For an existing transaction, issue the UPDATE TRAN or UPDATE TRANDESC command and specify the new TRANSTAT() parameter.
• For a new transaction, issue the CREATE TRAN or CREATE TRANDESC command and specify the new TRANSTAT() parameter.

To enable or disable this logging on a program basis:

• For an existing application program, issue the UPDATE PGM or UPDATE PGMDESC command and specify the new TRANSTAT() parameter.
• For a new application program, issue the CREATE PGM or CREATE PGMDESC command and specify the new TRANSTAT() parameter.

You can enable or disable this logging globally during system definition by specifying a new parameter, TRANSTAT= Y | N, in the Diagnostics Statistics section of the new DFSDFxxx PROCLIB member. This setting applies to any transactions and application programs that are created with the system definition process.

Any transactions or application programs that are created after an IMS cold start using the online change process or the Destination Creation exit routine (DFSINSX0) inherit the TRANSTAT= parameter setting that is specified in the DIAGNOSTICS_STATISTICS section of the DFSDFxxx PROCLIB member.

To determine whether or not this logging is enabled for a given transaction or application program, issue one of the following type-2 commands:

• QUERY TRAN
• QUERY TRANDESC
• QUERY PGM
• QUERY PGMDESC