ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/chgalrslte.htm

417 lines
18 KiB
HTML

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Change Alert Selection Entry (CHGALRSLTE)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="CHGALRSLTE.Top_Of_Page"></a>
<h2>Change Alert Selection Entry (CHGALRSLTE)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#CHGALRSLTE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGALRSLTE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGALRSLTE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGALRSLTE"></a>
<p>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, SC41-5413.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGALRSLTE.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGALRSLTE.FILTER"><b>FILTER</b></a></td>
<td valign="top">Filter</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Filter</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CHGALRSLTE.SEQNBR"><b>SEQNBR</b></a></td>
<td valign="top">Sequence number</td>
<td valign="top">1-9999, *LAST</td>
<td valign="top">Required, Key, Positional 2</td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#CHGALRSLTE.SELECT"><b>SELECT</b></a></td>
<td valign="top">Selection data</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *ANY<br>Other values (up to 10 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Relationship</td>
<td valign="top">
*IF, *AND, *OR</td>
</tr>
<tr>
<td valign="top">Element 2: Attribute</td>
<td valign="top">
*ORIGIN, *RSCNAME, *RSCTYPE, *HIERNAME, *HIERTYPE, *MSGID, *MSGSEV, *ALRID, *ALRTYPE, *ALRDSC, *PBLCSE, *USRCSE, *INSCSE, *FLRCSE, *RSCHDW, *SNDHDW, *RSCSFW, *SNDSFW</td>
</tr>
<tr>
<td valign="top">Element 3: Relational operator</td>
<td valign="top">
*EQ, *GT, *LT, *NE, *GE, *LE, *CT</td>
</tr>
<tr>
<td valign="top">Element 4: Value</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top"><a href="#CHGALRSLTE.GROUP"><b>GROUP</b></a></td>
<td valign="top">Group</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *DEFAULT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGALRSLTE.FILTER"></a>
<h3>Filter (FILTER)</h3>
<p>Specifies the qualified name of the filter in which the selection entry being changed.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Filter</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the filter.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
</dl>
<dl>
<dt><b>*CURLIB</b></dt>
<dd>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.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the filter is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGALRSLTE.SEQNBR"></a>
<h3>Sequence number (SEQNBR)</h3>
<p>Specifies the sequence number of the alert selection entry. Selection entries are evaluated in order by sequence number.
</p>
<dl>
<dt><b><u>*LAST</u></b></dt>
<dd>Allows the user to change the last selection. This entry is added automatically when the filter is created and will match any alert.
</dd>
<dt><b><i>1-9999</i></b></dt>
<dd>Specify the sequence number to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGALRSLTE.SELECT"></a>
<h3>Selection data (SELECT)</h3>
<p>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.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*ANY</b></dt>
<dd>Any alert matches this selection record.
</dd>
</dl>
<p><b>Other values (up to 10 repetitions)</b>
</p>
<p>Specify the conditions under which an alert matches the selection entry. Each condition must contain the following four elements:
</p>
<ol>
<li>One of the logical operators *IF, *AND, or *OR
</li>
<li>The attribute compared
</li>
<li>One of the relational operators
</li>
<li>The attribute value
</li>
</ol>
<p><b>Element 1: Relationship</b>
</p>
<dl>
<dt><b>*IF</b></dt>
<dd>Identifies the first condition that must be satisfied.
</dd>
<dt><b>*AND</b></dt>
<dd>The conditions on both sides of the *AND must be satisfied.
</dd>
<dt><b>*OR</b></dt>
<dd>One of the conditions on each side of the *OR must be satisfied.
<p>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.
</p>
</dd>
</dl>
<p><b>Element 2: Attribute</b>
</p>
<dl>
<dt><b>*ORIGIN</b></dt>
<dd>Specifies whether the alert is generated or received. The valid values for this attribute are L (Locally generated) or R (Received).
</dd>
<dt><b>*RSCNAME</b></dt>
<dd>Specifies the name of the failing resource. The value for this attribute must be a 8-character name.
</dd>
<dt><b>*RSCTYPE</b></dt>
<dd>Specifies the type of the failing resource. The value for this attribute must be a 3-character resource type (for example, TAP or DKT).
</dd>
<dt><b>*HIERNAME</b></dt>
<dd>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.
</dd>
<dt><b>*HIERTYPE</b></dt>
<dd>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.
</dd>
<dt><b>*MSGID</b></dt>
<dd>Specifies the message identifier.
</dd>
<dt><b>*MSGSEV</b></dt>
<dd>Specifies the message severity. This value, 00 through 99, represents the severity level of the message (99 is the highest severity level).
</dd>
<dt><b>*ALRID</b></dt>
<dd>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 alerts created after problem analysis.
</dd>
<dt><b>*ALRTYPE</b></dt>
<dd>Specifies the alert type code point that is in the alert. The value for this attribute is a 2 digit hexadecimal number.
</dd>
<dt><b>*ALRDSC</b></dt>
<dd>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.
</dd>
<dt><b>*PBLCSE</b></dt>
<dd>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.
</dd>
<dt><b>*USRCSE</b></dt>
<dd>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.
</dd>
<dt><b>*INSCSE</b></dt>
<dd>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.
</dd>
<dt><b>*FLRCSE</b></dt>
<dd>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.
</dd>
<dt><b>*RSCHDW</b></dt>
<dd>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:
<p>
<pre>
'tttt mmm ss-sssssss'
'tttt mmm ss-sssss'
'tttt mmm sssssss'
'tttt mmm sssss'
</pre>
</p>
<p>where <i>tttt</i> is the machine type, <i>mmm</i> is the model number, and <i>sssssssss</i> 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.
</p>
</dd>
<dt><b>*SNDHDW</b></dt>
<dd>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:
<p>
<pre>
'tttt mmm ss-sssssss'
'tttt mmm ss-sssss'
'tttt mmm sssssss'
'tttt mmm sssss'
</pre>
</p>
<p>where <i>tttt</i> is the machine type, <i>mmm</i> is the model number, and <i>sssssssss</i> 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.
</p>
</dd>
<dt><b>*RSCSFW</b></dt>
<dd>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:
<p>
<pre>
'ppppppp vv rr mm'
</pre>
</p>
<p>where <i>ppppppp</i> is the licensed program identifier, <i>vv</i> is the version number, <i>rr</i> is the release number, and <i>mm</i> 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.
</p>
</dd>
<dt><b>*SNDSFW</b></dt>
<dd>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:
<p>
<pre>
'ppppppp vv rr mm'
</pre>
</p>
<p>where <i>ppppppp</i> is the licensed program identifier, <i>vv</i> is the version number, <i>rr</i> is the release number, and <i>mm</i> 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.
</p>
</dd>
</dl>
<p><b>Element 3: Relational operator</b>
</p>
<dl>
<dt><b>*EQ</b></dt>
<dd>The attribute in <b>Attribute</b> must be equal to the value specified in <b>Attribute Value</b>.
</dd>
<dt><b>*GT</b></dt>
<dd>The attribute in <b>Attribute</b> must be greater than the value specified in <b>Attribute Value</b>.
</dd>
<dt><b>*LT</b></dt>
<dd>The attribute in <b>Attribute</b> must be less than the value specified in <b>Attribute Value</b>.
</dd>
<dt><b>*NE</b></dt>
<dd>The attribute in <b>Attribute</b> must not be equal to the value specified in <b>Attribute Value</b>.
</dd>
<dt><b>*GE</b></dt>
<dd>The attribute in <b>Attribute</b> must be greater than or equal to the value specified in <b>Attribute Value</b>.
</dd>
<dt><b>*LE</b></dt>
<dd>The attribute in <b>Attribute</b> must be less than or equal to the value specified in <b>Attribute Value</b>.
</dd>
<dt><b>*CT</b></dt>
<dd>The attribute in <b>Attribute</b> must contain the value specified in <b>Attribute Value</b>.
</dd>
</dl>
<p><b>Element 4: Value</b>
</p>
<dl>
<dt><b><i>attribute-value</i></b></dt>
<dd>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.
</dd>
<dt><b><i>generic*-attribute-value</i></b></dt>
<dd>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.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGALRSLTE.GROUP"></a>
<h3>Group (GROUP)</h3>
<p>Specifies the group that an alert is assigned to if the alert matches the criteria specified on the SELECT parameter.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*DEFAULT</b></dt>
<dd>The alert is assigned to the *DEFAULT group. The *DEFAULT group is added automatically when a filter is created.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify a group name to which the alert is assigned.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGALRSLTE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGALRSLTE FILTER(MYLIB/MYFILTER) SEQNBR(10)
SELECT(*SAME) GROUP(NEWSTUFF)
</pre>
</p>
<p>This command changes the GROUP to NEWSTUFF for selection entry 10 in the filter MYFILTER in library MYLIB.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGALRSLTE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPD91CB</b></dt>
<dd>*CT not allowed with numeric values.
</dd>
<dt><b>CPF2150</b></dt>
<dd>Object information function failed.
</dd>
<dt><b>CPF2151</b></dt>
<dd>Operation failed for &amp;2 in &amp;1 type *&amp;3.
</dd>
<dt><b>CPF812F</b></dt>
<dd>Filter damaged.
</dd>
<dt><b>CPF91DC</b></dt>
<dd>Selection entry with sequence number &amp;4 not found.
</dd>
<dt><b>CPF91DE</b></dt>
<dd>Filter &amp;1/&amp;2 at maximum size.
</dd>
<dt><b>CPF91DF</b></dt>
<dd>The SELECT keyword cannot be changed for *LAST entry.
</dd>
<dt><b>CPF91EA</b></dt>
<dd>*IF relationship not in correct position.
</dd>
<dt><b>CPF91EB</b></dt>
<dd>Filter type &amp;3 not correct for this operation.
</dd>
<dt><b>CPF91EC</b></dt>
<dd>Internal processing error occurred.
</dd>
<dt><b>CPF91E6</b></dt>
<dd>Generic values only allowed with *EQ or *NE.
</dd>
<dt><b>CPF91E7</b></dt>
<dd>Character in position &amp;4 not valid in value specified.
</dd>
<dt><b>CPF91E8</b></dt>
<dd>Internal processing error occurred.
</dd>
<dt><b>CPF9802</b></dt>
<dd>Not authorized to object &amp;2 in &amp;3.
</dd>
<dt><b>CPF9803</b></dt>
<dd>Cannot allocate object &amp;2 in library &amp;3.
</dd>
<dt><b>CPF9807</b></dt>
<dd>One or more libraries in library list deleted.
</dd>
<dt><b>CPF9808</b></dt>
<dd>Cannot allocate one or more libraries on library list.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>