ALERT

This command manages exception messages and message queues that can be displayed by any of the STATUS applications and ALERTs applications.

Command

Parameters

ALERT

alert-key

'alert-text'

[FUNCTION(ADD|COUNT|CREATEQ|DELETE|DELETEQ|LISTQ|READQ)]

[ALARM(NO|YES)]

[COLOR(RED|PINK|YELLOW|DKBLUE|LTBLUE|GREEN|WHITE)]

[DISPOSE(KEEP|DELETE)]

[ESCALATE(UP|DOWN)]

[ESCCMD(type,PRI(NORMAL|HIGH| HOT| FIRST),DLY(0-99999):(command)]

[ESCEXEC(PRI(NORMAL|HIGH| HOT|FIRST),DLY(0-99999):execname p1 p2 p3...pn]

[EXEC(PRI(NORMAL|HIGH| HOT|FIRST),DLY(0-99999):execname p1 p2 p3...pn]

[HELP(panelname)]

[INTERVAL(nnnn,nnnn,nnnn,nnnn,nnnn,nnnn)]

[ORIGIN(origin)]

[PCMD('cmd string')]

[POSITION(position)]

[PRI(CRITICAL|MAJOR|MINOR|WARNING|INFORMATIONAL|CLEARING)]

[QUEUE(MAIN|queue name)]

[RETAIN(YES|NO)]

[SYSTEM(YES|NO)]

[TARGET(target name)]

[TEXT('text string')]

[UDATA('user data')]

[USER(user name)]

You can use the following keywords with IMFEXEC ALERT keywords when you also have the BMC Impact Integration for z/OS product and have specified PRODUCT=IIZ in BBPARM member BBISSP00.

 

ALIAS[alias_name]

BIIZJRNL[(YES | NO)]

CLASS[event_class-name]

PUBLISH[(REPLACE|ADD|NO)]

SLOTSTEM[stem_variable]

TGTPUB

The following table describes the parameters.

ALERT command parameters

Parameter

Function

Notes

alert-key

the key used to uniquely identify an ALERT within a queue

Maximum length is 64 alphanumeric positions. Required for

  • FUNCTION(ADD)

  • FUNCTION(DELETE)

Optional for

  • FUNCTION(READQ)

You must specify a unique key for every ALERT you create. If you create a second ALERT with the same key as an already existing ALERT, the second ALERT overwrites the first ALERT.

The key cannot contain blanks.

Valid characters that you can use for the alert-key include the following; cent sign (¢), period(.), less than and greater than (<,>), plus sign (+), vertical bar (|), exclamation point (!), dollar sign ($), asterisk (*), not sign (¬), hyphen (-), slash (/), Euro symbol (€), percent sign (%), underscore(_), question mark (?), grave sign ( `), colon (:), pound sign (#), at sign (@), equal sign (=), alphabetic letters a through z, and numbers 0 through 9.

'alert-text'

the text of the ALERT message

Maximum message length is 255 alphanumeric positions. This parameter is required for

FUNCTION(ADD)

If the contents of the text are null but specified (for example, zero length), the ALERT text is replaced by N/A. A specification of /N within the alert text forces a line break. You must include a blank space before and after using /N.

ALARM

emit audible alarm from the terminal on the ALERT Detail application

Possible values are

YES: Sound alarm.

NO: Do not sound alarm.

NO is the default.

COLOR|COL

the color in which the ALERT is displayed in the ALERT DETAIL and STATUS applications (overrides default color associated with ALERT priority)

This parameter does not have any impact upon the ALERT OVERVIEW application.

When an ALERT’s priority is increased or decreased (with the ESCALATE parameter), the new ALERT priority’s color will always default to the following list of colors:

CRITICAL(RED)

MAJOR(PINK)

MINOR(YELLOW)

WARNING(DKBLUE)

INFORMATIONAL(LTBLUE)

CLEARING(GREEN)

DISPOSE

allows you to specify whether an ALERT is kept or deleted when it has reached its final escalation priority level

This keyword must be used with the INTERVAL keyword.

Possible values are

KEEP: Keep the ALERT in its queue.

DELETE: Delete the ALERT from the queue.

KEEP is the default.

The variable AMFEDISP returns the value of this keyword.

ESCALATE

allows you to create ALERTs that change in priority over a specified interval of time

This keyword must be used with the INTERVAL keyword.

Possible values are

UP: The ALERT priority is upgraded from less critical to more critical.

DOWN: The ALERT priority is downgraded from more critical to less critical.

UP is the default.

The variable AMFEDIR returns the value of this keyword.

ESCCMD

allows you to specify a command that is issued when the ALERT escalation process has been completed

This keyword must be used with the INTERVAL keyword.

The ESCEXEC and ESCCMD keywords cannot be used together.

The format of the command keyword is as follows: ESCCMD(type,'command')

You can enter blanks or commas between the commands but you must use single quotation marks.

Valid values for the type keyword are as follows

EXEC, BBI, CICS, IMS, IMP, MVS, MQ, NV, TOM

Valid values for the command can be any command of the type specified by the type value;

Example

To use a BBI command to start a VTAM link:

ESCCMD(BBI,'S LINK linkname')

To send a CICS command:

ESCCMD(CICS,'cicstgt:cics_cmd parm1 parm2')

To schedule an EXEC:

ESCCMD(EXEC,'execname parm1 parm2')

When using ESCCMD(type,’EXEC’), the PRI and DLY keywords can be used. For more information about the PRI and DLY keywords, refer to Examples of using ALERT PRI and DLY keywords.

ESCEXEC

allows you to specify an EXEC (with parameters) that is scheduled when the ALERT reaches its final priority level

This keyword must be used with the INTERVAL keyword.

The variable AMFEEXEC returns the value of this keyword.

For more information about the PRI and DLY keywords, refer to Examples of using ALERT PRI and DLY keywords.

EXEC

the name of the ALERT-initiated follow-up EXEC and its parameters

Maximum length is 256 characters.

Refer to Rule-initiated REXX EXECs for more information about parameters passed to ALERT-initiated EXECs.

For more information about the PRI and DLY keywords, refer to Examples of using ALERT PRI and DLY keywords.

FUNCTION|FUN

the function to be performed

Use the FUNCTION keyword with

ADD

COUNT

CREATEQ

DELETE

DELETEQ

LISTQ

READQ

For more information about these functions and the return codes they generate, refer to Table 1.

HELP

the name of an extended help panel

Maximum length is 8 characters.

This help panel is displayed when you enter the EXPAND primary command in the ALERT DETAIL application while the cursor is positioned on the ALERT. The help panel is a text member without any formatting or control characters.

Create a partitioned data set (LRECL FB 80) to contain your help members. Modify your TSCLIST EXEC to insert this data set into the PNLLIB concatenation.

INTERVAL

allows you to specify one to six intervals of time over which the priority of an ALERT will change

An ALERT’s priority can either increase (become more critical) or decrease (become less critical) in priority over the specified time intervals.

The interval can be specified from 0 to 9999 minutes. At least one interval must be specified for an ALERT when ESCALATE is specified.

When the final interval expires:

  • The action specified by the DISPOSE keyword occurs. (The ALERT is deleted or kept.)

  • If an EXEC is specified with the ESCEXEC keyword, the EXEC is scheduled.

This keyword must be used with the ESCALATE keyword and you must specify at least one interval for an ALERT with ESCALATE specified. The variables AMFEINT1 through AMFEINT6 return the values associated with this keyword.

In addition, when you want to have an ALERT change in priority, you must always code one interval more than the number of changes. No priority changes occur in the last interval.

For example, if you want an ALERT to change from MAJOR to CRITICAL, you must code two interval periods.

Refer to Examples of IMFEXEC ALERT escalation for examples.

ORIGIN

a new origin to assign to this ALERT

A 1- to 8-character user-defined origin that is assigned to the ALERT.

The first character cannot be a numeric, The user-defined origin overrides the EXEC's IMFSYSID (or the originating job name for the EXEC).

PCMD

a command to be executed if the terminal operator uses the TRANSFER command on the ALERT DETAIL panel

Any command that is valid from the command line is a valid value for this parameter.

Maximum length is 256 characters.

PCMD is executed as if it were entered on the command line. You should use the SYSTEM parameter (described below) or include the BBI SYSTEM command for ALERTs that contain PCMD to ensure that the target field of the transferred-to application will be correct. If you use the SYSTEM parameter, the SYSTEM command is executed after all other commands specified with PCMD have executed.

Example

PCMD('CICS;EX TRAN;SYSTEM SYSA')

Note that if you have blanks in the PCMD statement, you must use single quotation marks.

POSITION|POS

the order of the ALERT in the queue to read

Valid values are in the range from 1 to 32,767.

This parameter is used only with the READQ function.

PRIORITY

the priority of the ALERT

A valid value is one of the following choices:

CRITICAL(RED)

MAJOR(PINK)

MINOR(YELLOW)

WARNING(DKBLUE)

INFORMATIONAL(LTBLUE)

CLEARING(GREEN)

QUEUE|QUE

the name of the queue to access or into which to place the ALERT

Length can be 1 - 8 characters; embedded blanks are valid.

RETAIN

allows you to specify that an ALERT will be retained across BBI-SS PAS restarts (both cold and warm restarts) and MVS IPLs

Note that using this parameter causes the ALERT to be written to DASD. Therefore, you should use this parameter only after careful consideration. A BBI-SS PAS (warm or cold) start or MVS IPL may eliminate the exceptional situation that caused the ALERT in the first place.

Possible values are

YES: Retain this ALERT in disk space so that it can survive a BBI-SS PAS warm or cold start.

NO: Do not retain this ALERT to survive BBI-SS PAS warm or cold starts.

NO is the default.

ALERTs that specify RETAIN(YES) cannot also specify the INTERVAL keyword.

In other words, ALERTs that are to be retained across BBI-SS PAS restarts or MVS IPLs cannot change priority (either increase or decrease).

The variable AMFRTAIN returns the value of this keyword.

SYSTEM

determines whether the ALERT Detail processor switches the current target to the origin of the ALERT when processing a TRANSFER (PCMD)

The default is yes.

The target is changed to reflect what was coded in the ORIGIN parameter or the MainView AutoOPERATOR SSID.

TARGET

the target to which the ALERT is sent

The ALERT is sent to the subsystem that manages the specified target and exists only in that subsystem.

TEXT

a pattern text string

This parameter applies to only the READQ and COUNT functions. Only ALERTs matching this text string are considered during these operations.

UDATA

any desired user data string

Maximum length is 256 bytes.

The contents of the UDATA field may be retrieved using the READQ function.

USER

the name of a user ID that the ALERT is addressed to

A valid BBI-TS user ID is one to eight characters.

Contents of the user field can be used to tailor ALERT DETAIL displays using the ALERT DETAIL PROFILE panel. Refer to the 'ALERT Management Facility' chapter in the MainView AutoOPERATOR Basic Automation Guide, Volume 2 for more information.

You can use the following keywords with IMFEXEC ALERT keywords when you also have the BMC Impact Integration for z/OS product and have specified PRODUCT=IIZ in BBPARM member BBISSP00.

ALIAS

specifies that when an event is sent to Service Impact Manager (SIM), the Component Alias value is used to match against a specific object in the Service Impact Model

This keyword is the equivalent of specifying the mc_smc_alias slot, or the Component Alias field on the Rule Processor Alert Action(s) III - BiiZ/SIEM panel; it is the Component Alias name.

BIIZJRNL

specifies that MainView AutoOPERATOR writes informational messages to the BBI Journal that describe this ALERT

This keyword is equivalent to the Journal Detail field on the Rule Processor Alert Action(s) III - BiiZ/SIEM panel.

Warning

Setting this keyword to YES might cause a large volume of messages to be sent to the BBI Journal.

You can set a default valueof YES or NO in BBPARM member BBISSP00. When BIIZJRNL=Y is specified in BBISSP00 and the MainView AutoOPERATOR ALERT is being PUBLISHED to a cell, the messages will be written. You can specify IMFEXEC ALERT BIIZJRNL=N to override the default setting for this ALERT.

CLASS

specifies a BMC Impact Manager (BMC IM) event subclass of the default class

This keyword is the same as the Event Class field on the Rule Processor Alert Action(s) III - BiiZ/SIEM panel, and is the name of the variable that contains the event class.

The default class is MV_ALERT. The class must be defined to the BMC IM cell and BMC recommends that it be defined as a subclass of the default class.

PUBLISH

specifies whether an ALERT is published and how it is published to connected BMC IM cell targets and PATROL EM workstations that have subscribed to receive ALERTs through the General Message Exchange (GME)

Possible values are as follows:

REPLACE: An ALERT that replaces the ALERT’s QUEUE and KEY name is sent to all BIM cell targets that have subscribed to receive ALERTs from this MainView AutoOPERATOR BBI-SS PAS.

For PATROL EM workstations, if there is already an ALERT with that QUEUE and KEY name specified on a PATROL EM workstation, the original ALERT is deleted before publishing the new ALERT.

ADD: An ALERT add is sent to all workstations that have subscribed to receive ALERTs from this MainView AutoOPERATOR BBI-SS PAS.

For PATROL EM workstations, if there is already an ALERT with that QUEUE and KEY name on a PATROL EM workstation, it is not deleted before publishing the new ALERT.

ADD is the default.

NO: The ALERT is not written to the connected BIM cell workstations even if they have subscribed to receive ALERTs.

BMC recommends that ALERTs that specify the same QUEUE name and KEY values are always be published with the same value specified for the PUBLISH parameter. For example, if an ALERT is published with PUBLISH(ADD), it should always be published with PUBLISH(ADD).

SLOTSTEM

Specifies the BMC IM cell slot names and slot values in REXX stem variables.

optional

This keyword is the name of the stem variables that contain the slot values.

Specify a stem root name for the REXX stem variable. Two REXX stem variables are used:

  • SLOTNAME

  • SLOTDATA

For example, if SLOTSTEM(MYSTEM) is specified, the variable names will resolve to MYSTEM.SLOTNAME. and MYSTEM.SLOTDATA. In addition, these rules apply:

  • The maximum length of the value that you can specify is 8 characters.

  • The value must conform to standard REXX variable naming rules.

  • Compound REXX stem variables are not supported.

  • A slot name (defined in stemname.SLOTNAME) is limited to a maximum of 32 characters in length.

  • A slot value (defined in stemname.SLOTDATA) is limited to a maximum of 255 characters in length.

TGTPUB

specifies which BMC IM cell targets to publish a MainView ALERT to

optional

Use the TGTPUB keyword to enter the TGTNAME that you have specified on the TGTNAME parameter in BBPARM member AAOGMExx. Do not use a BMC IM cell name.

The TGTPUB keyword is not required if you want to specify that the ALERT will be published to all connected BIM cells.

The TGTPUB keyword is not valid for PATROL EM workstations.

In addition, consider the following information:

  • TGTPUB keyword is only valid when used with FUNCTION(ADD).

  • When FUNCTION(DELETE) is specified, the delete command is sent only to BIM cells to which the ALERT was previously PUBLISHED.

  • DELETEQ commands are be sent to all cells.

  • You can specify multiple target names (TGTNAMEs) and wildcards are supported in the target names.

BMC recommends that ALERTs that specify the same QUEUE name and KEY values are always be published to the same BIM cell targets.


Was this page helpful? Yes No Submitting... Thank you

Comments