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

251 lines
10 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Create Alert Table (CRTALRTBL)</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="CRTALRTBL.Top_Of_Page"></a>
<h2>Create Alert Table (CRTALRTBL)</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="#CRTALRTBL.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTALRTBL.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTALRTBL.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTALRTBL"></a>
<p>The Create Alert Table (CRTALRTBL) command creates an alert table for storing the alert description records. An alert table specifies the hardware and software products it is used for and defines alerts (problem notifications in a network). The typical user is the system or network programmer or operator responsible for network management. More information on alerts is in the Alerts Support book, SC41-5413 book.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTALRTBL.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="#CRTALRTBL.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, 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>*CURLIB</u></b></td>
</tr><tr>
<td valign="top"><a href="#CRTALRTBL.LICPGM"><b>LICPGM</b></a></td>
<td valign="top">Product</td>
<td valign="top"><i>Character value</i>, <b><u>5769SS1</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTALRTBL.LICPGMTXT"><b>LICPGMTXT</b></a></td>
<td valign="top">Licensed program text</td>
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTALRTBL.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTALRTBL.AUT"><b>AUT</b></a></td>
<td valign="top">Authority</td>
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *CHANGE, *ALL, *USE, *EXCLUDE</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTALRTBL.ALRTBL"></a>
<h3>Alert table (ALRTBL)</h3>
<p>Specifies the qualified name of the alert table being created. Each alert table contains alert descriptions that are used to create alerts. An alert table has a one-to-one correspondence with a message file. To define an alert for a particular message, the name of the alert table must be the same as the name of the message file.
</p>
<p>
<b>Note: </b>The alert table and message file do not have to be in the same library; however, the alert table library must be in the library list of the job that causes the alert to be created.
</p>
<p>This is a required parameter.
</p>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*CURLIB</u></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 and ADD authority for the specified library.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTALRTBL.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>5722SS1</u></b></dt>
<dd>The product identifier for the OS/400 system.
</dd>
<dt><b>*NONE</b></dt>
<dd>No licensed program is specified. This value allows programs that are not defined in the software resource management database of the system. No software product identification is present in the alert for the alert sender.
</dd>
<dt><b><i>licensed-program</i></b></dt>
<dd>Specify a 7-character product identifier for the licensed product. The Alert Manager uses this ID to access the software resource management database for release and level information.
</dd>
</dl>
<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>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTALRTBL.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 software product identification for the alert sender.
</p>
<dl>
<dt><b><u>*BLANK</u></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 program.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTALRTBL.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>No text is to be specified.
</dd>
<dt><b><i>'description'</i></b></dt>
<dd>Specify no more that 50 characters, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTALRTBL.AUT"></a>
<h3>Authority (AUT)</h3>
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
</p>
<dl>
<dt><b><u>*LIBCRTAUT</u></b></dt>
<dd>The system determines the authority for the object by using the value specified on the <b>Create authority</b> prompt (CRTAUT parameter) on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified on the CRTAUT parameter is changed, the new value does not affect any existing objects.
</dd>
</dl>
<dl>
<dt><b><u>*CHANGE</u></b></dt>
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
</dd>
</dl>
<dl>
<dt><b>*ALL</b></dt>
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
</dd>
</dl>
<dl>
<dt><b>*USE</b></dt>
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
</dd>
</dl>
<dl>
<dt><b>*EXCLUDE</b></dt>
<dd>The user cannot access the object.
</dd>
</dl>
<dl>
<dt><b><i>authorization-list-name</i></b></dt>
<dd>Specify the name of an authorization list. Users included on the authorization list are granted authority to the object as specified by the list. The authorization list must exist when the object is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTALRTBL.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTALRTBL ALRTBL(ALRTBLLIB/ALRTBLNBR1) LICPGM(5716SS1)
LICPGMTXT('OS/400')
TEXT('This is the first alert table created')
</pre>
</p>
<p>This command creates an alert table in the library ALRTBLLIB called ALRTBLNBR1. The public has *CHANGE authority to the table. The licensed program associated with this ALRTBL is the OS/400 system.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTALRTBL.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2108</b></dt>
<dd>Object &amp;1 type *&amp;3 not added to library &amp;2.
</dd>
<dt><b>CPF2112</b></dt>
<dd>Object &amp;1 in &amp;2 type *&amp;3 already exists.
</dd>
<dt><b>CPF2113</b></dt>
<dd>Cannot allocate library &amp;1.
</dd>
<dt><b>CPF2151</b></dt>
<dd>Operation failed for &amp;2 in &amp;1 type *&amp;3.
</dd>
<dt><b>CPF2182</b></dt>
<dd>Not authorized to library &amp;1.
</dd>
<dt><b>CPF2283</b></dt>
<dd>Authorization list &amp;1 does not exist.
</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="#CRTALRTBL.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>