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

324 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>Delete Alert (DLTALR)</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="DLTALR.Top_Of_Page"></a>
<h2>Delete Alert (DLTALR)</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="#DLTALR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DLTALR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DLTALR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DLTALR"></a>
<p>The Delete Alert (DLTALR) command allows you to delete one or more alerts from the alert database.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTALR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DLTALR.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"><a href="#DLTALR.DLTOPT"><b>DLTOPT</b></a></td>
<td valign="top">Delete option</td>
<td valign="top"><b><u>*ALL</u></b>, *RCV, *LOCAL, *HELD</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#DLTALR.DAYS"><b>DAYS</b></a></td>
<td valign="top">Days</td>
<td valign="top">0-999, <b><u>30</u></b></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#DLTALR.ALRTYPE"><b>ALRTYPE</b></a></td>
<td valign="top">Alert type</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 5 repetitions): <i>Character value</i>, *TEMP, *PERM, *PERF, *IMPEND, *UNKNOWN</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DLTALR.ALRRSC"><b>ALRRSC</b></a></td>
<td valign="top">Alert resource</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DLTALR.ALRRSCTYPE"><b>ALRRSCTYPE</b></a></td>
<td valign="top">Alert resource type</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DLTALR.ASNUSER"><b>ASNUSER</b></a></td>
<td valign="top">User assigned</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Character value</i>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DLTALR.GROUP"><b>GROUP</b></a></td>
<td valign="top">Group</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Name</i>, *NONE, *DEFAULT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DLTALR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DLTALR.DLTOPT"></a>
<h3>Delete option (DLTOPT)</h3>
<p>Specifies which alerts are to be deleted.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All alerts that meet the selection criteria in the remaining keywords are deleted. If the remaining keywords are defaulted, all of the alerts over 30 days old are deleted.
</dd>
<dt><b>*RCV</b></dt>
<dd>Only alerts received from other systems are deleted. Selection criteria for the received alerts can be further specified in the remaining keywords. If the remaining keywords are defaulted, all of the received alerts over 30 days old are deleted.
</dd>
<dt><b>*LOCAL</b></dt>
<dd>Only locally created alerts are deleted. Selection criteria for the local alerts can be further specified in the remaining keywords. If the remaining keywords are defaulted, all of the locally created alerts over 30 days old are deleted.
</dd>
<dt><b>*HELD</b></dt>
<dd>All alerts that cannot be sent to the system's focal point and are marked HELD are deleted. Selection criteria for the held alerts can be further specified in the remaining keywords. If the remaining keywords are defaulted, all of the held alerts over 30 days old are deleted.
</dd>
</dl>
<p>
<b>Note: </b>There is a distinction between held alerts that are sent or forwarded by this system, and held alerts that are received by another system. DLTOPT(*HELD) deletes only held alerts that could not be sent or forwarded by this system (or are currently being held based on the ALRHLDCNT network attribute).
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTALR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DLTALR.DAYS"></a>
<h3>Days (DAYS)</h3>
<p>Specifies that alerts older than this value are deleted. Alerts that are more recent than this value are not deleted. This value can be 0 or any number of days. Selection criteria can be further specified in the remaining keywords.
</p>
<dl>
<dt><b><u>30</u></b></dt>
<dd>All alerts over 30 days old are deleted.
</dd>
<dt><b><i>0-999</i></b></dt>
<dd>Specify the number of days.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTALR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DLTALR.ALRTYPE"></a>
<h3>Alert type (ALRTYPE)</h3>
<p>Specifies which types of alerts are deleted. The alert type indicates the severity of the alert.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All types of alerts are deleted.
</dd>
</dl>
<p><b>Other values (up to 5 repetitions)</b>
</p>
<dl>
<dt><b>*TEMP</b></dt>
<dd>All alerts reporting a temporary problem are deleted.
</dd>
<dt><b>*PERM</b></dt>
<dd>All alerts reporting a permanent problem are deleted.
</dd>
<dt><b>*PERF</b></dt>
<dd>All alerts reporting a performance problem are deleted.
</dd>
<dt><b>*IMPEND</b></dt>
<dd>All alerts reporting an impending problem are deleted.
</dd>
<dt><b>*UNKNOWN</b></dt>
<dd>All alerts reporting a problem with unknown severity are deleted.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the code point for the alert type. The code point is specified by two (2) hexadecimal digits.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTALR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DLTALR.ALRRSC"></a>
<h3>Alert resource (ALRRSC)</h3>
<p>Specifies the name of resources that are reporting problems. Up to 50 alert resource names can be specified.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Alerts about all failing resources.
</dd>
</dl>
<p><b>Other values (up to 50 repetitions)</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of resources that are reporting problems.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTALR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DLTALR.ALRRSCTYPE"></a>
<h3>Alert resource type (ALRRSCTYPE)</h3>
<p>Specifies the type of resources that are reporting problems. A maximum of 50 resource types can be specified. Each resource name has a resource type associated with that resource. For example, resource types are diskette (DKT) or tape (TAP).
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Alerts for all resource types.
</dd>
</dl>
<p><b>Other values (up to 50 repetitions)</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the resource type of alerts that are reporting problems associated with the assigned resource type.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTALR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DLTALR.ASNUSER"></a>
<h3>User assigned (ASNUSER)</h3>
<p>Specifies the user to which the alerts being deleted are assigned. This value is taken from the value on the ASNUSER parameter in the Add Alert Action Entry (ADDALRACNE) command.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All alerts are deleted.
</dd>
</dl>
<p><b>Other values (up to 50 repetitions)</b>
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>The alerts not assigned to a user are deleted.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the name of the user to which the alerts being deleted are assigned.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTALR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DLTALR.GROUP"></a>
<h3>Group (GROUP)</h3>
<p>Specifies the group to which the alerts being deleted are assigned. This value is taken from the value on the GROUP parameter in the Add Alert Selection Entry (ADDALRSLTE) command.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All alerts are deleted.
</dd>
</dl>
<p><b>Other values (up to 50 repetitions)</b>
</p>
<dl>
<dt><b>*DEFAULT</b></dt>
<dd>The alerts assigned to the default group are deleted.
</dd>
<dt><b>*NONE</b></dt>
<dd>The alerts not assigned to a group are deleted.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the group to which the alerts being deleted are assigned.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTALR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DLTALR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Deleting Temporary and Permanent Alert Types</b>
</p>
<p>
<pre>
DLTALR DLTOPT(*LOCAL) DAYS(10) ALRTYPE(*TEMP *PERM)
ALRRSCTYPE(DKT)
</pre>
</p>
<p>This command deletes temporary and permanent locally created alerts in the alert database. The alerts that are deleted are reporting problems about diskettes. Alerts more than 10 days old that match these criteria are deleted.
</p>
<p><b>Example 2: Deleting Alerts Associated with Diskette Resources</b>
</p>
<p>
<pre>
DLTALR DLTOPT(*RCV) DAYS(0) ALRRSCTYPE(DKT)
</pre>
</p>
<p>This command deletes received alerts associated with diskette resources.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTALR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DLTALR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<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>CPF9812</b></dt>
<dd>File &amp;1 in library &amp;2 not found.
</dd>
<dt><b>CPF9822</b></dt>
<dd>Not authorized to file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF9845</b></dt>
<dd>Error occurred while opening file &amp;1.
</dd>
<dt><b>CPF9846</b></dt>
<dd>Error while processing file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF9847</b></dt>
<dd>Error occurred while closing file &amp;1 in library &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTALR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>