The Remove Image Catalog Entry (RMVIMGCLGE) command removes an image catalog entry from an image catalog object (*IMGCLG) in library QUSRSYS. Optionally, the image files associated with the catalog entry can be deleted from the system.

If the image catalog is currently loaded into a virtual device, an error message is sent and the image is not removed from the image catalog. The Load/Unload Image Catalog (LODIMGCLG) command can be used to unload the current image catalog from the virtual device.

Restrictions:

• This command is shipped with public *EXCLUDE authority.
• The following authorities are required to remove an image catalog entry:
  1. Execute (*EXECUTE) authority to library QUSRSYS.
  2. *CHANGE authority to the image catalog.
  3. Execute (*X) authority to each directory in the image catalog path name.
• This command is not supported for reference and dependent image catalogs.

Parameters

Keyword	Description	Choices	Notes
IMGCLG	Image catalog	Name	Required, Positional 1
IMGCLGIDX	Image catalog index	1-256, *VOL	Required, Positional 2
VOL	Image catalog volume	Character value	Optional
KEEP	Keep image file	*YES, *NO	Optional

Top

Image catalog (IMGCLG)

Specify the image catalog that the image is to be removed from.

This is a required parameter.

name

Specify the name of the image catalog.

Image catalog index (IMGCLGIDX)

Specifies the image catalog index of the entry to be removed.

1-256

Specify the image catalog index number to be used.

*VOL

Specifies to remove the entry by specifying a volume name. This value is only allowed for tape type image catalogs.

Image catalog volume (VOL)

Specifies the volume name of the entry to be removed.

name

Specify the volume name of the entry to be removed. For optical image catalogs, the first volume that matches the volume specifed will be removed.

Keep image files (KEEP)

Specifies whether the image associated with the image catalog entry is to be kept.

*YES

Specify that the image associated with the image catalog entry will not be deleted from the system.

*NO

Specify that the image file associated with the image catalog entry will be deleted from the system.

Examples

Example 1: Removing an Image Catalog Entry

RMVIMGCLGE   IMGCLG(MYCLG)  IMGCLGIDX(2)

This command removes the image catalog entry at index 2 from image catalog MYCLG. The associated image is not deleted.

Example 2: Remove an Image Catalog Entry and Delete the Image File

RMVIMGCLGE   IMGCLG(MYCLG)  IMGCLGIDX(1)  KEEP(*NO)

This command removes the image catalog entry at index 1 from image catalog MYCLG. The associated image file is deleted from the system.

Example 3: Removing a Tape Image Catalog Entry by Volume Name

RMVIMGCLGE   IMGCLG(TAPECLG)  IMGCLGIDX(*VOL) VOL(TAP001)
             KEEP(*NO)

This command removes the tape image catalog entry with a volume name of TAP001 from image catalog TAPECLG. The associated image file is deleted from the system.

Error messages

*ESCAPE Messages

CPFBC30

Catalog entry at index &2 not removed from image catalog &1.

CPFBC31

Catalog entry at index &2 not removed from image catalog &1.

CPFBC45

Image catalog &1 not found.

CPF9802

Not authorized to object &2 in &3.

CPF9820

Not authorized to use library &1.