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

281 lines
8.8 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 Action Entry (CHGPRBACNE)</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="CHGPRBACNE.Top_Of_Page"></a>
<h2>Change Problem Action Entry (CHGPRBACNE)</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="#CHGPRBACNE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGPRBACNE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGPRBACNE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGPRBACNE"></a>
<p>The Change Problem Action Entry (CHGPRBACNE) command allows you to change a problem action entry that was added using the Add Problem Action Entry (ADDPRBACNE) command. The program QSXVLDAC is used to validate the action entry, and a prompter exit routine is used to fill in the current values.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPRBACNE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGPRBACNE.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="#CHGPRBACNE.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="#CHGPRBACNE.GROUP"><b>GROUP</b></a></td>
<td valign="top">Group</td>
<td valign="top"><i>Name</i>, *DEFAULT</td>
<td valign="top">Required, Key, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CHGPRBACNE.ASNUSER"><b>ASNUSER</b></a></td>
<td valign="top">User assigned</td>
<td valign="top"><i>Simple name</i>, *NOCHG, *NONE, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#CHGPRBACNE.SNDDTAQ"><b>SNDDTAQ</b></a></td>
<td valign="top">Send to data queue</td>
<td valign="top">Single values: *NONE, <b><u>*SAME</u></b><br>Other values (up to 5 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Data queue</td>
<td valign="top">
<i>Qualified object name</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Qualifier 1: Data queue</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top">Element 2: Data queue key</td>
<td valign="top">
<i>Character value</i>, <b><u>*NONE</u></b>, X''</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGPRBACNE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGPRBACNE.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-filter-name</i></b></dt>
<dd>Specify the name of the filter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPRBACNE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPRBACNE.GROUP"></a>
<h3>Group (GROUP)</h3>
<p>Specifies the group for which the actions are to be applied. The group name is assigned from selection criteria from a selection entry in the filter.
</p>
<dl>
<dt><b><u>*DEFAULT</u></b></dt>
<dd>The default specified when the filter was created is used.
</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="#CHGPRBACNE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPRBACNE.ASNUSER"></a>
<h3>User assigned (ASNUSER)</h3>
<p>Specifies the user assigned to the problem log entry.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NOCHG</b></dt>
<dd>No change occurs to the problem log entry.
</dd>
<dt><b>*NONE</b></dt>
<dd>No user is assigned to the problem log entry.
</dd>
<dt><b><i>assigned-user</i></b></dt>
<dd>Specify a user name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPRBACNE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGPRBACNE.SNDDTAQ"></a>
<h3>Send to data queue (SNDDTAQ)</h3>
<p>Specifies the data queue for the problem notification record. Keyed data queues are supported.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No data queue is used.
</dd>
</dl>
<p>The possible <b>Data Queue Name</b> 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 data queue. 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 data queue is located.
</dd>
<dt><b><i>data-queue-name</i></b></dt>
<dd>Specify the name of the data queue.
</dd>
</dl>
<p>The possible <b>Data Queue Key</b> values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No key is used on the data queue.
</dd>
<dt><b><i>data-queue-key</i></b></dt>
<dd>Specify the data queue key.
</dd>
</dl>
<p>An 80-byte record is enqueued on the data queue specified by the user. This record is received when the QRCVDTAQ program is called. The data queue does not have to be used solely for problems; alerts and problems can share the same data queue.
</p>
<p>If a key is specified, it is used when enqueueing the record on the queue. If the data queue is non-keyed, the record is enqueued without a key.
</p>
<p>
<b>Note: </b>The time stamp used is the system standard time stamp. This time is already stored in the problem record.
</p>
<p>See the table in the SNDDTAQ parameter description for the Add Problem Action Entry (ADDPRBACNE) command for a description of the record format.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPRBACNE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGPRBACNE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGPRBACNE FILTER(MYLIB/MYFILTER) GROUP(IOWA)
ASNUSER(NIGHTOPR) SNDDTAQ(*SAME)
</pre>
</p>
<p>This command changes the actions for group IOWA. The assigned user is changed to NIGHTOPR.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGPRBACNE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGPRBACNE.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>CPF91DD</b></dt>
<dd>Action entry for group &amp;4 not found.
</dd>
<dt><b>CPF91DE</b></dt>
<dd>Filter &amp;1/&amp;2 at maximum size.
</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>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="#CHGPRBACNE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>