ALERT-initiated CLISTs
An ALERT-initiated EXEC (also called a follow-up EXEC) is scheduled by a user from the ALERT Management Facility.
When coding the EXEC that issues the IMFEXEC ALERT command, use the EXEC parameter to specify the name of the follow-up EXEC.
The EXEC is then scheduled from the ALERT Detail Display panel of the ALERT Management Facility by entering any value (up to five characters) in the RSP column of the panel.
To read about | Refer to |
|---|---|
how to actually schedule the EXEC | Chapter 3, the 'ALERT Management Facility' in the MainView AutoOPERATOR Basic Automation Guide, Volume 1: Using Rules |
coding an ALERT with an associated EXEC | Using-the-IMFEXEC-statements in this book |
Potential use
When an ALERT appears on the DETAIL display, it may require an advanced automation response.
An ALERT-initiated EXEC can handle such a response. By entering any value (up to five characters) in the RSP column of the ALERT Detail panel, you can schedule a follow-up EXEC.
This section describes one possible use for an ALERT-initiated EXEC where the EXEC logs messages in the BBI-SS PAS Journal.
Parameters passed to the EXEC
When an ALERT-initiated EXEC is coded, the IMFEXEC ALERT . . . EXEC(ABC) command can schedule the follow-up EXEC with or without parameters. In this example, the EXEC name is ABC:
without optional parameters:
IMFEXEC ALERT ... EXEC(ABC)with optional parameters ( x y z ):
IMFEXEC ALERT ... EXEC('ABC x y z')If the EXEC has parameters, you must enclose them in single quotation marks ( ' ' ) with the EXEC name. If you do not, only the EXEC name will be passed and the parameters will not be passed.
See the following examples of input for more information.
The first positional parameter passed to the ALERT-initiated EXEC is always the EXEC name. The characters that you enter in the RSP column ALERT Detail Display to schedule the EXEC are also passed. However, the position that those characters have depends on whether or not you use optional parameters.
Example of input without parameters
For example, you enter
DEF
in the RSP column of the ALERT DETAIL DISPLAY panel.
Then, the PROC statement receives data passed in the following way:
Positional Parameter | Value passed | Description |
|---|---|---|
1 | EXEC name | is the name of the EXEC |
2 | DEF (contents of the 5-character RSP column) | is the (up to) five-character string the user enters in the RSP column of the ALERT DETAIL DISPLAY panel to actually invoke the ALERT |
3 through n | text of the ALERT | are the actual words of the ALERT associated with the scheduled EXEC |
Example of input with parameters
For example, you enter
DEF
in the RSP column of the ALERT DETAIL DISPLAY panel, the PROC statement receives data passed in the following way:
Positional parameter | Value passed | Description of value passed |
|---|---|---|
1 | EXEC name | is the name of the EXEC |
2 | x | is the first parameter passed to the EXEC |
3 | y | is the second parameter passed to the EXEC |
4 | z | is the third parameter passed to the EXEC |
5 | DEF (contents of the 5-character RSP column) | is the (up to) five-character string the user enters in the RSP column of the ALERT DETAIL DISPLAY panel to actually invoke the ALERT |
6 through n | text of the ALERT | are the actual words of the ALERT associated with the scheduled EXEC |