300 lines
9.7 KiB
HTML
300 lines
9.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>Load or Unload Image Catalog (LODIMGCLG)</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="LODIMGCLG.Top_Of_Page"></a>
|
|
<h2>Load or Unload Image Catalog (LODIMGCLG)</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="#LODIMGCLG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#LODIMGCLG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#LODIMGCLG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="LODIMGCLG"></a>
|
|
<p>The Load or Unload Image Catalog (LODIMGCLG) command is used to associate an image catalog and its images to a virtual device. The status of the image catalog 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 to change to Ready. All image catalog entries that are in mounted or loaded status will be loaded in the specified virtual device. The allow save attribute will be set to not allow save for all image catalog files.
|
|
</dd>
|
|
<dt><b>*UNLOAD</b></dt>
|
|
<dd>This will cause the status of the image catalog to change to Not ready. All image catalog entries are removed from the specified virtual device. The allow save attribute will be set to allow save for all image catalog entries.
|
|
</dd>
|
|
</dl>
|
|
<p>Only one image catalog can be associated with a virtual device. If the virtual device already has an image catalog associated with it, you can use OPTION(*UNLOAD) to unload the current image catalog.
|
|
</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:
|
|
<ol>
|
|
<li>Execute (*EXECUTE) authority to library QUSRSYS.
|
|
</li>
|
|
<li>*USE authority to the image catalog.
|
|
</li>
|
|
<li>*USE authority to the virtual device description.
|
|
</li>
|
|
<li>Execute (*X) authority to each directory in the image catalog path name.
|
|
</li>
|
|
<li>If WRTPTC(*ALL) or WRTPTC(*NONE) is specified, the following authority is required:
|
|
<ol>
|
|
<li>*CHANGE authority to the image catalog.
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="LODIMGCLG.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="#LODIMGCLG.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="#LODIMGCLG.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Virtual device</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#LODIMGCLG.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Option</td>
|
|
<td valign="top"><b><u>*LOAD</u></b>, *UNLOAD</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#LODIMGCLG.WRTPTC"><b>WRTPTC</b></a></td>
|
|
<td valign="top">Write protect</td>
|
|
<td valign="top"><b><u>*DFT</u></b>, *ALL, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="LODIMGCLG.IMGCLG"></a>
|
|
<h3>Image catalog (IMGCLG)</h3>
|
|
<p>Specifies the image catalog to be loaded or unloaded.
|
|
</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="#LODIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="LODIMGCLG.DEV"></a>
|
|
<h3>Virtual device (DEV)</h3>
|
|
<p>Specify the device that the image catalog is to be loaded into or unloaded from.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the virtual device.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="LODIMGCLG.OPTION"></a>
|
|
<h3>Option (OPTION)</h3>
|
|
<p>Specifies whether the image catalog is to be loaded or unloaded.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LOAD</u></b></dt>
|
|
<dd>The image catalog will be loaded into the virtual device.
|
|
</dd>
|
|
<dt><b>*UNLOAD</b></dt>
|
|
<dd>The image catalog will be unloaded from the virtual device.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="LODIMGCLG.WRTPTC"></a>
|
|
<h3>Write protect (WRTPTC)</h3>
|
|
<p>Specifies whether to write protect based on each catalog entry's assigned value or to force all catalog entries to be write protected when the image catalog is loaded. The write protect value for each catalog entry will be returned to its previous value when the image catalog is unloaded from the device.
|
|
</p>
|
|
<p>This parameter is valid only when parameter OPTION(*LOAD) is specified. When parameter OPTION(*UNLOAD) is specified the WRTPTC parmeter is ignored.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DFT</u></b></dt>
|
|
<dd>Each image catalog entry's current write protect value will be used when the image catalog is loaded in the virtual device.
|
|
<p>The default write protect values for dependent and reference image catalogs are unique and are defined as follows:
|
|
</p>
|
|
<ol>
|
|
<li>Optical dependent image catalogs
|
|
<ul>
|
|
<li>All entries will have their write protected value set on when the image catalog is loaded in the virtual device.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>Optical reference image catalogs
|
|
<ul>
|
|
<li>All entries will have their write protected value set on when the image catalog is loaded in the virtual device.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>Tape dependent image catalogs
|
|
<ul>
|
|
<li>All entries will have their write protected value set on when the image catalog is loaded in the virtual device.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>Tape reference image catalogs
|
|
<ul>
|
|
<li>All entries will use the current write protect value when the image catalog is loaded in the virtual device.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All entries will be write protected when the image catalog is loaded in the virtual device.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>The write protect value will be set off for all entries when the image catalog is loaded in the virtual device.
|
|
<p>The *NONE write protect values for dependent and reference image catalogs are unique and are defined as follows:
|
|
</p>
|
|
<ol>
|
|
<li>Optical dependent image catalogs
|
|
<ul>
|
|
<li>All entries will have their write protected value set on when the image catalog is loaded in the virtual device.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>Optical reference image catalogs
|
|
<ul>
|
|
<li>All entries will have their write protected value set on when the image catalog is loaded in the virtual device.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>Tape dependent image catalogs
|
|
<ul>
|
|
<li>All entries will have their write protected value set on when the image catalog is loaded in the virtual device.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>Tape reference image catalogs
|
|
<ul>
|
|
<li>All entries will have their write protect value set off when the image catalog is loaded in the virtual device.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="LODIMGCLG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Loading an Image Catalog</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
LODIMGCLG IMGCLG(MYCLG) DEV(OPTVRT01) OPTION(*LOAD)
|
|
</pre>
|
|
</p>
|
|
<p>This command loads image catalog <b>MYCLG</b> into device <b>OPTVRT01</b>. Write protection is set based on the current value for each catalog entry. This example assumes that MYCLG is not a dependent or reference catalog.
|
|
</p>
|
|
<p><b>Example 2: Loading an Image Catalog as read-only</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
LODIMGCLG IMGCLG(MYCLG) DEV(OPTVRT01) OPTION(*LOAD)
|
|
WRTPTC(*ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command loads image catalog <b>MYCLG</b> into device <b>OPTVRT01</b>. Write protection is set on for all catalog entries.
|
|
</p>
|
|
<p><b>Example 3: Unloading an Image Catalog</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
LODIMGCLG IMGCLG(MYCLG) DEV(OPTVRT01) OPTION(*UNLOAD)
|
|
</pre>
|
|
</p>
|
|
<p>This command unloads image catalog <b>MYCLG</b> from device <b>OPTVRT01</b>.
|
|
</p>
|
|
<p><b>Example 4: Loading a tape type Image Catalog</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
LODIMGCLG IMGCLG(MYCLG) DEV(TAPVRT01) OPTION(*LOAD)
|
|
</pre>
|
|
</p>
|
|
<p>This command loads image catalog <b>MYCLG</b> into device <b>TAPVRT01</b>.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LODIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="LODIMGCLG.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPFBC10</b></dt>
|
|
<dd>Image catalog &1 not loaded to device &2.
|
|
</dd>
|
|
<dt><b>CPFBC11</b></dt>
|
|
<dd>Image catalog &1 not unloaded from device &2.
|
|
</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="#LODIMGCLG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|