This section contains the following topics:
Ensure that CA OPS/MVS Is Enabled for Capturing These Events
CA View provides seamless integration with CA OPS/MVS by automatically communicating both active status events and heart beat events to CA OPS/MVS. The enabling technology for this is through a generic event API call that CA OPS/MVS provides the other mainframe products so that they can communicate events to CA OPS/MVS.
You do not need to do anything for CA View to enable this event communication interface to CA OPS/MVS. If CA View and CA OPS/MVS are active in the same z/OS image, CA View automatically communicates these automation events to CA OPS/MVS.
By generating active status events CA View and other CA products are able to communicate to CA OPS/MVS’s System State Manager (SSM) component when they are starting, up, stopping or down.
SSM is a built-in feature that uses an internal relational data framework to proactively monitor and manage started tasks, online applications, subsystems, JES initiators, and other z/OS resources including your CA mainframe products. SSM compares the current state of online systems, hardware devices, and the other resources with their desired state, and then automatically makes the necessary corrections when a resource is not in its desired state. This provides proactive and reactive state management of critical resources.
Before the CA OPS/MVS interface existed, CA OPS/MVS could automate active status events for your CA products; however this typically required monitoring unique messages for each CA product. With this interface, CA OPS/MVS can capture these events for any of your CA products with a single automation event rule.
With the heart beat event, CA View can communicate a normal, warning, or problem overall health status and reasoning to CA OPS/MVS on a regular interval. Once CA View begins generating heart beat events for CA OPS/MVS, CA OPS/MVS can also react to the lack of a heart beat event from CA View, treating this as an indication that there is either a potential problem with CA View, or there is a larger system-level problem that is taking place.
To ensure that this CA OPS/MVS interface is active, make sure the CA OPS/MVS parameter APIACTIVE is set to its default of ON. This allows CA OPS/MVS to acknowledge and process the events generated by CA View and other CA products through this interface.
CA View provides a direct interface to the CA OPS/MVS System State Manager (SSM) application to notify CA OPS/MVS of the current operating state of the given CA View address space. The CA OPS/MVS SSM application can use this information to automatically control the operation of the CA View address space, and any other address space that is dependent upon the CA View address space being active. For more information on using CA OPS/MVS SSM see the CA OPS/MVS User Guide.
The CA View product active state is presented to CA OPS/MVS and can be processed by the following rule:
)API CASTATE
The available OPS/REXX variables for CA View product state management are:
OPS/REXX Variable Value
API.APPLICATION CA View API.VERSION Current release API.LEVEL 00 API.EVENTID CASTATE API.MSGID CASTATE API.TEXT State of CA View
The API.TEXT variable has the following format:
State of appl_id is current_state'
Specifies the same value as the API.APPLICATION variable
Indicates that CA View is initializing
Indicates that CA View is active
Indicates that CA View is terminating
Indicates that CA View is exiting the system
For more information on how to use the CASTATE API, see the member SSMCAAPI of opsmvsHLQ.STATEMAN.RULES.
CA View provides a continuous heartbeat event directly to CA OPS/MVS. CA OPS/MVS can use this information in several ways to determine the operational health of the CA View product.
CA View issues a heartbeat update every nnnn seconds that notifies CA OPS/MVS of the current operational health of the CA View product.
If CA View detects a health state change, it immediately generates a heartbeat update without waiting for the nnnn second heartbeat interval to expire. In this way, CA View provides CA OPS/MVS with a constant operational health state view of the CA View product.
CA OPS/MVS can also react to the lack of a heartbeat update from CA View and an indication that there is either a potential problem with CA View, or there is a larger system level problem that is taking place.
The CA View product heartbeat event is presented to CA OPS/MVS and can be processed by the following rule:
)API CAHEARTBT
The available OPS/REXX variables for CA View state management are:
OPS/REXX Variable Value
API.APPLICATION CA View API.VERSION Current release API.LEVEL 00 API.EVENTID CAHEARTBT API.MSGID CAHEARTBT API.TEXT State of CA View
The API.TEXT variable has the following format:
appl_id Status: heartbeat_state Reason: reason_text
Specifies the value of the API.APPLICATION variable.
Heart_beat_state can be one of the following:
Indicates that CA View is operating normally, without any detected problems.
reason_text explains the problem as reported by the event API call.
For information on how you use the CAHEARTBT API, see members APIHRTB1, APIHRTB2, and APIHRTB3 of opsmvsHLQ.SAMPLE.RULES.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|