403 lines
14 KiB
HTML
403 lines
14 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 Problem Selection Entry (CHGPRBSLTE)</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="CHGPRBSLTE.Top_Of_Page"></a>
|
|
<h2>Change Problem Selection Entry (CHGPRBSLTE)</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="#CHGPRBSLTE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGPRBSLTE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGPRBSLTE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGPRBSLTE"></a>
|
|
<p>The Change Problem Selection Entry (CHGPRBSLTE) command is used to change a problem selection entry that was added using the Add Problem Selection Entry (ADDPRBSLTE) command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPRBSLTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGPRBSLTE.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="#CHGPRBSLTE.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="#CHGPRBSLTE.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="#CHGPRBSLTE.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">
|
|
*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, *NL, *LE, *NG, *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="#CHGPRBSLTE.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="#CHGPRBSLTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGPRBSLTE.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="#CHGPRBSLTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGPRBSLTE.SEQNBR"></a>
|
|
<h3>Sequence number (SEQNBR)</h3>
|
|
<p>Specifies the sequence number of the problem selection entry. Selection entries in a filter are numbered by sequence number. When a filter is applied, the selection entries with lower sequence numbers are tried first.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>Change the default selection entry. This entry is automatically added when the filter is created.
|
|
</dd>
|
|
<dt><b><i>sequence-number</i></b></dt>
|
|
<dd>Specify a number between 1 and 9999.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPRBSLTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGPRBSLTE.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>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<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>*ORGCPNAME</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> values 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="#CHGPRBSLTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGPRBSLTE.GROUP"></a>
|
|
<h3>Group (GROUP)</h3>
|
|
<p>Specifies the group to which a problem is assigned if it 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 problem 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="#CHGPRBSLTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGPRBSLTE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGPRBSLTE FILTER(MYLIB/MYFILT) SEQNBR(1250)
|
|
SELECT((*IF *SEV *EQ 1) (*OR *SEV *EQ 2))
|
|
GROUP(SEVHIGH)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the problem selection entry with the sequence number 1250 in filter MYFILT located in library MYLIB. If the severity level equals 1 or 2, it is put in group SEVHIGH.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPRBSLTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGPRBSLTE.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 &2 in &1 type *&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>CPF91DC</b></dt>
|
|
<dd>Selection entry with sequence number &4 not found.
|
|
</dd>
|
|
<dt><b>CPF91DE</b></dt>
|
|
<dd>Filter &1/&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 &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 &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 &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF9803</b></dt>
|
|
<dd>Cannot allocate object &2 in library &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="#CHGPRBSLTE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|