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

211 lines
7.0 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Verify Image Catalog (VFYIMGCLG)</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="VFYIMGCLG.Top_Of_Page"></a>
<h2>Verify Image Catalog (VFYIMGCLG)</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="#VFYIMGCLG.PARAMETERS.TABLE">Parameters</a><br>
<a href="#VFYIMGCLG.COMMAND.EXAMPLES">Examples</a><br>
<a href="#VFYIMGCLG.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="VFYIMGCLG"></a>
<p>The Verify Image Catalog (VFYIMGCLG) command is used to verify the images in an image catalog based on the value specified in the TYPE parameter. The user can optionally sort the images in install sequence based also on the TYPE parameter.
</p>
<p>A status message will be issued upon successful completion of the command. If the VFYIMGCLG command fails, the Work with Image Catalog Entries (WRKIMGCLGE) command can be used to look at the images and the status of each. The VFYIMGCLG command is intended for verifying images for a complete software upgrade, installation of a PTF, or other types of installs.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>This command is shipped with public *EXCLUDE authority.
</li>
<li>The following authorities are required to verify 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>
</ol>
</li>
<li>This command is only supported for optical type image catalogs.
</li>
<li>This command is not supported for dependent image catalogs.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="VFYIMGCLG.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="#VFYIMGCLG.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="#VFYIMGCLG.TYPE"><b>TYPE</b></a></td>
<td valign="top">Verify type</td>
<td valign="top"><b><u>*UPGRADE</u></b>, *PTF, *OTHER</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#VFYIMGCLG.SORT"><b>SORT</b></a></td>
<td valign="top">Sort image catalog</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#VFYIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="VFYIMGCLG.IMGCLG"></a>
<h3>Image catalog (IMGCLG)</h3>
<p>Specifies the image catalog to be verified.
</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="#VFYIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="VFYIMGCLG.TYPE"></a>
<h3>Verify type (TYPE)</h3>
<p>Specifies the type of image catalog to be verified.
</p>
<dl>
<dt><b><u>*UPGRADE</u></b></dt>
<dd>The optical image catalog to be verified is for a complete software upgrade. The system will verify that the necessary images for a software upgrade exist and can be loaded into the virtual optical device. The following list shows the required images in order for i5/OS:
<ol>
<li>Licensed Internal Code (Required)
</li>
<li>Operating system (Required)
</li>
<li>Library QGPL (Required)
</li>
<li>Library QUSRSYS (Required)
</li>
<li>No-charge options
</li>
<li>No-charge (bonus) licensed programs and options
</li>
<li>Keyed set products
</li>
<li>Single products
</li>
<li>Secondary languages
</li>
<li>Program temporary fixes
</li>
</ol>
</dd>
<dt><b>*PTF</b></dt>
<dd>The optical image catalog to be verified is for a PTF install. The system will verify all PTF volume sets are complete and can be loaded into the virtual device. All non-PTF volumes will be unloaded.
</dd>
<dt><b>*OTHER</b></dt>
<dd>The image catalog to be verified is not for a specific type of install. This option will load the images from the image catalog in the order they exist. There will be no verification or sorting of images.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="VFYIMGCLG.SORT"></a>
<h3>Sort image catalog (SORT)</h3>
<p>Specifies whether the images of this type should be sorted in the order required for a software upgrade or PTF install. If TYPE(*OTHER) is specified, the images in the image catalog are not sorted.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The images in the image catalog are not sorted based on the value specified for the TYPE parameter.
</dd>
<dt><b>*YES</b></dt>
<dd>The images in the image catalog are sorted based on the value specified for the TYPE parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="VFYIMGCLG.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Verify Image Catalog for a software upgrade</b>
</p>
<p>
<pre>
VFYIMGCLG IMGCLG(MYCLG) TYPE(*UPGRADE) SORT(*YES)
</pre>
</p>
<p>This command verifies that image catalog <b>MYCLG</b> contains the necessary files for a software upgrade. If the necessary image files exist, the images will be sorted in the order required for a software upgrade.
</p>
<p><b>Example 2: Verify Image Catalog for applying PTFs</b>
</p>
<p>
<pre>
VFYIMGCLG IMGCLG(MYCLG) TYPE(*PTF)
</pre>
</p>
<p>This command verifies that all required cumulative PTF volumes in image catalog <b>MYCLG</b> are available. No sorting of the images will occur.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="VFYIMGCLG.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFBC20</b></dt>
<dd>Verification for image catalog &amp;1 failed.
</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="#VFYIMGCLG.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>