Previous Topic

Next Topic

Book Contents

Book Index

ON MESSAGE: Message/Event Selection Parameter

Specifies the message whose detection triggers execution of the rule.

Figure 208 ON MESSAGE Parameter Format

Optional. Type MESSAGE (or its abbreviation M) in the ON field and press Enter. The subparameters shown in Table 161 are displayed.

Table 161 ON MESSAGE Subparameters

Subparameter

Description

message

Message identifier (from 1 through 10 characters in length). Mask characters (* and ?) can be specified in this field. Mandatory.

JNAME

Name of the job (or mask) that issued the message. It must be a valid job name of 1-8 characters. Optional.

If JNAME is specified, only messages issued from the specified JNAME will trigger the rule.

JTYPE

Type of the job from which the message originated. Optional. Valid values are:

  • J–Batch job (JOB)
  • S–Started task (STC)
  • T–TSO user (TSU)

If JTYPE is specified, only messages issued from a job of the specified type will trigger the rule.

SMFID

SMF ID of the CPU that issued the message. Optional.

SYSTEM

Name of the system where the message was sent. Mask characters (* and ?) are supported. Optional.

USERID

ID of the address space that created the event.

ROUTE

Routing code (a value from 0 through 128) to be used as selection criteria. Optional.

DESC

Descriptor code (a value from 0 through 16) to be used as selection criteria. Optional.

CONSOLEID

Console identification used as a selection criteria; only messages issued to the specified console will trigger the rule. Optional.

CONSOLE

Name of the console where the message was displayed. Mask characters (* and ?) are supported.

APPEARED n TIMES IN m MINUTES

Number of times (n = 2 through 999) the message must occur within a specified number of minutes (m = 1 through 9999) before Control-O triggers the rule.

And/Or/Not

Conjunctional subparameter that permits linking of ON statements.

Valid values are:

  • A (And) – Both statements must be satisfied.
  • O (Or) – Only one statement need be satisfied.
  • N (Not) – The condition in the following statement must not be satisfied.

For detailed information on this subparameter, see General Information.

Parent Topic

Rule Parameters