375 lines
12 KiB
HTML
375 lines
12 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 Binding Directory Entry (ADDBNDDIRE)</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="ADDBNDDIRE.Top_Of_Page"></a>
|
|
<h2>Add Binding Directory Entry (ADDBNDDIRE)</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="#ADDBNDDIRE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDBNDDIRE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDBNDDIRE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDBNDDIRE"></a>
|
|
<p>The Add Binding Directory Entry (ADDBNDDIRE) command adds an entry to a binding directory.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>You must have use (*USE) authority for the library where the binding directory to be changed is located.
|
|
</li>
|
|
<li>You must have object operational (*OBJOPR) and add (*ADD) authorities to the binding directory to be changed.
|
|
</li>
|
|
<li>You must have execute (*EXECUTE) authority to the specified library when a generic name is specified for the <b>Object specifications (OBJ)</b> parameter.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDBNDDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDBNDDIRE.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="#ADDBNDDIRE.BNDDIR"><b>BNDDIR</b></a></td>
|
|
<td valign="top">Binding directory</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: Binding directory</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, *USRLIBL</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="5"><a href="#ADDBNDDIRE.OBJ"><b>OBJ</b></a></td>
|
|
<td valign="top">Object specifications</td>
|
|
<td valign="top">Values (up to 50 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="5">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Object</td>
|
|
<td valign="top">
|
|
<i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Object</td>
|
|
<td valign="top"><i>Generic name, name</i>, *ALL</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></td>
|
|
</tr><tr>
|
|
<td valign="top">Element 2: Object type</td>
|
|
<td valign="top">
|
|
<b><u>*SRVPGM</u></b>, *MODULE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="6"><a href="#ADDBNDDIRE.POSITION"><b>POSITION</b></a></td>
|
|
<td valign="top">Position specifications</td>
|
|
<td valign="top">Single values: <b><u>*LAST</u></b>, *FIRST<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="6">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Object position</td>
|
|
<td valign="top">
|
|
*AFTER, *BEFORE, *REPLACE</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Object</td>
|
|
<td valign="top">
|
|
<i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Object</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></td>
|
|
</tr><tr>
|
|
<td valign="top">Element 3: Object type</td>
|
|
<td valign="top">
|
|
<b><u>*SRVPGM</u></b>, *MODULE</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDBNDDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDBNDDIRE.BNDDIR"></a>
|
|
<h3>Binding directory (BNDDIR)</h3>
|
|
<p>Specifies the binding directory to which an entry is added.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Binding directory</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the binding directory to be updated.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</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 searched. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</dd>
|
|
<dt><b>*USRLIBL</b></dt>
|
|
<dd>Only the libraries in the user portion of the job's library list are searched.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDBNDDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDBNDDIRE.OBJ"></a>
|
|
<h3>Object specifications (OBJ)</h3>
|
|
<p>Specifies one or more object names to be added to the binding directory.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p>You can specify 50 values for this parameter.
|
|
</p>
|
|
<p><b>Element 1: Object</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Qualifier 1: Object</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All objects of the specified object type residing in the specified library are to be added.
|
|
</dd>
|
|
<dt><b><i>generic-name</i></b></dt>
|
|
<dd>Specify the generic name of the object. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. If the complete object name is specified, and multiple libraries are searched, multiple objects can be added only if *ALL or *ALLUSR library values can be specified for the name.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the object to be added to the binding directory.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</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><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Object type</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SRVPGM</u></b></dt>
|
|
<dd>The object to be added is a service program.
|
|
</dd>
|
|
<dt><b>*MODULE</b></dt>
|
|
<dd>The object to be added is a module.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDBNDDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDBNDDIRE.POSITION"></a>
|
|
<h3>Position specifications (POSITION)</h3>
|
|
<p>Specifies the position in the binding directory where the list of objects is added.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LAST</u></b></dt>
|
|
<dd>The list of objects is to be added to the end of the binding directory entries.
|
|
</dd>
|
|
<dt><b>*FIRST</b></dt>
|
|
<dd>The list of objects is to be inserted prior to the first binding directory entry.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Object position</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*AFTER</b></dt>
|
|
<dd>The list of objects is added to the binding directory after the binding directory entry specified for this parameter. The entry specified must currently exist in the binding directory.
|
|
</dd>
|
|
<dt><b>*BEFORE</b></dt>
|
|
<dd>The list of objects is added to the binding directory before the binding directory entry specified for this parameter. The entry specified must currently exist in the binding directory.
|
|
</dd>
|
|
<dt><b>*REPLACE</b></dt>
|
|
<dd>The object specified on the OBJ parameter replaces the binding directory entry specified for this parameter. The entry specified must currently exist in the binding directory. Only one entry can be specified on the OBJ parameter.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Object</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Qualifier 1: Object</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the object name of an existing binding directory entry.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>The existing binding directory entry has a library qualifier of *LIBL.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library qualifier for the existing entry.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Object type</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SRVPGM</u></b></dt>
|
|
<dd>The directory entry is a service program.
|
|
</dd>
|
|
<dt><b>*MODULE</b></dt>
|
|
<dd>The directory entry is a module.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDBNDDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDBNDDIRE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Add Entry to End of List</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDBNDDIRE BNDDIR(TESTBNDDIR) OBJ((TESTOBJ))
|
|
POSITION(*LAST)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds a binding directory entry for service program TESTOBJ in library *LIBL to the end of the list of binding directory entries found in the binding directory TESTBNDDIR.
|
|
</p>
|
|
<p><b>Example 2: Add Entry to Beginning of List</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDBNDDIRE BNDDIR(TESTBNDDIR)
|
|
OBJ((TESTLIB/TESTOBJ *MODULE)) POSITION(*FIRST)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds a binding directory entry for module TESTOBJ in library TESLIB to the beginning of the binding directory entries found in the binding directory TESTBNDDIR.
|
|
</p>
|
|
<p><b>Example 3: Add Multiple Entries</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDBNDDIRE BNDDIR(TESTBNDDIR)
|
|
OBJ((TESTLIB/TESTOBJ *MODULE) (TESTOBJ2))
|
|
POSITION(*FIRST)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds a binding directory entry for module TESTOBJ in library TESTLIB followed by an entry for service program TESTOBJ2 in the library list to the beginning of the binding directory entries found in the binding directory TESTBNDDIR.
|
|
</p>
|
|
<p><b>Example 4: Add Entries Before an Existing Entry</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDBNDDIRE BNDDIR(TESTBNDDIR)
|
|
OBJ((TESTLIB/TESTOBJ *MODULE) (TESTOBJ2))
|
|
POSITION(*BEFORE *LIBL/TESTMOD *MODULE)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds a binding directory entry for module TESTOBJ in library TESTLIB, followed by an entry for service program TESTOBJ2 in library *LIBL prior to the binding directory entry for module TESTMOD in library *LIBL found in the binding directory TESTBNDDIR.
|
|
</p>
|
|
<p>The binding directory entry for module TESTMOD in library *LIBL must be found in the binding directory TESTBNDDIR for this operation to be successful.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDBNDDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDBNDDIRE.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF5D01</b></dt>
|
|
<dd>Binding directory &1 in library &2 is not usable.
|
|
</dd>
|
|
<dt><b>CPF5D09</b></dt>
|
|
<dd>Object &2/&1 type &3 was not found in binding directory &4 in library &5.
|
|
</dd>
|
|
<dt><b>CPF980F</b></dt>
|
|
<dd>Binding directory &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9801</b></dt>
|
|
<dd>Object &2 in library &3 not found.
|
|
</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>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9830</b></dt>
|
|
<dd>Cannot assign library &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDBNDDIRE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|