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

214 lines
6.2 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 (CHGIMGCLG)</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="CHGIMGCLG.Top_Of_Page"></a>
<h2>Change Image Catalog (CHGIMGCLG)</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="#CHGIMGCLG.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGIMGCLG.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGIMGCLG.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGIMGCLG"></a>
<p>The Change Image Catalog (CHGIMGCLG) command is used to change the attributes of an image catalog object (*IMGCLG) in library QUSRSYS.
</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:
<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>If the Directory (DIR) parameter is specified, the following additional authority is required:
<ol>
<li>Execute (*X) authority to each directory specified on the DIR parameter.
</li>
</ol>
</li>
<li>A directory can only be associated with a single image catalog.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGIMGCLG.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="#CHGIMGCLG.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="#CHGIMGCLG.WRTPTC"><b>WRTPTC</b></a></td>
<td valign="top">Write protect</td>
<td valign="top"><b><u>*SAME</u></b>, *ALL, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGIMGCLG.DIR"><b>DIR</b></a></td>
<td valign="top">Directory</td>
<td valign="top"><i>Path name</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGIMGCLG.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGIMGCLG.IMGCLG"></a>
<h3>Image catalog (IMGCLG)</h3>
<p>Specifies the image catalog 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="#CHGIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGIMGCLG.WRTPTC"></a>
<h3>Write protect (WRTPTC)</h3>
<p>Specifies whether to force all catalog entries to be write protected or all entries to not be protected. The image catalog specified on the IMGCLG paramter must not be in ready status.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value for the write protect will not be changed.
</dd>
<dt><b>*ALL</b></dt>
<dd>The write protect value will be set on for all images.
</dd>
<dt><b>*NONE</b></dt>
<dd>The write protect value will be set off for all images.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGIMGCLG.DIR"></a>
<h3>Directory (DIR)</h3>
<p>Specifies the directory to be associated with this image catalog.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The directory will not be changed.
</dd>
<dt><b><i>path-name</i></b></dt>
<dd>Specify the path name of the directory to be associated with this image catalog.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGIMGCLG.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the image catalog.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The text description will not be changed.
</dd>
<dt><b>*BLANK</b></dt>
<dd>The text description will be blank.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify up to 50 characters of text for this image catalog.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGIMGCLG.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Changing the Text Associated with an Image Catalog</b>
</p>
<p>
<pre>
CHGIMGCLG IMGCLG(MYCLG) TEXT('New Text')
</pre>
</p>
<p>This command changes the text associated with image catalog <b>MYCLG</b>.
</p>
<p><b>Example 2: Changing the Directory Associated with an Image Catalog</b>
</p>
<p>
<pre>
CHGIMGCLG IMGCLG(MYCLG) DIR('/MyDir2')
</pre>
</p>
<p>This command changes the directory associated with image catalog <b>MYCLG</b> to <b>/MyDir2</b>.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGIMGCLG.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFBC08</b></dt>
<dd>Image catalog &amp;1 not changed.
</dd>
<dt><b>CPFBC45</b></dt>
<dd>Image catalog &amp;1 not found.
</dd>
<dt><b>CPF9802</b></dt>
<dd>Not authorized to object &amp;2 in &amp;3.
</dd>
<dt><b>CPF9820</b></dt>
<dd>Not authorized to use library &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>