128 lines
4.7 KiB
HTML
128 lines
4.7 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 Optical Server (ADDOPTSVR)</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="ADDOPTSVR.Top_Of_Page"></a>
|
|
<h2>Add Optical Server (ADDOPTSVR)</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="#ADDOPTSVR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDOPTSVR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDOPTSVR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDOPTSVR"></a>
|
|
<p>The Add Optical Server (ADDOPTSVR) command enables access, using the hierarchical file system (HFS) APIs, to a remotely attached optical server. This command retrieves a list of optical volumes in each server and adds them to the optical index database allowing the volumes to be accessed using the HFS APIs. If a remote optical server is already enabled, you can use this command to refresh the volume list for that server.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>You must have *USE authority to use this command. It is shipped with *EXCLUDE public authority.
|
|
</li>
|
|
<li>To use a remote optical server, the users must have the library that contains the communications side information for that destination in their library list.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDOPTSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDOPTSVR.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="#ADDOPTSVR.CSI"><b>CSI</b></a></td>
|
|
<td valign="top">Side information</td>
|
|
<td valign="top">Values (up to 16 repetitions): <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Side information</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></table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDOPTSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDOPTSVR.CSI"></a>
|
|
<h3>Side information (CSI)</h3>
|
|
<p>Specifies the communications side information (*CSI) object of the optical server to be added to the optical configuration. The communications side information object name is also referred to as the optical server name or the optical destination name. A maximum of 16 qualified names of servers can be specified.
|
|
</p>
|
|
<p><b>Qualifier 1: Side information</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>communications-side-information-object-name</i></b></dt>
|
|
<dd>Specify the name of the communications side information object representing the optical server.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
|
</dd>
|
|
<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><i>library-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="#ADDOPTSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDOPTSVR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
ADDOPTSVR CSI((QGPL/LAN01))
|
|
</pre>
|
|
</p>
|
|
<p>This command enables access to the optical server defined by the communications side information object name LAN01 in library QGPL.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDOPTSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDOPTSVR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>OPT0125</b></dt>
|
|
<dd>Command &1 completed with errors, more information in job log.
|
|
</dd>
|
|
<dt><b>OPT6712</b></dt>
|
|
<dd>Remote optical server volume list rebuild failed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDOPTSVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|