CICS metrics
Related topics
BMC AMI Ops Monitor for CICS views and background monitors provide important metrics for CICS. These are described in the following topics:
CICS metrics provided by views
Metric | Indicates | View name Field name Element name | Recommended view filter | Recommended field threshold (adjust for site-specific processing) |
|---|---|---|---|---|
Class A - Availability metrics | ||||
Available subsystem | The status of critical regions For the application to be available, the region must be up and running. | PLEXOVER Status STATUS | ASGNAME IN (region_name) | STATUS 'ACTIVE' |
CICS availability | CICS is available on the system | CREGAGT Region Status CRGNREGNSC | CRGNREGNSC 'ACTIVE' | CRGNREGNSC 'ACTIVE' |
Connection status | The status of required connections For communications between a CICS region and other subsystems, connections must be defined and enabled. An alert can be built if the connection status is not ENABLED. | CCONN Connect Status ACCONNSTATC | ACCONNECTIO IN (rgn1, rgn2...) | ACCONNSTATC 'ACQUI*' |
Db2 connection availability | Whether the interface between CICS and Db2 is available Communications between a CICS region and Db2 requires the connection and the status must be READY. This metric is also available from a monitor. See CICS-metrics-provided-by-monitors. | CREGDB2 Attachment Status RE7ASTATC | RE7ASTATC IN (INACTIVE, TERMINATE) | RE7ASTATC = 'INACTIVE' |
File status | The status of required files Certain files must be allocated and ENABLED for the application to be available. An alert can be built if the file status is not ENABLED. | CFILE Enable Status AAENABLESTC | Sample values shown:(AAENABLESTC NOT IN ('E*','N*') AND AANAME NOT IN ('DFH*','DBU*','FDB*') AND J@TARGET IN ('A0I*CICS',IPA1CICS,PRA2CICS)) | AAENABLESTC 'ENABLED' |
IMS connection availability and status | The availability and status of the interface between CICS and IMS Communications between a CICS region and IMS requires a connection with the DBCTL region and the status must be READY. This metric is also available from a monitor. See CICS-metrics-provided-by-monitors. | CREGDBC Attachment Status RE8STATUS | RE8JOBNAME ' ' | RE8STATUS = 'READY' |
CREGDBCD Connection Status RE8STATUS | RE8DBID = 4 character subsystem ID CREGDBCD is a detail view, so there should be more than one alarm definition with a filter of RE8DBID. | RE8STATUS 'READY' | ||
BMC AMI Ops Monitor for CICSactive in CICS region | Whether BMC AMI Ops Monitor for CICS is active If not, no internal monitoring of CICS can be seen. | CREGAGT Extract Status CRGNEXTRSC | CRGNEXTRSC = 'INACTIVE' | CRGNEXTRSC = 'INACTIVE' |
MQ connection availability | That a required MQ subsystem is not attached to the region and no messaging can take place Communications between a CICS region and an IBM MQ subsystem requires a connection to a queue manager and the connection status must be READY. | CREGMQS Connection Status RE9STATUSC | J@TARGET IN (rgn1, rgn2, rgn3...) and RE9SUBSYS = mqid Note: This view is a detail view; define more than one alarm definition with a filter of RE9SUBSYS = 4 character subsystem ID. | RE9STATUSC 'CONNECTED' |
Program status | The status of required programs Certain application programs must be ENABLED or the application transaction will fail. An alert can be built if the program status is not ENABLED. | CPROG Ena ABENAC | ABNAME NOT IN (DFH*,CSQCAPX) | ABENAC 'ENABLED' |
Transaction availability | The status of defined transactions within the region Identify any required transactions that have not been enabled for use. | CTRAN Enable Status A9STATUSC | T1TRANID (C*) and T1TRANID IN (trid1, trid2...) | A9STATUSC 'ENABLED' |
Class B - Performance metrics | ||||
ASRA abend | Data exception abends | CDUMPCD Curr Dumps TEACDUMPS | TEADUMPCDE IN (ASRA) | TEACDUMPS >= 5 |
Interval current value monitor | Any BMC AMI Ops monitors in warning status | CSERV % Warning MONIPWRN | MONSERV IN (svc1, svc2, svc3...) | MONIPWRN > 100 |
Region at maximum tasks | The CICS region has reached the maximum number of tasks and no additional tasks can start This metric is also available from a monitor. See CICS-metrics-provided-by-monitors. | CREGION %Max Task CRGRPMXT | CRGNTARG IN (rgn1, rgn2, rgn3...) | CRGRPMXT > 80 |
Transaction abends | General transaction abends | CDUMPCD Curr Dumps TEACDUMPS | (TEADUMPCDE NOT IN (ASRA) AND TEATYPEC IN ('TRANS*')) | TEACDUMPS >= 20 |
CHIST The CHISTORY view ABENDed Task field must be set to YES to display transactions in the CHIST view. | TRANID IN (user1,user2) | Return code > 0 | ||
Transaction throughput | The current CICS transaction throughput rate A less-than-normal transaction throughput rate for a region can indicate a problem elsewhere. | CREGION Tran Rate CRGITRTE | CRGNTARG IN (rgn1, rgn2, rgn3...) | CRGITRTE < nn |
Transactions with high CPU time | Transactions exceeding CPU time objectives Identify critical tasks in regions and groups of regions; do not use a context of ALL unless filters are used on Tran ID column in the TASK view. | TASK CPU Time T1FCPUTIM | T1TRANID NOT IN ('C*','J*',BCRT) and T1TTYPE = 'U' | T1FCPUTIM > '1' |
Transactions with high elapsed time | Transactions exceeding elapsed time objectives Identify critical tasks in regions and groups of regions; do not use a context of ALL unless filters are used on Tran ID column in the TASK view. | TASK Elapsed Time T1ELAPSTM | T1TRANID = filter and T1TTYPE = 'U' | T1ELAPSTIM > '00:05:00' |
Workload objectives | How well workloads are meeting response objectives | COBJ % <= Resp Goal MONIPJOB | MONPARM IN (wkld1, wkld2, wkld3...) | MONIPJOB < 100 |
CICS metrics provided by monitors
The metrics in the following table are available from the BMC AMI Ops Monitor for CICS background monitors.
You can specify monitor options, such as WIF, to ensure that a condition persists for a certain number of intervals before issuing a warning. For more information about monitor options, see Using data collection monitors.
Metric | Indicates | Monitor | Monitor message | Recommended monitor value |
|---|---|---|---|---|
Class A - Availability metrics | ||||
Db2 connection availability | Whether the interface between CICS and Db2 is available Communications between a CICS region and Db2 requires the connection and the status must be READY. This metric is also available in a view. See CICS-metrics-provided-by-views. | @DB2N | FT517W | none |
IMS connection availability and status | The availability and status of the interface between CICS and IMS Communications between a CICS region and IMS requires a connection with the DBCTL region and the status must be READY. This metric is also available in a view. See CICS-metrics-provided-by-views. | @IMSN | FT518W | none |
Class B - Performance metrics | ||||
Region at maximum tasks | The CICS region has reached the maximum number of tasks and no additional tasks can start This metric is also available in a view. See CICS-metrics-provided-by-views. | MXTC | FT1070W | WVAL=75 |
@PRB1 | FT054W | WLIM=5 | ||