Previous Topic

Next Topic

Book Contents

Book Index

ON STRING: Message/Event Selection Parameter

Specifies the message text the appearance of which triggers execution of the rule.

Figure 219 ON STRING Parameter Format

Optional. Type STRING (or its abbreviation STR) in the ON field and press Enter. The subparameters described in Table 167 are displayed.

Table 167 ON STRING Subparameters

Subparameter

Description

string

Message text to be intercepted by Control-O from the first line of the message. Mandatory. A string of from 1 through 47 characters can be specified. Mask characters (* and ?) are supported for this subparameter.

COL

fromcol-tocol – The from and to column range subparameter limits the search for the specified string. The first column (column 1) is the column containing the first character of the message ID. For more information, see "Column Range" in General Information.

JNAME

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

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

JTYPE

Type of the job from which the message (containing the specified string) originated. Optional. Valid values are:

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

If JTYPE is specified, only messages containing the specified string 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.

USERID

ID of the address space that created the event.

ROUTE

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

DESC

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

CONSOLEID

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

CONSOLE

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

APPEARED n TIMES IN m MINUTES

Number of times (n = 2 through 999) the string 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