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

186 lines
5.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>Work with Image Catalogs (WRKIMGCLG)</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="WRKIMGCLG.Top_Of_Page"></a>
<h2>Work with Image Catalogs (WRKIMGCLG)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#WRKIMGCLG.PARAMETERS.TABLE">Parameters</a><br>
<a href="#WRKIMGCLG.COMMAND.EXAMPLES">Examples</a><br>
<a href="#WRKIMGCLG.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="WRKIMGCLG"></a>
<p>The Work with Image Catalogs (WRKIMGCLG) command is used to work with the image catalogs that exist on the system. This command allows the user to specify a specific catalog name, a generic name, or *ALL. The WRKIMGCLG command allows the user to perform the following functions on the image catalogs:
</p>
<dl>
<dt><b>Create</b></dt>
<dd>This option allows the user to create a new image catalog.
</dd>
<dt><b>Change</b></dt>
<dd>This option allows the user to change the attributes of the image catalog.
</dd>
<dt><b>Delete</b></dt>
<dd>This option allows the user to delete the image catalog. All image files associated with the image catalog will also be deleted.
</dd>
<dt><b>Load</b></dt>
<dd>This option allows the user to load the image catalog into a virtual device.
</dd>
<dt><b>Unload</b></dt>
<dd>This option allows the user to unload the image catalog from the virtual device.
</dd>
<dt><b>Verify</b></dt>
<dd>This option allows the user to verify the image catalog for a software upgrade or PTF install.
</dd>
<dt><b>Work with entries</b></dt>
<dd>This option allows the user to work with the image catalog entries in the image catalog.
</dd>
</dl>
<p><b>Restrictions:</b>
</p>
<ul>
<li>This command is shipped with public *EXCLUDE authority.
</li>
<li>The following authorities are required to view information about each image catalog that match the criteria as specified on the IMGCLG and TYPE parameter:
<ol>
<li>Execute (*EXECUTE) authority to library QUSRSYS.
</li>
<li>*USE authority to the image catalog.
</li>
</ol>
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKIMGCLG.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="#WRKIMGCLG.IMGCLG"><b>IMGCLG</b></a></td>
<td valign="top">Image catalog</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#WRKIMGCLG.TYPE"><b>TYPE</b></a></td>
<td valign="top">Image catalog type</td>
<td valign="top"><b><u>*ALL</u></b>, *OPT, *TAP</td>
<td valign="top">Optional, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#WRKIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="WRKIMGCLG.IMGCLG"></a>
<h3>Image catalog (IMGCLG)</h3>
<p>Specifies the image catalogs to be shown.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All image catalogs are shown.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the image catalogs to be shown. A generic name is a character string that contains one or more characters followed by an asterisk (*). If a generic name is specified, all image catalogs that have names with the same prefix as the generic name are shown.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the image catalog to be shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKIMGCLG.TYPE"></a>
<h3>Image catalog type (TYPE)</h3>
<p>Specifies the type of image catalog to work with.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Specifies to list all types of image catalogs.
</dd>
<dt><b>*OPT</b></dt>
<dd>Specifies to list only optical type image catalogs.
</dd>
<dt><b>*TAP</b></dt>
<dd>Specifies to list only tape type image catalogs.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKIMGCLG.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Working with Image Catalogs by Generic Name</b>
</p>
<p>
<pre>
WRKIMGCLG IMGCLG(UPGRADE*)
</pre>
</p>
<p>This command displays the Work with Image Catalog panel showing all image catalogs whose names begin with <b>UPGRADE</b>.
</p>
<p><b>Example 2: Working with All Image Catalogs</b>
</p>
<p>
<pre>
WRKIMGCLG IMGCLG(*ALL)
</pre>
</p>
<p>This command displays the Work with Image Catalog panel showing all image catalogs that exist.
</p>
<p><b>Example 3: Working with All Tape Type Image Catalogs</b>
</p>
<p>
<pre>
WRKIMGCLG IMGCLG(*ALL) TYPE(*TAP)
</pre>
</p>
<p>This command displays the Work with Image Catalog panel showing all tape type image catalogs that exist.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKIMGCLG.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFBC45</b></dt>
<dd>Image catalog &amp;1 not found.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>