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

126 lines
4.5 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>Remove Optical Server (RMVOPTSVR)</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="RMVOPTSVR.Top_Of_Page"></a>
<h2>Remove Optical Server (RMVOPTSVR)</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="#RMVOPTSVR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVOPTSVR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVOPTSVR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVOPTSVR"></a>
<p>The Remove Optical Server (RMVOPTSVR) command disables the ability of hierarchical file system (HFS) APIs to access remote optical servers. The specified servers are no longer accessible to applications using the HFS APIs.
</p>
<p><b>Restriction:</b> The user must have *USE authority to use this command. It is shipped with *EXCLUDE public authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVOPTSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVOPTSVR.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="#RMVOPTSVR.CSI"><b>CSI</b></a></td>
<td valign="top">Side information</td>
<td valign="top">Values (up to 16 repetitions): <i>Name</i>, *ALL</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#RMVOPTSVR.VOLOPT"><b>VOLOPT</b></a></td>
<td valign="top">Volume description option</td>
<td valign="top"><b><u>*REMOVE</u></b>, *KEEP</td>
<td valign="top">Optional, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVOPTSVR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVOPTSVR.CSI"></a>
<h3>Side information (CSI)</h3>
<p>Specifies the communications side information objects representing the remote optical servers to be removed from the optical configuration.
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All remote optical servers in the optical configuration are removed.
</dd>
<dt><b><i>communications-side-information-object-name</i></b></dt>
<dd>Specify the name of the communications side information object representing the remote optical server. A maximum of 16 names of servers can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVOPTSVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVOPTSVR.VOLOPT"></a>
<h3>Volume description option (VOLOPT)</h3>
<p>Specifies whether to keep the volume descriptions in the optical index database files for optical servers being removed.
</p>
<dl>
<dt><b><u>*REMOVE</u></b></dt>
<dd>All volume descriptions are removed from the optical index data base files.
</dd>
<dt><b>*KEEP</b></dt>
<dd>All volume descriptions are kept in the optical index database files. This allows *REMOVED volume descriptions to be displayed when using the Work with Optical Volumes (WRKOPTVOL) command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVOPTSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVOPTSVR.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
RMVOPTSVR CSI(LAN01)
</pre>
</p>
<p>This command removes optical LAN server LAN01 from the optical configuration. All volume descriptions are removed from the optical index database files.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVOPTSVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVOPTSVR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>OPT0125</b></dt>
<dd>Command &amp;1 completed with errors, more information in job log.
</dd>
<dt><b>OPT6730</b></dt>
<dd>No server can be specified when special value *ALL is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVOPTSVR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>