Add Alert Selection Entry (ADDALRSLTE)

Where allowed to run: All environments (*ALL)
Threadsafe: No

The Add Alert Selection Entry (ADDALRSLTE) command allows the user to add an alert selection entry to an alert filter. Selection entries are the criteria that categorize a group of alerts. More information on alerts is in the Alerts Support book, SC41-5413.

Top

Parameters

Keyword	Description	Choices	Notes
FILTER	Filter	Qualified object name	Required, Positional 1
	Qualifier 1: Filter	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
SELECT	Selection data	Single values: *ANY Other values (up to 10 repetitions): Element list	Required, Positional 2
	Element 1: Relationship	IF, AND, *OR
	Element 2: Attribute	ORIGIN, RSCNAME, RSCTYPE, HIERNAME, HIERTYPE, MSGID, MSGSEV, ALRID, ALRTYPE, ALRDSC, PBLCSE, USRCSE, INSCSE, FLRCSE, RSCHDW, SNDHDW, RSCSFW, SNDSFW
	Element 3: Relational operator	EQ, GT, LT, NE, GE, LE, *CT
	Element 4: Value	Character value
SEQNBR	Sequence number	1-9999, *GEN	Optional
GROUP	Group	Name, *DEFAULT	Optional

Top

Filter (FILTER)

Specifies the filter to be added.

This is a required parameter.

Qualifier 1: Filter

name: Specify the name of the filter.

Qualifier 2: Library

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is used to locate the filter. If no library is specified as the current library for the job, the QGPL library is used.
name: Specify the name of the library where the filter is located.

Top

Selection data (SELECT)

Specifies the comparisons to be made to determine if the alert belongs in the specified group. The selection entry results in a successful match with an alert when the data in the alert satisfies the relationships specified on the SELECT parameter. Up to 10 attribute values can be compared to the alert.

This is a required parameter.

Single values

*ANY: Any alert matches this selection record.

Other values (up to 10 repetitions)

Specify the conditions under which an alert matches the selection entry. Each condition must contain the following four elements:

One of the logical operators *IF, *AND, or *OR
The attribute compared
One of the relational operators
The attribute value

Element 1: Relationship

*IF: Identifies the first condition that must be satisfied.
*AND: The conditions on both sides of the *AND must be satisfied.
*OR: One of the conditions on each side of the *OR must be satisfied.
If there is one set or several sets of conditions, the *IF value must be specified as the first value in the first set of comparison values. If more than one set of conditions are specified, *AND or *OR must be specified as the first value in each set after the first. Each condition must be enclosed in parentheses. *AND is evaluated before *OR.

Element 2: Attribute

*ORIGIN

Specifies whether the alert is generated or received. The valid values for this attribute are L (Locally generated) or R (Received).

*RSCNAME

Specifies the name of the failing resource. The value for this attribute must be a 8-character name.

*RSCTYPE

Specifies the type of the failing resource. The value for this attribute must be a 3-character resource type (for example, TAP or DKT).

*HIERNAME

Specifies all of the resources in the alert resource hierarchy. The alert resource hierarchy is the list of resources, separated by blanks, displayed on the Work with Alerts (WRKALR) command detailed data displays. The value for this attribute can be a list of up to 5 resource names separated by a blank, unless the value is used with the *CT relational operator. If the *CT value is used, the selection relationship can test to see if the given resource name is found anywhere within the hierarchy. This attribute contains the resource names from the hierarchy only.

*HIERTYPE

Specifies all of the resource types in the alert resource hierarchy. The resource types match the resource names specified on the *HIERNAME attribute. The value for this attribute can be a list of up to 5 resource types 1 to 3 characters in length separated by a blank, unless the value is used with the *CT relational operator. If the *CT value is used, the selection relationship can test to see if the given resource type is found anywhere within the hierarchy.

*MSGID

Specifies the message identifier.

*MSGSEV

Specifies the message severity. This value, 00 through 99, represents the severity level of the message (99 is the highest severity level).

*ALRID

Specifies the alert identifier. The alert identifier is displayed on the Work with Alerts (WRKALR) command detailed data display. The value for this attribute must be an 8-digit hexadecimal number unless it is used with the *CT relational operator. If the *CT operator or a wildcard character is used, the attribute must have an even number of digits up to a maximum of 8. The alert ID may not be a valid comparison for alerts created after problem analysis.

*ALRTYPE

Specifies the alert type code point that is in the alert. The value for this attribute is a 2 digit hexadecimal number.

*ALRDSC

Specifies the alert description code point that is in the alert. The value for this attribute must be an 4-digit hexadecimal number unless it is used with the *CT relational operator. If the *CT operator or a wildcard character is used, the attribute must have an even number of digits up to a maximum of 4.

*PBLCSE

Specifies the probable cause code point that is in the alert. The value for this attribute must be an 4-digit hexadecimal number unless it is used with the *CT relational operator. If the *CT operator or a wildcard character is used, the attribute must have an even number of digits up to a maximum of 4.

*USRCSE

Specifies the first user cause code point that is in the alert. The value for this attribute must be an 4-digit hexadecimal number unless it is used with the *CT relational operator. If the *CT operator or a wildcard character is used, the attribute must have an even number of digits up to a maximum of 4.

