214 lines
6.9 KiB
HTML
214 lines
6.9 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 Image Catalog Entry (RMVIMGCLGE)</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="RMVIMGCLGE.Top_Of_Page"></a>
|
|
<h2>Remove Image Catalog Entry (RMVIMGCLGE)</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="#RMVIMGCLGE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RMVIMGCLGE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RMVIMGCLGE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RMVIMGCLGE"></a>
|
|
<p>The Remove Image Catalog Entry (RMVIMGCLGE) command removes an image catalog entry from an image catalog object (*IMGCLG) in library QUSRSYS. Optionally, the image files associated with the catalog entry can be deleted from the system.
|
|
</p>
|
|
<p>If the image catalog is currently loaded into a virtual device, an error message is sent and the image is not removed from the image catalog. The Load/Unload Image Catalog (LODIMGCLG) command can be used to unload the current image catalog from the virtual device.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
|
</li>
|
|
<li>The following authorities are required to remove an image catalog entry:
|
|
<ol>
|
|
<li>Execute (*EXECUTE) authority to library QUSRSYS.
|
|
</li>
|
|
<li>*CHANGE authority to the image catalog.
|
|
</li>
|
|
<li>Execute (*X) authority to each directory in the image catalog path name.
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
<li>This command is not supported for reference and dependent image catalogs.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RMVIMGCLGE.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="#RMVIMGCLGE.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="#RMVIMGCLGE.IMGCLGIDX"><b>IMGCLGIDX</b></a></td>
|
|
<td valign="top">Image catalog index</td>
|
|
<td valign="top">1-256, *VOL</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVIMGCLGE.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>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVIMGCLGE.KEEP"><b>KEEP</b></a></td>
|
|
<td valign="top">Keep image file</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RMVIMGCLGE.IMGCLG"></a>
|
|
<h3>Image catalog (IMGCLG)</h3>
|
|
<p>Specify the image catalog that the image is to be removed from.
|
|
</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="#RMVIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVIMGCLGE.IMGCLGIDX"></a>
|
|
<h3>Image catalog index (IMGCLGIDX)</h3>
|
|
<p>Specifies the image catalog index of the entry to be removed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>1-256</i></b></dt>
|
|
<dd>Specify the image catalog index number to be used.
|
|
</dd>
|
|
<dt><b>*VOL</b></dt>
|
|
<dd>Specifies to remove the entry by specifying a volume name. This value is only allowed for tape type image catalogs.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVIMGCLGE.VOL"></a>
|
|
<h3>Image catalog volume (VOL)</h3>
|
|
<p>Specifies the volume name of the entry to be removed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the volume name of the entry to be removed. For optical image catalogs, the first volume that matches the volume specifed will be removed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVIMGCLGE.KEEP"></a>
|
|
<h3>Keep image files (KEEP)</h3>
|
|
<p>Specifies whether the image associated with the image catalog entry is to be kept.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>Specify that the image associated with the image catalog entry will not be deleted from the system.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Specify that the image file associated with the image catalog entry will be deleted from the system.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVIMGCLGE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Removing an Image Catalog Entry</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVIMGCLGE IMGCLG(MYCLG) IMGCLGIDX(2)
|
|
</pre>
|
|
</p>
|
|
<p>This command removes the image catalog entry at index <b>2</b> from image catalog <b>MYCLG</b>. The associated image is not deleted.
|
|
</p>
|
|
<p><b>Example 2: Remove an Image Catalog Entry and Delete the Image File</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVIMGCLGE IMGCLG(MYCLG) IMGCLGIDX(1) KEEP(*NO)
|
|
</pre>
|
|
</p>
|
|
<p>This command removes the image catalog entry at index <b>1</b> from image catalog <b>MYCLG</b>. The associated image file is deleted from the system.
|
|
</p>
|
|
<p><b>Example 3: Removing a Tape Image Catalog Entry by Volume Name</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVIMGCLGE IMGCLG(TAPECLG) IMGCLGIDX(*VOL) VOL(TAP001)
|
|
KEEP(*NO)
|
|
</pre>
|
|
</p>
|
|
<p>This command removes the tape image catalog entry with a volume name of <b>TAP001</b> from image catalog <b>TAPECLG</b>. The associated image file is deleted from the system.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVIMGCLGE.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPFBC30</b></dt>
|
|
<dd>Catalog entry at index &2 not removed from image catalog &1.
|
|
</dd>
|
|
<dt><b>CPFBC31</b></dt>
|
|
<dd>Catalog entry at index &2 not removed from image catalog &1.
|
|
</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="#RMVIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|