337 lines
11 KiB
HTML
337 lines
11 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>Change Image Catalog Entry (CHGIMGCLGE)</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="CHGIMGCLGE.Top_Of_Page"></a>
|
|
<h2>Change Image Catalog Entry (CHGIMGCLGE)</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="#CHGIMGCLGE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGIMGCLGE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGIMGCLGE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGIMGCLGE"></a>
|
|
<p>The Change Image Catalog Entry (CHGIMGCLGE) command is used to change the attributes of an image catalog entry.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
|
</li>
|
|
<li>The following authorities are required to change 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>
|
|
<li>*USE authority to the virtual device description.
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
<li>The following parameters are only supported for tape type image catalogs:
|
|
<ol>
|
|
<li>Image catalog volume (VOL)
|
|
</li>
|
|
<li>Image size (IMGSIZ)
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGIMGCLGE.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="#CHGIMGCLGE.IMGCLG"><b>IMGCLG</b></a></td>
|
|
<td valign="top">Image catalog</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Key, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGIMGCLGE.IMGCLGIDX"><b>IMGCLGIDX</b></a></td>
|
|
<td valign="top">Image catalog index</td>
|
|
<td valign="top">1-256, *VOL</td>
|
|
<td valign="top">Required, Key, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGIMGCLGE.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, Key, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGIMGCLGE.NEWCLGIDX"><b>NEWCLGIDX</b></a></td>
|
|
<td valign="top">New catalog index</td>
|
|
<td valign="top">1-256, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGIMGCLGE.WRTPTC"><b>WRTPTC</b></a></td>
|
|
<td valign="top">Write protect</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGIMGCLGE.IMGSIZ"><b>IMGSIZ</b></a></td>
|
|
<td valign="top">Image size</td>
|
|
<td valign="top">48-1000000, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGIMGCLGE.ALCSTG"><b>ALCSTG</b></a></td>
|
|
<td valign="top">Allocate storage size</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *MIN, *IMGSIZ</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGIMGCLGE.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGIMGCLGE.IMGCLG"></a>
|
|
<h3>Image catalog (IMGCLG)</h3>
|
|
<p>Specify the image catalog that contains the image to be changed.
|
|
</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="#CHGIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGIMGCLGE.IMGCLGIDX"></a>
|
|
<h3>Image catalog index (IMGCLGIDX)</h3>
|
|
<p>Specifies the index number of the image catalog entry to be changed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*VOL</b></dt>
|
|
<dd>Specifies to change the entry by specifying a volume name. This value is only allowed for tape type image catalogs.
|
|
</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="#CHGIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGIMGCLGE.VOL"></a>
|
|
<h3>Image catalog volume (VOL)</h3>
|
|
<p>Specifies the volume name of the entry to be changed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the volume name of the entry to be changed. For optical image catalogs, the first volume that matches the volume specifed will be changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGIMGCLGE.NEWCLGIDX"></a>
|
|
<h3>New catalog index (NEWCLGIDX)</h3>
|
|
<p>Specifies a new index number to be used for the image catalog entry. If an entry currently exists at the specified index location, the new entry will be inserted and all entries at or below the specified index number will be incremented by 1.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The index number will not be changed.
|
|
</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="#CHGIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGIMGCLGE.WRTPTC"></a>
|
|
<h3>Write protect (WRTPTC)</h3>
|
|
<p>Specify whether this catalog entry should be write protected or not. By write protecting this catalog entry, no write operations will be allowed to it. This parameter is not allowed for reference or dependent image catalogs.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value for write protect will not be changed.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Specifies that this catalog entry is to be write protected. This will prevent write operation from being done to it.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Specifies that this catalog entry is not to be write protected. This will allow write operations to be done to this catalog entry.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGIMGCLGE.IMGSIZ"></a>
|
|
<h3>Image size (IMGSIZ)</h3>
|
|
<p>Specifies the maximum size allowed for this tape image file.
|
|
</p>
|
|
<p>If the specified image size is larger then the current file size then the new maximum size is set and the file size is increased.
|
|
</p>
|
|
<p>If the specified size is smaller than current maximum image size and the data stored in the image file is less than the specified value then the file will be reduced to the specified size otherwise the command will fail.
|
|
</p>
|
|
<p>This parameter is only allowed for tape type image catalogs.
|
|
</p>
|
|
<p>This parameter is not allowed for reference or dependent image catalogs.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MIN</u></b></dt>
|
|
<dd>The allocated image file size is truncated to the size of the data stored in the file.
|
|
</dd>
|
|
<dt><b><i>48-1000000</i></b></dt>
|
|
<dd>Specify the maximum number of megabytes allowed for this tape image file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGIMGCLGE.ALCSTG"></a>
|
|
<h3>Allocate storage size (ALCSTG)</h3>
|
|
<p>Specifies for tape image files, whether to allocate the entire amount of storage specified on the Image size (IMGSIZ) parameter.
|
|
</p>
|
|
<p>This parameter is only allowed for tape type image catalogs.
|
|
</p>
|
|
<p>This parameter is not allowed for reference or dependent image catalogs.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The storage allocation for the image file will not be changed.
|
|
</dd>
|
|
<dt><b>*MIN</b></dt>
|
|
<dd>Specifies to change the storage allocation to match the storage required to contain the existing image file data.
|
|
</dd>
|
|
<dt><b>*IMGSIZ</b></dt>
|
|
<dd>Specify to change the storage allocation to be the entire amount of storage for this image file. This is the value that was specified on the <b>Image size (IMGSIZ)</b> parameter of the ADDIMGCLGE command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGIMGCLGE.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the image catalog entry being changed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The text description will not be changed.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify up to 50 characters of text for this image catalog entry.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGIMGCLGE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Changing the Catalog Index Number</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGIMGCLGE IMGCLG(MYCLG) IMGCLGIDX(5) NEWCLGIDX(2)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the index number associated with the selected image catalog entry from <b>5</b> to <b>2</b>.
|
|
</p>
|
|
<p><b>Example 2: Changing the Catalog Entry Text</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGIMGCLGE IMGCLG(MYCLG) IMGCLGIDX(5) TEXT('MyText')
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the text associated with image catalog entry <b>5</b> to <b>MyText</b>.
|
|
</p>
|
|
<p><b>Example 3: Changing the Catalog Entry Write Protection</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGIMGCLGE IMGCLG(MYCLG) IMGCLGIDX(5) WRTPTC(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command write protects the image file associated with image catalog entry <b>5</b>.
|
|
</p>
|
|
<p><b>Example 4: Changing the Maximum Size for a Tape Image File</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGIMGCLGE IMGCLG(TAPECLG) IMGCLGIDX(*VOL) VOL(VOL002)
|
|
IMGSIZ(10000) ALCSTG(*IMGSIZ)
|
|
</pre>
|
|
</p>
|
|
<p>This command will change the maximum allowed size of image file <b>VOL002</b> to be 10000 megabytes and allocate the 10000 megabytes of storage.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGIMGCLGE.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPFBC0B</b></dt>
|
|
<dd>Catalog entry &2 in image catalog &1 not changed.
|
|
</dd>
|
|
<dt><b>CPFBC0C</b></dt>
|
|
<dd>Catalog entry &2 in image catalog &1 not changed.
|
|
</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="#CHGIMGCLGE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|