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

512 lines
19 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>Add Problem Selection Entry (ADDPRBSLTE)</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="ADDPRBSLTE.Top_Of_Page"></a>
<h2>Add Problem Selection Entry (ADDPRBSLTE)</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="#ADDPRBSLTE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDPRBSLTE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDPRBSLTE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDPRBSLTE"></a>
<p>The Add Problem Selection Entry (ADDPRBSLTE) command allows you to define selection criteria that categorize a group of problem log entries. You can add a problem log selection entry to a problem log filter that was created using the Create Filter (CRTFTR) command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDPRBSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDPRBSLTE.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="#ADDPRBSLTE.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="#ADDPRBSLTE.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">
*EVENT, *ORIGIN, *ORGNETID, *ORGCPNAM, *RCVNETID, *RCVCPNAM, *PROBTYPE, *SEV, *MSGID, *ORGHDW, *RSCHDW, *RSCSFW</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="#ADDPRBSLTE.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="#ADDPRBSLTE.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="#ADDPRBSLTE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDPRBSLTE.FILTER"></a>
<h3>Filter (FILTER)</h3>
<p>Specifies the name of the filter.
</p>
<p>This is a required parameter.
</p>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the library list for the current thread 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>library-name</i></b></dt>
<dd>Specify the name of the library where the filter is located.
</dd>
</dl>
<dl>
<dt><b><i>problem-log-filter-name</i></b></dt>
<dd>Specify the name of the filter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDPRBSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDPRBSLTE.SELECT"></a>
<h3>Selection data (SELECT)</h3>
<p>Specifies that a problem log entry is selected or not selected based on whether information in the problem log entry satisfies a specified relationship.
</p>
<p>You can specify a single value (*ANY) or all four elements that define a relationship. When you specify the four elements, the attribute and attribute value are compared for the relationship specified by the relational operator.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*ANY</b></dt>
<dd>Any problem log entry is selected.
</dd>
</dl>
<p>The possible <b>Logical Operator</b> values are:
</p>
<dl>
<dt><b>*IF</b></dt>
<dd>The specified relationship must be satisfied for a problem log entry to be selected.
</dd>
<dt><b>*AND</b></dt>
<dd>The specified relationship must be satisfied in addition to the *IF relationship for a problem log entry to be selected.
</dd>
<dt><b>*OR</b></dt>
<dd>The specified relationship must be satisfied in addition to or instead of the *IF relationship for a problem log entry to be selected.
</dd>
</dl>
<p>The possible <b>Attribute</b> values are:
</p>
<dl>
<dt><b>*EVENT</b></dt>
<dd>The filter is applied when the problem log entry is created (a value of 1), changed (a value of 2), or deleted (a value of 3). If the entry has been created and is changed before being committed, use the value of 1.
</dd>
<dt><b>*ORIGIN</b></dt>
<dd>The problem log entry was locally generated (a value of L) or was received from another system (a value of R).
</dd>
<dt><b>*ORGNETID</b></dt>
<dd>The network identifier (ID) of the system in which the problem log entry originated is specified. This information is displayed using the Work with Problems (WRKPRB) command which shows the details for a specific problem. Specify the value in the following form:
<p>
<pre>
'nnnnnnnnnn'
</pre>
</p>
</dd>
<dt><b>*ORGCPNAM</b></dt>
<dd>The control point name of the system in which the problem log entry originated is specified. This information is displayed using the Work with Problems (WRKPRB) command which shows the details for a specific problem. Specify the value in the following form:
<p>
<pre>
'cccccccccc'
</pre>
</p>
</dd>
<dt><b>*RCVNETID</b></dt>
<dd>The network identifier of the remote system from which the problem log entry was received is specified. This information is displayed using the Work with Problems (WRKPRB) command which shows the details for a specific problem. Specify the value on the following form:
<p>
<pre>
'nnnnnnnnnn'
</pre>
</p>
</dd>
<dt><b>*RCVCPNAM</b></dt>
<dd>This attribute specifies the Remote System Control Point name in which the problem log entry received from. This information is displayed using the Work with Problems (WRKPRB) command and shows the details for a specific problem. The value specified for this attribute should be of the following form:
<p>
<pre>
'cccccccccc'
</pre>
</p>
</dd>
<dt><b>*PROBTYPE</b></dt>
<dd>The type of problem entry created. Possible problems are machine-detected (a value of 1), user-detected (a value of 2), PTF order (a value of 3), application-detected (a value of 4), Client machine-detected (a value of 5), or Client user-detected (a value of 6).
<p>
<b>Note: </b>User-Detected Remote Hardware problems are grouped with number 2 User-Detected problems.
</p>
</dd>
<dt><b>*SEV</b></dt>
<dd>The severity of the problem log entry created. Possible choices are high (a value of 1), medium (a value of 2), low (a value of 3), none (a value of 4), or not assigned (a value of 5).
<p>
<b>Note: </b>Problems do not have a severity level when locally created.
</p>
</dd>
<dt><b>*MSGID</b></dt>
<dd>The message ID found in the problem log entry. This is usually an AS/400 message ID from an AS/400 system.
</dd>
<dt><b>*ORGHDW</b></dt>
<dd>The origin hardware resource information in the problem log entry. This information is displayed using the Work with Problems (WRKPRB) command and shows the details for a specific problem. Specify the value in the following form:
<p>
<pre>
'tttt mmm ss-sssssss'
'tttt mmm ss-sssss'
'tttt mmm sssssss'
'tttt mmm sssss'
</pre>
</p>
<p>where tttt is the machine type, mmm is the model number and sssssssss is the serial number. Use this exact format to match a particular hardware resource exactly, or use a part of the hardware value with the Contains (*CT) relation to provide a partial match.
</p>
</dd>
<dt><b>*RSCHDW</b></dt>
<dd>The failing hardware resource information in the problem log entry. This information is displayed using the Work with Problems (WRKPRB) command and shows the details for a specific problem. Specify the value in the following form:
<p>
<pre>
'tttt mmm ss-sssssss'
'tttt mmm ss-sssss'
'tttt mmm sssssss'
'tttt mmm sssss'
</pre>
</p>
<p>where tttt is the machine type, mmm is the model number and sssssssss is the serial number. Use this exact format to match a particular hardware resource exactly, or use a part of the hardware value with the Contains (*CT) relation to provide a partial match.
</p>
</dd>
<dt><b>*RSCSFW</b></dt>
<dd>The failing software resource information in the problem log entry. This information is displayed using the Work with Problems (WRKPRB) command and shows the details for a specific problem. Specify the value in the following form:
<p>
<pre>
'ppppppp vv rr mm'
</pre>
</p>
<p>where ppppppp is the licensed program ID, vv is the version number, rr is the release number, and mm is the modification level. Use this exact format to match a particular software resource exactly, or use a part of the software value with the Contains (*CT) relation to provide a partial match.
</p>
</dd>
</dl>
<p><b>Relational Operator</b> values. The value specified for <b>Attribute</b> value must have the following relationship to the <b>Attribute Values:</b>
</p>
<dl>
<dt><b>*EQ</b></dt>
<dd>Equal to
</dd>
<dt><b>*GT</b></dt>
<dd>Greater than
</dd>
<dt><b>*LT</b></dt>
<dd>Less than
</dd>
<dt><b>*NE</b></dt>
<dd>Not equal to
</dd>
<dt><b>*GE</b></dt>
<dd>Greater than or equal to
</dd>
<dt><b>*LE</b></dt>
<dd>Less than or equal to
</dd>
<dt><b>*CT</b></dt>
<dd>Contains
</dd>
</dl>
<p>The possible <b>Attribute Value</b> values are:
</p>
<dl>
<dt><b><i>attribute-value</i></b></dt>
<dd>Specify a value of up to 30 characters to compare with the contents of the attribute specified for the <b>Attribute</b> value. The value must be specified in character format and must be enclosed in apostrophes if it contains blanks or special characters. 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 selected. If an asterisk is not included with the generic (prefix) value, the system assumes it to be the complete value.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDPRBSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDPRBSLTE.SEQNBR"></a>
<h3>Sequence number (SEQNBR)</h3>
<p>Specifies the sequence number of the problem log selection entry. Selection entries in a filter are numbered by sequence number. When a filter is applied, the selection entries are tested in order of ascending sequence number.
</p>
<dl>
<dt><b><u>*GEN</u></b></dt>
<dd>The system generates the sequence number.
</dd>
<dt><b><i>sequence-number</i></b></dt>
<dd>Specify a number from 1 through 9999.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDPRBSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDPRBSLTE.GROUP"></a>
<h3>Group (GROUP)</h3>
<p>Specifies the group to which a problem log entry is assigned if it matches the criteria specified on the SELECT parameter.
</p>
<dl>
<dt><b><u>*DEFAULT</u></b></dt>
<dd>The problem log entry is assigned to the default group.
</dd>
<dt><b><i>group-name</i></b></dt>
<dd>Specify a group name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDPRBSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDPRBSLTE.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Adding a Selection Entry</b>
</p>
<p>
<pre>
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *EVENT *EQ 1) (*AND *SEV *EQ 1))
SEQNBR(*GEN) GROUP(HIGHPROB)
</pre>
</p>
<p>This command adds an entry to the filter PROBFILTER in library PROBLIB. Any problems that have been created and are of severity 1 are assigned to group HIGHPROB.
</p>
<p><b>Example 2: Assigning Entries by Origin System Network ID</b>
</p>
<p>
<pre>
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *ORGNETID *EQ 'IOWA')) SEQNBR(*GEN)
GROUP(IOWA)
</pre>
</p>
<p>This command assigns any problems with a origin system network ID of IOWA to group IOWA.
</p>
<p><b>Example 3: Assigning Entries by Problems for Messages</b>
</p>
<p>
<pre>
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *MSGID *EQ 'CPF89*')) SEQNBR(*GEN)
GROUP(MSGCPF89)
</pre>
</p>
<p>This command assigns any problems for message CPF8901, CPF8902, and so on, to group MSGCPF89.
</p>
<p><b>Example 4: Assigning Entries by Hardware Problems</b>
</p>
<p>
<pre>
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *RSCHDW *CT 9404)
(*OR *RSCHDW *CT 9406)
(*OR *RSCHDW *CT 9402))
SEQNBR(*GEN) GROUP(AS400USER)
</pre>
</p>
<p>All problems for iSeries hardware (the hardware resource information <u> containing</u> machine type 9402, 9404 or 9406) are assigned to group AS400USER.
</p>
<p>Caution must be taken when using the contains operation. In this example if the sending machine had a serial number containing 9402, 9404, or 9406 it would also match this selection entry even if the machine type was not 9402, 9404, or 9406. A better example follows.
</p>
<p><b>Example 5: Assigning Entries by Hardware Problems</b>
</p>
<p>
<pre>
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *RSCHDW *EQ 9404*)
(*OR *RSCHDW *EQ 9406*)
(*OR *RSCHDW *EQ 9402*))
SEQNBR(*GEN) GROUP(AS400USER)
</pre>
</p>
<p>This command assigns all problems for iSeries 400 hardware (the hardware resource information <u> equals</u> machine type 9402, 9404 or 9406) to group AS400USER.
</p>
<p>This is a better way to select on the sending hardware machine type. Only those machines with types of 9402, 9404, or 9406 will result in a match.
</p>
<p><b>Example 6: Assigning Entries by Machine-detected Problems</b>
</p>
<p>
<pre>
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *PROBTYPE *EQ 1))
SEQNBR(*GEN) GROUP(MACHDETECT)
</pre>
</p>
<p>This command assigns any problems that are machine-detected to group MACHDETECT.
</p>
<p><b>Example 7: Assigning Entries by Product-specific Problems</b>
</p>
<p>
<pre>
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *RSCSFW *EQ '5716SS1 03 06 00'))
SEQNBR(15) GROUP(OS400V3R6)
</pre>
</p>
<p>This command assigns any problems that are specifically for Operating System Version 3 Release 6 Modification 0 to group OS400V3R6. Notice that this entry is placed after entry number 10 in the filter, since 15 is specified as the sequence number.
</p>
<p><b>Example 8: Assigning Entries by Matching Products</b>
</p>
<p>
<pre>
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *RSCSFW *EQ '5716SS1*'))
SEQNBR(25) GROUP(OS400)
</pre>
</p>
<p>This selection entry matches Version 3 Release 6 of the Operating System licensed program.
</p>
<p><b>Notes:</b>
</p>
<ol>
<li>The order of selection entries within a filter is important. When the filter is applied to the problem log entry, the selection entries are examined from the <u> first</u> entry to the <u> last</u> entry in ascending order. The <u> first</u> selection entry that matches a problem is used. To ensure correct operation the most specific selection entries should be first, and the least specific selection entries last.
</li>
<li>If the selection entries are not order specific (i.e. each selection entry matches one and only one problem) then the most likely or the most common should be placed first. This will ensure the best performance as fewer selection entries will need to be checked.
</li>
<li>If no selection entries result in a match when a filter is applied, then the *LAST selection entry is used to assign a group. The *LAST selection entry is automatically added to the filter when it is created. The SELECT parameter for the *LAST selection entry is *ANY, which will always result in a match.
</li>
<li>The *AND logical operator takes precedence over the *OR logical operator within a selection entry. Therefore, the following SELECT specification:
<p>
<pre>
((*IF *PROBTYPE *EQ 1) (*AND *SEV *EQ 1)
(*OR *PROBTYPE *EQ 2) (*AND *SEV *EQ 1))
</pre>
</p>
<p>is equivalent to the following Boolean expression:
</p>
<p>
<pre>
if ((*PROBTYPE = 1) and (*SEV = 1)) or
((*PROBTYPE = 2) and (*SEV = 1))
</pre>
</p>
</li>
<li>All attribute values are interpreted as character data, including numbers. When the problem filter is applied to a problem, the system converts all of the data in the filter to the type given in the problem template and compared. Message IDs are considered character data and are ordered as such.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDPRBSLTE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDPRBSLTE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<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>CPF7A82</b></dt>
<dd>Error occurred while applying the problem filter.
</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>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDPRBSLTE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>