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

418 lines
18 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Add Alert Selection Entry (ADDALRSLTE)</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="ADDALRSLTE.Top_Of_Page"></a>
<h2>Add Alert Selection Entry (ADDALRSLTE)</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="#ADDALRSLTE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDALRSLTE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDALRSLTE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDALRSLTE"></a>
<p>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.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDALRSLTE.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="#ADDALRSLTE.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, 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" rowspan="5"><a href="#ADDALRSLTE.SELECT"><b>SELECT</b></a></td>
<td valign="top">Selection data</td>
<td valign="top">Single values: *ANY<br>Other values (up to 10 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="5">Required, Positional 2</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="#ADDALRSLTE.SEQNBR"><b>SEQNBR</b></a></td>
<td valign="top">Sequence number</td>
<td valign="top">1-9999, <b><u>*GEN</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDALRSLTE.GROUP"><b>GROUP</b></a></td>
<td valign="top">Group</td>
<td valign="top"><i>Name</i>, <b><u>*DEFAULT</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ADDALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDALRSLTE.FILTER"></a>
<h3>Filter (FILTER)</h3>
<p>Specifies the filter to be added.
</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="#ADDALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDALRSLTE.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>This is a required parameter.
</p>
<p><b>Single values</b>
</p>
<dl>
<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="#ADDALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDALRSLTE.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>*GEN</u></b></dt>
<dd>Allows the system to generate the sequence number. The sequence number will be greater than all previous selection entries.
</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="#ADDALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDALRSLTE.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>*DEFAULT</u></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="#ADDALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDALRSLTE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
ADDALRSLTE FILTER(MYLIB/MYFILTER)
SELECT((*IF *RSCNAME *EQ CHICAGO1)
(*AND *RSCTYPE *EQ CP))
SEQNBR(*GEN) GROUP(CHICAGO)
</pre>
</p>
<p>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.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDALRSLTE.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>CPF91DA</b></dt>
<dd>Sequence number &amp;4 already exists.
</dd>
<dt><b>CPF91DE</b></dt>
<dd>Filter &amp;1/&amp;2 at maximum size.
</dd>
<dt><b>CPF91D9</b></dt>
<dd>Sequence number cannot be automatically created.
</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>
<dt><b>CPF9830</b></dt>
<dd>Cannot assign library &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDALRSLTE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>