Work with Image Catalogs (WRKIMGCLG)

Work with Image Catalogs (WRKIMGCLG)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)

Threadsafe: No

Parameters

Examples

Error messages

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:

Create
This option allows the user to create a new image catalog.
Change
This option allows the user to change the attributes of the image catalog.
Delete
This option allows the user to delete the image catalog. All image files associated with the image catalog will also be deleted.
Load
This option allows the user to load the image catalog into a virtual device.
Unload
This option allows the user to unload the image catalog from the virtual device.
Verify
This option allows the user to verify the image catalog for a software upgrade or PTF install.
Work with entries
This option allows the user to work with the image catalog entries in the image catalog.

Restrictions:

  • The following authorities are required to view information about an image catalog:
    1. Execute (*EXECUTE) authority to library QUSRSYS.
    2. Use (*USE) authority to the image catalog.

Parameters

Keyword Description Choices Notes
IMGCLG Image catalog Generic name, name , *ALL Optional, Positional 1
TYPE Image catalog type *ALL , *OPT, *TAP Optional, Positional 2

Image catalog (IMGCLG)

Specifies the image catalogs to be shown.

This is a required parameter.

*ALL
All image catalogs are shown.
generic-name
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.
name
Specify the name of the image catalog to be shown.

Image catalog type (TYPE)

Specifies the type of image catalog to work with.

*ALL
List all types of image catalogs.
*OPT
List only optical image catalogs.
*TAP
List only tape image catalogs.

Examples

Example 1: Working with Image Catalogs by Generic Name 


WRKIMGCLG   IMGCLG(UPGRADE*)

This command displays the Work with Image Catalog panel showing all image catalogs whose names begin with UPGRADE .

Example 2: Working with All Image Catalogs 


WRKIMGCLG   IMGCLG(*ALL)

This command displays the Work with Image Catalog panel showing all image catalogs that exist.

Example 3: Working with All Tape Image Catalogs 


WRKIMGCLG   IMGCLG(*ALL) TYPE(*TAP)

This command displays the Work with Image Catalog panel showing all tape image catalogs that exist.

Error messages

*ESCAPE Messages

CPFBC45
Image catalog &1 not found.