327 lines
11 KiB
HTML
327 lines
11 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 Action Entry (ADDPRBACNE)</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="ADDPRBACNE.Top_Of_Page"></a>
|
||
|
|
<h2>Add Problem Action Entry (ADDPRBACNE)</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="#ADDPRBACNE.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#ADDPRBACNE.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#ADDPRBACNE.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="ADDPRBACNE"></a>
|
||
|
|
<p>The Add Problem Action Entry (ADDPRBACNE) command adds an entry to the specified problem filter. This entry describes the actions to take for a problem entry. A problem entry is assigned to the specified group by a selection entry in the specified problem filter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDPRBACNE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="ADDPRBACNE.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="#ADDPRBACNE.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"><a href="#ADDPRBACNE.GROUP"><b>GROUP</b></a></td>
|
||
|
|
<td valign="top">Group</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ADDPRBACNE.ASNUSER"><b>ASNUSER</b></a></td>
|
||
|
|
<td valign="top">User assigned</td>
|
||
|
|
<td valign="top"><i>Simple name</i>, <b><u>*NOCHG</u></b>, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="5"><a href="#ADDPRBACNE.SNDDTAQ"><b>SNDDTAQ</b></a></td>
|
||
|
|
<td valign="top">Send to data queue</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</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="#ADDPRBACNE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="ADDPRBACNE.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="#ADDPRBACNE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDPRBACNE.GROUP"></a>
|
||
|
|
<h3>Group (GROUP)</h3>
|
||
|
|
<p>Specifies the group for which the actions are applied. The group name is assigned from selection criteria from a selection entry in the filter. Selection entries are added to the filter with the ADDPRBSLTE command.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDPRBACNE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDPRBACNE.ASNUSER"></a>
|
||
|
|
<h3>User assigned (ASNUSER)</h3>
|
||
|
|
<p>Specifies the user assigned to the problem log entry.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NOCHG</u></b></dt>
|
||
|
|
<dd>No new value is assigned 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="#ADDPRBACNE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ADDPRBACNE.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>*NONE</u></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>*NONE</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><b>NOTES:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>If an exact match is not found for the group name when a filter is applied, then the default action entry is used to assign actions. The default action entry is automatically added to the filter when it is created. The default values are ASNUSER(*NONE) and SNDDTAQ(*NONE).
|
||
|
|
</li>
|
||
|
|
<li>A keyed data queue is a queue with a key assigned to each entry on the queue. When retrieving entries, a key can be specified and the entries with that key are retrieved on a FIFO order. The key that is specified on the *SNDDTAQ parameter is assigned to the problem notification record when placed on a keyed data queue.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<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><b>Record Format</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
Position Type Value Description
|
||
|
|
-------- ---- ------------- --------------------------------
|
||
|
|
1-10 CHAR *PRBFTR Problem filtering notification
|
||
|
|
11-11 CHAR Function Function performed
|
||
|
|
1 - Problem created
|
||
|
|
2 - Problem changed
|
||
|
|
3 - Problem deleted
|
||
|
|
12-19 CHAR Function TOD TOD time stamp for function
|
||
|
|
20-29 CHAR Group Group problem was filtered into
|
||
|
|
30-39 CHAR Problem ID Problem ID number
|
||
|
|
40-59 CHAR Origin System System where problem originated
|
||
|
|
60-60 CHAR Last Event Last event committed into the
|
||
|
|
history log (see note)
|
||
|
|
61-68 CHAR Event TOD TOD time stamp for Last Event
|
||
|
|
69-80 CHAR Reserved Reserved for future use
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Valid Last Event values are the following:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
'01'X Problem entry opened
|
||
|
|
'02'X Request received
|
||
|
|
'03'X Opened by Alert
|
||
|
|
'10'X Problem analyzed
|
||
|
|
'11'X Verification test ran
|
||
|
|
'12'X Recovery procedure ran
|
||
|
|
'20'X Prepared to report
|
||
|
|
'21'X Service request sent
|
||
|
|
'22'X Problem answered
|
||
|
|
'23'X Response sent
|
||
|
|
'24'X Reported by voice
|
||
|
|
'25'X Fixes transmitted
|
||
|
|
'30'X Fix verified
|
||
|
|
'41'X Analyzed remotely
|
||
|
|
'42'X Remote verification ran
|
||
|
|
'43'X Remote recovery ran
|
||
|
|
'50'X Alert created
|
||
|
|
'51'X APAR created
|
||
|
|
'52'X APAR data saved
|
||
|
|
'54'X APAR data restored
|
||
|
|
'55'X APAR data deleted
|
||
|
|
'60'X Problem changed by Change Problem (CHGPRB) command
|
||
|
|
'61'X Problem deleted by Delete Problem (DLTPRB) command
|
||
|
|
'99'X Problem entry closed
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDPRBACNE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ADDPRBACNE.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ADDPRBACNE FILTER(MYLIB/MYFILTER) GROUP(IOWA)
|
||
|
|
ASNUSER(SYSOPR)) SNDDTAQ(*LIBL/PROBDTAQ)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>The actions defined for group IOWA are: enqueue the problem on data queue PROBDTAQ; and assign the problem to user SYSOPR.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ADDPRBACNE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ADDPRBACNE.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>CPF91DB</b></dt>
|
||
|
|
<dd>Group &4 already exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF91DE</b></dt>
|
||
|
|
<dd>Filter &1/&2 at maximum size.
|
||
|
|
</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>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="#ADDPRBACNE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|