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

208 lines
7.3 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 Alert Table (CHGALRTBL)</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="CHGALRTBL.Top_Of_Page"></a>
<h2>Change Alert Table (CHGALRTBL)</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="#CHGALRTBL.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGALRTBL.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGALRTBL.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGALRTBL"></a>
<p>The Change Alert Table (CHGALRTBL) command is used to change one of the values defined by the Create Alert Table (CRTALRTBL) command. Alert tables define alerts, which are problem notifications in a network. The CHGALRTBL command can be used to change the product identification, product text, or object text for an alert table. The typical user of the CHGALRTBL command is the system or network programmer or operator responsible for network management. More information on alerts is in the Alerts Support book, SC41-5413.
</p>
<p>
<b>Note: </b>The user must have CHANGE authority for the alert table.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGALRTBL.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="#CHGALRTBL.ALRTBL"><b>ALRTBL</b></a></td>
<td valign="top">Alert table</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: Alert table</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="#CHGALRTBL.LICPGM"><b>LICPGM</b></a></td>
<td valign="top">Product</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGALRTBL.LICPGMTXT"><b>LICPGMTXT</b></a></td>
<td valign="top">Licensed program text</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGALRTBL.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGALRTBL.ALRTBL"></a>
<h3>Alert table (ALRTBL)</h3>
<p>Specifies the qualified name of the alert table that is changed. Each alert table contains alert descriptions that are used to create alerts.
</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 alert table. If no current library entry exists in the library list, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library where the alert table is located. Only the library named is searched. The user must have READ authority for the specified library.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGALRTBL.LICPGM"></a>
<h3>Product (LICPGM)</h3>
<p>Specifies the licensed program associated with this alert table. This program is included in the alert as software product identification for the alert sender.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The LICPGM value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>A licensed program is not specified.
</dd>
<dt><b><i>licensed-program</i></b></dt>
<dd>Specify a seven character product identifier for the licensed program. The Alert Manager uses this identifier to access the software resource management database for release and level information.
<p>
<b>Note: </b>This parameter does not have to be an IBM Licensed Program. Any 7-character ID that is meaningful to the use of the Work with Alerts command can be specified. If the value given for the LICPGM parameter is defined to the system, the ID and release and level information are included in the alert.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGALRTBL.LICPGMTXT"></a>
<h3>Licensed program text (LICPGMTXT)</h3>
<p>Specifies descriptive text for the alert table licensed program parameter (for example, 'OS/400'). The text is included in the alert as product identification for the alert sender.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The text does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No text is specified.
</dd>
<dt><b><i>'licensed-program-text'</i></b></dt>
<dd>Specify up to 30 characters of text describing the licensed program.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGALRTBL.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The text does not change.
</dd>
<dt><b>*BLANK</b></dt>
<dd>No text is specified.
</dd>
<dt><b><i>'description'</i></b></dt>
<dd>Specify no more than 50 characters enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGALRTBL.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGALRTBL ALRTBL(ALRTBLLIB/ALRTBLNBR1)
LICPGMTXT('OS/400--customer defined')
</pre>
</p>
<p>This command changes the licensed program for the alert table in library ALRTBLLIB called ALRTBLNBR1.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGALRTBL.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF9801</b></dt>
<dd>Object &amp;2 in library &amp;3 not found.
</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>CPF9810</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF9820</b></dt>
<dd>Not authorized to use library &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>