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.

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.

Restrictions:

• This command is shipped with public *EXCLUDE authority.
• The following authorities are required to verify an image catalog:
  1. Execute (*EXECUTE) authority to library QUSRSYS.
  2. *USE authority to the image catalog.
  3. *USE authority to the virtual device description.
  4. Execute (*X) authority to each directory in the image catalog path name.
• This command is only supported for optical type image catalogs.
• This command is not supported for dependent image catalogs.

Parameters

Keyword	Description	Choices	Notes
IMGCLG	Image catalog	Name	Required, Positional 1
TYPE	Verify type	*UPGRADE, *PTF, *OTHER	Optional
SORT	Sort image catalog	*NO, *YES	Optional

Top

Image catalog (IMGCLG)

Specifies the image catalog to be verified.

This is a required parameter.

name

Specify the name of the image catalog.

Verify type (TYPE)

Specifies the type of image catalog to be verified.

*UPGRADE

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:

1. Licensed Internal Code (Required)
2. Operating system (Required)
3. Library QGPL (Required)
4. Library QUSRSYS (Required)
5. No-charge options
6. No-charge (bonus) licensed programs and options
7. Keyed set products
8. Single products
9. Secondary languages
10. Program temporary fixes

*PTF

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.

*OTHER

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.

Sort image catalog (SORT)

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.

*NO

The images in the image catalog are not sorted based on the value specified for the TYPE parameter.

*YES

The images in the image catalog are sorted based on the value specified for the TYPE parameter.

Examples

Example 1: Verify Image Catalog for a software upgrade

VFYIMGCLG   IMGCLG(MYCLG)  TYPE(*UPGRADE)  SORT(*YES)

This command verifies that image catalog MYCLG 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.

Example 2: Verify Image Catalog for applying PTFs

VFYIMGCLG   IMGCLG(MYCLG)  TYPE(*PTF)

This command verifies that all required cumulative PTF volumes in image catalog MYCLG are available. No sorting of the images will occur.

Error messages

*ESCAPE Messages

CPFBC20

Verification for image catalog &1 failed.

CPFBC45

Image catalog &1 not found.

CPF9802

Not authorized to object &2 in &3.

CPF9820

Not authorized to use library &1.