CHGIMGCLGE (Change Image Catalog Entry)

CHGIMGCLGE Command syntax diagram

 

Purpose

The Change Image Catalog Entry (CHGIMGCLGE) command is used to change the attributes of an image catalog (*IMGCLG object) entry. Each entry of an image catalog describes a file that contains a copy of an entire CD-ROM or DVD image file. The image catalog can be used as an alternative to loading and unloading a set of optical media.

 

Restrictions

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

 

Required Parameters

IMGCLG

Specifies the name of the image catalog that contains the entry to be changed.

image-catalog-name: Specify the name of the image catalog that contains the entry to be changed.

IMGCLGIDX

Specify an index number from 1 to 64 of the image catalog entry to be changed.

image-catalog-index-number: Specify a new index number from 1 to 64 of catalog entry to be changed.

 

Optional Parameters

NEWCLGIDX

Specify a new index number from 1 to 64. If an entry currently exists at the selected index location then the new entry will be inserted and all entries at or below the selected index number will be moved down.

*SAME: The index number will not be changed.

new-catalog-index-number: Specify an existing index number from 1 to 64 for the selected catalog entry.

TEXT

Specifies the text that briefly describes the image catalog entry being changed.

*SAME: The text description will not be changed.

'text-description': Specify up to 50 characters of text for this image catalog entry.

Examples for CHGIMGCLGE

Example 1: Changing the Catalog Index Number

CHGIMGCLGE  IMGCLG(MYCLG) IMGCLGIDX(5) NEWCLGIDX(2) 

This command changes the index number associated with the selected image catalog entry from 5 to 2.

Example 2: Changing the Catalog Entry Text

CHGIMGCLGE  IMGCLG(MYCLG)  IMGCLGIDX(5) TEXT('MyText')

This command changes the text associated with image catalog entry 5 to MyText.

Error messages for CHGIMGCLGE

*ESCAPE Messages

CPFBC0C

Image catalog entry &1 not changed.

CPFBC40

Not authorized to command &1.

CPFBC41

&1 command failed.