Defining Messages for Status Change (Status Messages)
Status messages are those messages that indicate a status change of the resource.
Many status messages of APL, MTR, and MVC resources are known to SA z/OS. The related AT entries are already predefined. For example, for a message indicating that an APL is available, ACTIVMSG command is triggered. For a message indicating that an APL is unavailable, TERMMSG command is triggered.
For these predefined messages, there is no need to have additional definitions in the policy database.
The code definitions for message IEF450I are important. Sample policy *BASE includes a set of recommended code definitions.
Display existing status messages
To display all predefined and user-defined status messages and their associated statuses, use the Status Message Report in Customization Dialog.
- On the Customization Dialog primary panel, select option 3 (Report).
- Select option 8 (StatusMsgs) to create a status messages report. Pressing Enter returns you to the Report Selection panel.
- Select option 9 to view the report. As the following screen excerpt shows, the report shows the
message ID, resource status indicated by this message, message description, the entry name, and the
entry type that the message is defined
for.
Message ID |Status |Description |Entry Name | Typ -----------+------------+-----------------------------+--------------------+------------ CQS0020I |UP |CQS up message |+SA_PREDEFINED_MSGS | MVC TEST001I |UP |Test application has started | APPL1 | APL
Define additional status messages
If a status message is not predefined by SA z/OS, you can define it additionally for APL, MTR, and MVC policy entries. The A or M action leads to the Message Automation Overview panel, where you can enter the AS option to display the AT Status Specification panel that lists resource statues.
The following example defines an APL's UP status, which is indicated by message XYZ444I. On the Message Processing panel, specify the XYZ444I message ID and enter A or M in the Cmd field next to it.
COMMANDS HELP
--------------------------------------------------------------------------------
Message Processing Line 00000001 Col 001 075
Entry Type : Application PolicyDB Name : DEMO
Entry Name : MYAPL Enterprise Name : DEMO
Line Commands: S/C (Cmd), R (Rep), K (Cod), U (Usr), A,M (AT, MRT, MPF)
I, D (insert or delete lines), CN (Class Name)
Message ID field length. . 16 (1 - 32)
Cmd Message ID Description C R K U A M F
A XYZ444I
On the displayed Message Automation Overview panel, enter the AS option to display the AT Status Specification panel and select the UP status.
COMMANDS HELP
-------------------------------------------------------------------------------
AT Status Specification
Command ===>
View or change specifications for message: XYZ444I
Application / MVC Component status Monitor health status
ACTIVE Starting NORMAL Resource shows good results
s UP Available WARNING Resource shows degradation
HALTED Degraded MINOR More severe than WARNING
Terminating Received STOP command CRITICAL More severe than MINOR
Terminated Terminated normally FATAL More severe than CRITICAL
ABENDING Going to end abnormally UNKNOWN Health status not available
Abended Ended abnormally Check Evaluate health status
BREAKING Non-recoverable abending Monitor status
BROKEN Non-recoverable abend FAILED Monitor failed
BROKEN Monitor finally failed
Capture specification
Capture Capture Message
DOM . . . Press PF3 to return to Message Automation Processing panel. This definition leads to the creation of an AT entry for message XYZ444I using the ACTIVMSG command after the next configuration build process, as shown on the Message Automation Overview panel.
COMMANDS VIEW HELP
------------------------------------------------------------------------------
Message Automation Overview
AC AT condition MS MRT action selection MF MPFLSTxx specifications
AS AT status MO MRT override IG Ignore for AT, MRT, MPF
AO AT override
Message ID : XYZ444I
Generated AT entry :
IF MSGID = 'XYZ444I' THEN
EXEC(CMD('ACTIVMSG UP=YES') ROUTE(ONE %AOFOPGSSOPER%));
Generated MRT entry :
UPON ( MSGID = 'XYZ444I' )
REVISE('Y' AUTOMATE)
Generated MPF entry :
XYZ444I
Command ===> Scroll ===> PAGE