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

173 lines
6.0 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 Library List Entry (ADDLIBLE)</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="ADDLIBLE.Top_Of_Page"></a>
<h2>Add Library List Entry (ADDLIBLE)</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="#ADDLIBLE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDLIBLE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDLIBLE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDLIBLE"></a>
<p>The Add Library List Entry (ADDLIBLE) command adds a library name to the user portion of the library list for the current thread. The user portion is the last portion of the library list. It follows the system portion and, if they exist, any product libraries and the current library entry. You can specify where the library should be placed in the user portion of the library list.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDLIBLE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDLIBLE.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="#ADDLIBLE.LIB"><b>LIB</b></a></td>
<td valign="top">Library</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDLIBLE.POSITION"><b>POSITION</b></a></td>
<td valign="top">Library list position</td>
<td valign="top">Single values: <b><u>*FIRST</u></b>, *LAST<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top">Element 1: List position</td>
<td valign="top">
*AFTER, *BEFORE, *REPLACE</td>
</tr>
<tr>
<td valign="top">Element 2: Reference library</td>
<td valign="top">
<i>Name</i></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ADDLIBLE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDLIBLE.LIB"></a>
<h3>Library (LIB)</h3>
<p>Specifies the library to be added to the user portion of the library list for the current thread. A maximum of 250 libraries may exist in the user portion of the library list. Only one library name is added at a time with this command.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be added to the user portion of the library list for the current thread.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDLIBLE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDLIBLE.POSITION"></a>
<h3>Library list position (POSITION)</h3>
<p>Specifies the position in the user portion of the library list for the current thread where the library is inserted. This parameter can be specified as a single value or as a list of two elements.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The library is inserted in front of the libraries existing in the user portion of the library list for the current thread.
</dd>
<dt><b>*LAST</b></dt>
<dd>The library is added to the end of the user portion of the library list for the current thread.
</dd>
</dl>
<p><b>Element 1: List position</b>
</p>
<dl>
<dt><b>*AFTER</b></dt>
<dd>The library specified for the <b>Library (LIB)</b> parameter is added to the user portion of the library list for the current thread after the reference library (element 2).
</dd>
<dt><b>*BEFORE</b></dt>
<dd>The library specified for the LIB parameter is added to the user portion of the library list for the current thread before the reference library (element 2).
</dd>
<dt><b>*REPLACE</b></dt>
<dd>The library specified for the LIB parameter is inserted into the library list for the current thread in the position currently held by the reference library (element 2) and the reference library is then removed from the list.
</dd>
</dl>
<p><b>Element 2: Reference library</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be the reference library when *AFTER, *BEFORE, or *REPLACE is specified for the list position (element 1). This library must exist in the user portion of the library list for the current thread.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDLIBLE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDLIBLE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
ADDLIBLE LIB(TESTLIB) POSITION(*LAST)
</pre>
</p>
<p>This command adds the library TESTLIB to the end of the user portion of the library list.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDLIBLE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDLIBLE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2103</b></dt>
<dd>Library &amp;1 already exists in library list.
</dd>
<dt><b>CPF2106</b></dt>
<dd>Library list not available.
</dd>
<dt><b>CPF2110</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF2113</b></dt>
<dd>Cannot allocate library &amp;1.
</dd>
<dt><b>CPF2118</b></dt>
<dd>Library &amp;1 not added.
</dd>
<dt><b>CPF2149</b></dt>
<dd>Library &amp;1 was not found in the user library list.
</dd>
<dt><b>CPF2176</b></dt>
<dd>Library &amp;1 damaged.
</dd>
<dt><b>CPF2182</b></dt>
<dd>Not authorized to library &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDLIBLE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>