264 lines
8.1 KiB
HTML
264 lines
8.1 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>Load/Unload/Mount IMGCLG Entry (LODIMGCLGE)</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="LODIMGCLGE.Top_Of_Page"></a>
|
|
<h2>Load/Unload/Mount IMGCLG Entry (LODIMGCLGE)</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="#LODIMGCLGE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#LODIMGCLGE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#LODIMGCLGE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="LODIMGCLGE"></a>
|
|
<p>The Load/Unload/Mount Image Catalog Entry (LODIMGCLGE) command is used to change the status of an image catalog entry in an image catalog. The status of the image catalog entry will be changed based on the value specified for the <b>Option (OPTION)</b> parameter as follows:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*LOAD</b></dt>
|
|
<dd>This will cause the status of the image catalog entry to change to Loaded.
|
|
</dd>
|
|
<dt><b>*UNLOAD</b></dt>
|
|
<dd>This will cause the status of the image catalog entry to change to Unloaded.
|
|
</dd>
|
|
<dt><b>*MOUNT</b></dt>
|
|
<dd>This will cause the status of the image catalog entry to change to Mounted.
|
|
</dd>
|
|
</dl>
|
|
<p>Only one image catalog entry can be in a mounted status. If OPTION(*MOUNT) is specified, an existing entry in mounted status will be changed to a loaded status.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
|
</li>
|
|
<li>The following authorities are required to load an image catalog entry:
|
|
<ol>
|
|
<li>Execute (*EXECUTE) authority to library QUSRSYS.
|
|
</li>
|
|
<li>*USE authority to the image catalog being loaded or unloaded.
|
|
</li>
|
|
<li>*USE authority to the virtual device description.
|
|
</li>
|
|
<li>Execute (*X) authority to each directory in the image catalog path name.
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
<li>The following parameters are only supported for tape type image catalogs:
|
|
<ol>
|
|
<li>Image catalog volume (VOL)
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="LODIMGCLGE.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="#LODIMGCLGE.IMGCLG"><b>IMGCLG</b></a></td>
|
|
<td valign="top">Image catalog</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#LODIMGCLGE.IMGCLGIDX"><b>IMGCLGIDX</b></a></td>
|
|
<td valign="top">Image catalog index</td>
|
|
<td valign="top">1-256, <b><u>*FIRST</u></b>, *LAST, *NEXT, *VOL</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#LODIMGCLGE.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Option</td>
|
|
<td valign="top"><b><u>*MOUNT</u></b>, *LOAD, *UNLOAD</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#LODIMGCLGE.VOL"><b>VOL</b></a></td>
|
|
<td valign="top">Image catalog volume</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="LODIMGCLGE.IMGCLG"></a>
|
|
<h3>Image catalog (IMGCLG)</h3>
|
|
<p>Specifies the image catalog to be used.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the image catalog.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="LODIMGCLGE.IMGCLGIDX"></a>
|
|
<h3>Image catalog index (IMGCLGIDX)</h3>
|
|
<p>Specifies the index number of the image catalog entry whose status is to be changed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first image catalog entry in the image catalog.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The last image catalog entry in the image catalog.
|
|
</dd>
|
|
<dt><b>*NEXT</b></dt>
|
|
<dd>The next image catalog entry in loaded status will be mounted. This value is only allowed when OPTION(*MOUNT) is specified.
|
|
</dd>
|
|
<dt><b>*VOL</b></dt>
|
|
<dd>Specifies to load/unload/mount the entry by specifying a volume name.
|
|
</dd>
|
|
<dt><b><i>1-256</i></b></dt>
|
|
<dd>Specify the image catalog index number to be used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="LODIMGCLGE.OPTION"></a>
|
|
<h3>Option (OPTION)</h3>
|
|
<p>Specifies the new status of the image catalog entry.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MOUNT</u></b></dt>
|
|
<dd>The image catalog entry will be mounted into the image catalog.
|
|
</dd>
|
|
<dt><b>*LOAD</b></dt>
|
|
<dd>The image catalog entry will be loaded into the image catalog.
|
|
</dd>
|
|
<dt><b>*UNLOAD</b></dt>
|
|
<dd>The image catalog entry will be unloaded from the image catalog.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="LODIMGCLGE.VOL"></a>
|
|
<h3>Image catalog volume (VOL)</h3>
|
|
<p>Specifies the volume name of the entry to be unloaded, loaded, or mounted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the volume name of the entry to be unloaded, loaded, or mounted. For optical image catalogs, the first volume that matches the volume specifed will have its status changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="LODIMGCLGE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Mounting an Image Catalog Entry</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
LODIMGCLGE IMGCLG(MYCLG) IMGCLGIDX(*FIRST) OPTION(*MOUNT)
|
|
</pre>
|
|
</p>
|
|
<p>This command mounts the first image catalog entry in image catalog <b>MYCLG</b>. If there is an image mounted, it will be changed to a loaded status.
|
|
</p>
|
|
<p><b>Example 2: Loading an Image Catalog Entry</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
LODIMGCLGE IMGCLG(MYCLG) IMGCLGIDX(5) OPTION(*LOAD)
|
|
</pre>
|
|
</p>
|
|
<p>This command loads the image catalog entry associated with index number <b>5</b> in image catalog <b>MYCLG</b>.
|
|
</p>
|
|
<p><b>Example 3: Unloading an Image Catalog Entry</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
LODIMGCLGE IMGCLG(MYCLG) IMGCLGIDX(*LAST) OPTION(*UNLOAD)
|
|
</pre>
|
|
</p>
|
|
<p>This command unloads the last image catalog entry in image catalog <b>MYCLG</b>.
|
|
</p>
|
|
<p><b>Example 4: Mounting a Tape Image Catalog Entry by Volume</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
LODIMGCLGE IMGCLG(TAPECLG) IMGCLGIDX(*VOL)
|
|
VOL(TAP002) OPTION(*MOUNT)
|
|
</pre>
|
|
</p>
|
|
<p>This command mounts the tape image catalog entry associated with volume <b>TAP002</b> in image catalog <b>TAPECLG</b>.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="LODIMGCLGE.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPFBC46</b></dt>
|
|
<dd>Catalog entry at index &1 not loaded.
|
|
</dd>
|
|
<dt><b>CPFBC47</b></dt>
|
|
<dd>Catalog entry at index &1 not unloaded.
|
|
</dd>
|
|
<dt><b>CPFBC48</b></dt>
|
|
<dd>Catalog entry at index &1 not mounted.
|
|
</dd>
|
|
<dt><b>CPFBC0D</b></dt>
|
|
<dd>Catalog entry at index &1 not loaded.
|
|
</dd>
|
|
<dt><b>CPFBC0E</b></dt>
|
|
<dd>Catalog entry at index &1 not unloaded.
|
|
</dd>
|
|
<dt><b>CPFBC0F</b></dt>
|
|
<dd>Catalog entry at index &1 not mounted.
|
|
</dd>
|
|
<dt><b>CPFBC45</b></dt>
|
|
<dd>Image catalog &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9802</b></dt>
|
|
<dd>Not authorized to object &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|