RMVIMGCLGE (Remove Image Catalog Entry)

RMVIMGCLGE Command syntax diagram

 

Purpose

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

If the image catalog is currently loaded into a virtual optical 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 optical device.

Restriction:

1. You must have *SECADM and *ALLOBJ special authorities to use this command.

 

Required Parameters

IMGCLG

Specifies the image catalog name that the image is to be removed from.

image-catalog-name: Specify the catalog name that the image is to be removed from.

IMGCLGIDX

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

image-catalog-index-number: Specify an index number from 1 to 64.

 

Optional Parameters

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 be 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 for RMVIMGCLGE

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 optical 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 optical image file is deleted from the system.

Error messages for RMVIMGCLGE

*ESCAPE Messages

CPFBC30

Catalog entry not removed from image catalog &1.

CPFBC40

Not authorized to command &1.

CPFBC41

&1 command failed.