CICS metrics provided by views
The following metrics are available in the
MainView for CICS
views. For information about using this table, see How-to-use-the-metric-tables.
Before you create alarms based on these metrics, review Planning.
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' | ||
MainView for CICS active in CICS region | Whether MainView 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 MainView 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 |
Related topic