*INSCSE

Specifies the first install cause code point that is in the alert. The value for this attribute must be an 4-digit hexadecimal number unless it is used with the *CT relational operator. If the *CT operator or a wildcard character is used, the attribute must have an even number of digits up to a maximum of 4.

*FLRCSE

Specifies the first failure cause code point that is in the alert. The value for this attribute must be an 4-digit hexadecimal number unless it is used with the *CT relational operator. If the *CT operator or a wildcard character is used, the attribute must have an even number of digits up to a maximum of 4.

*RSCHDW

Specifies the failing hardware resource information in the alert. This information is displayed on the Work with Alerts (WRKALR) command detailed data displays. Specify a value for this attribute using the following form:

'tttt mmm ss-sssssss'
'tttt mmm ss-sssss'
'tttt mmm sssssss'
'tttt mmm sssss'

where tttt is the machine type, mmm is the model number, and sssssssss is the serial number. Use this format to match a particular hardware resource or use a part of the hardware value with the *CT relational operator to provide a partial match.

*SNDHDW

Specifies the sending hardware resource information in the alert. This information is displayed on the Work with Alerts (WRKALR) command detailed data displays. Specify a value for this attribute using the following form:

'tttt mmm ss-sssssss'
'tttt mmm ss-sssss'
'tttt mmm sssssss'
'tttt mmm sssss'

*RSCSFW

Specifies the failing software resource information in the alert. This information is displayed on the Work with Alerts (WRKALR) command detailed data displays. Specify a value for this attribute using the following form:

'ppppppp vv rr mm'

where ppppppp is the licensed program identifier, vv is the version number, rr is the release number, and mm is the modification level. Use this format to match a particular software resource or use a part of the software value with the *CT relational operator to provide a partial match.

*SNDSFW

Specifies the sending software resource information in the alert. This information is displayed on the Work with Alerts (WRKALR) command detailed data displays. Specify a value for this attribute using the following form:

'ppppppp vv rr mm'

Element 3: Relational operator

*EQ: The attribute in Attribute must be equal to the value specified in Attribute Value.
*GT: The attribute in Attribute must be greater than the value specified in Attribute Value.
*LT: The attribute in Attribute must be less than the value specified in Attribute Value.
*NE: The attribute in Attribute must not be equal to the value specified in Attribute Value.
*GE: The attribute in Attribute must be greater than or equal to the value specified in Attribute Value.
*LE: The attribute in Attribute must be less than or equal to the value specified in Attribute Value.
*CT: The attribute in Attribute must contain the value specified in Attribute Value.

Element 4: Value

attribute-value: Specify the value (a maximum of 60 characters) to be compared with the contents of the specified attribute. The value must be specified in apostrophes if it contains blanks or special characters and must be in character format. If a CL variable is specified for the value, it must be a character variable.
generic*-attribute-value: Specify the generic attribute value. A generic value is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If a generic name is specified, all values that begin with the generic value are matches. If an asterisk is not included with the generic (prefix) value, the system assumes it to be the complete value. Generic attribute values are only allowed with the *EQ and *NE operator.

Top

Sequence number (SEQNBR)

Specifies the sequence number of the alert selection entry. Selection entries are evaluated in order by sequence number.

*GEN: Allows the system to generate the sequence number. The sequence number will be greater than all previous selection entries.
1-9999: Specify the sequence number to be used.

Top

Group (GROUP)

Specifies the group that an alert is assigned to if the alert matches the criteria specified on the SELECT parameter.

*DEFAULT: The alert is assigned to the *DEFAULT group. The *DEFAULT group is added automatically when a filter is created.
name: Specify a group name to which the alert is assigned.

Top

Examples

ADDALRSLTE   FILTER(MYLIB/MYFILTER)
             SELECT((*IF *RSCNAME *EQ CHICAGO1)
                    (*AND *RSCTYPE *EQ CP))
             SEQNBR(*GEN)  GROUP(CHICAGO)

This command adds selection entry 0010 to the filter MYFILTER in library MYLIB (a 0010 is generated because no entries have been added to the filter). Any alerts that have a resource name of 'CHICAGO1' and a resource type of 'CP' (control point) are assigned to group CHICAGO.

Top

Error messages

*ESCAPE Messages

CPD91CB: *CT not allowed with numeric values.
CPF2150: Object information function failed.
CPF2151: Operation failed for &2 in &1 type *&3.
CPF812F: Filter damaged.
CPF91DA: Sequence number &4 already exists.
CPF91DE: Filter &1/&2 at maximum size.
CPF91D9: Sequence number cannot be automatically created.
CPF91EA: *IF relationship not in correct position.
CPF91EB: Filter type &3 not correct for this operation.
CPF91EC: Internal processing error occurred.
CPF91E6: Generic values only allowed with *EQ or *NE.
CPF91E7: Character in position &4 not valid in value specified.
CPF91E8: Internal processing error occurred.
CPF9802: Not authorized to object &2 in &3.
CPF9803: Cannot allocate object &2 in library &3.
CPF9807: One or more libraries in library list deleted.
CPF9808: Cannot allocate one or more libraries on library list.
CPF9830: Cannot assign library &1.

Top