book.
CHGALRSLTE Command syntax diagram
The Change Alert Selection Entry (CHGALRSLTE) command allows the user to
change an alert selection entry that was added previously using the Add Alert
Selection Entry (ADDALRSLTE) command. More information on alerts is in the Alerts Support book.
The name of the filter can be qualified by one of the following library values:
*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 searched. If no library is specified as the current library for the job, the QGPL library is used.
library-name: Specify the name of the library to be searched.
filter-name: Specify the name of the filter.
*LAST: Allows the user to change the last selection. This entry is added automatically when the filter is created and will match any alert.
sequence-number: Specify a number from 1 through 9999.
*SAME: The value does not change.
*ANY: Any alert matches this selection record. Specify the conditions under which an alert matches the selection entry. Each condition must contain the following four elements:
Element 1: Logical Operator
*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 relation 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 relation 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 iSeries 400 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'
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.
*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'
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.
Element 3: Relational Operator
*EQ: The attribute in element 2 must be equal to the value specified in element 4.
*GT: The attribute in element 2 must be greater than the value specified in element 4.
*LT: The attribute in element 2 must be less than the value specified in element 4.
*NE: The attribute in element 2 must not be equal to the value specified in element 4.
*GE: The attribute in element 2 must be greater than or equal to the value specified in element 4.
*LE: The attribute in element 2 must be less than or equal to the value specified in element 4. equal to the value specified in element 4.
*CT: The attribute in element 2 must contain the value specified in element 4.
Element 4: Attribute 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 name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk (*) substitutes for any valid characters. A generic name specifies all attributes with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete attribute name. If the complete attribute name is specified, and multiple libraries are searched, multiple attributes can be changed only if *ALL or *ALLUSR library values can be specified for the name. See generic names for additional information.
*SAME:
*DEFAULT: The alert is assigned to the *DEFAULT group. The *DEFAULT group is automatically added when a filter is created.
group-name: Specify a group name to which the alert is assigned.
Example for CHGALRSLTE
CHGALRSLTE FILTER(MYLIB/MYFILTER) SEQNBR(10) SELECT(*SAME) GROUP(NEWSTUFF)
Error messages for CHGALRSLTE
*ESCAPE Messages