Change Image Catalog Entry (CHGIMGCLGE)

The Change Image Catalog Entry (CHGIMGCLGE) command is used to change the attributes of an image catalog entry.

Restrictions:

This command is shipped with public *EXCLUDE authority.
The following authorities are required to change 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.
4. *USE authority to the virtual device description.
The following parameters are only supported for tape type image catalogs:
1. Image catalog volume (VOL)
2. Image size (IMGSIZ)

Parameters

Keyword	Description	Choices	Notes
IMGCLG	Image catalog	Name	Required, Key, Positional 1
IMGCLGIDX	Image catalog index	1-256, *VOL	Required, Key, Positional 2
VOL	Image catalog volume	Character value	Optional, Key, Positional 3
NEWCLGIDX	New catalog index	1-256, *SAME	Optional
WRTPTC	Write protect	SAME, YES, *NO	Optional
IMGSIZ	Image size	48-1000000, *SAME	Optional
ALCSTG	Allocate storage size	SAME, MIN, *IMGSIZ	Optional
TEXT	Text 'description'	Character value, *SAME	Optional

Top

Image catalog index (IMGCLGIDX)

Specifies the index number of the image catalog entry to be changed.

This is a required parameter.

*VOL: Specifies to change the entry by specifying a volume name. This value is only allowed for tape type image catalogs.
1-256: Specify the image catalog index number to be used.

New catalog index (NEWCLGIDX)

Specifies a new index number to be used for the image catalog entry. If an entry currently exists at the specified index location, the new entry will be inserted and all entries at or below the specified index number will be incremented by 1.

*SAME: The index number will not be changed.
1-256: Specify the image catalog index number to be used.

Write protect (WRTPTC)

Specify whether this catalog entry should be write protected or not. By write protecting this catalog entry, no write operations will be allowed to it. This parameter is not allowed for reference or dependent image catalogs.

*SAME: The value for write protect will not be changed.
*YES: Specifies that this catalog entry is to be write protected. This will prevent write operation from being done to it.
*NO: Specifies that this catalog entry is not to be write protected. This will allow write operations to be done to this catalog entry.

Image size (IMGSIZ)

Specifies the maximum size allowed for this tape image file.

If the specified image size is larger then the current file size then the new maximum size is set and the file size is increased.

If the specified size is smaller than current maximum image size and the data stored in the image file is less than the specified value then the file will be reduced to the specified size otherwise the command will fail.

This parameter is only allowed for tape type image catalogs.

This parameter is not allowed for reference or dependent image catalogs.

*MIN: The allocated image file size is truncated to the size of the data stored in the file.
48-1000000: Specify the maximum number of megabytes allowed for this tape image file.

Allocate storage size (ALCSTG)

Specifies for tape image files, whether to allocate the entire amount of storage specified on the Image size (IMGSIZ) parameter.

This parameter is only allowed for tape type image catalogs.

This parameter is not allowed for reference or dependent image catalogs.

*SAME: The storage allocation for the image file will not be changed.
*MIN: Specifies to change the storage allocation to match the storage required to contain the existing image file data.
*IMGSIZ: Specify to change the storage allocation to be the entire amount of storage for this image file. This is the value that was specified on the Image size (IMGSIZ) parameter of the ADDIMGCLGE command.

Examples

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.

Example 3: Changing the Catalog Entry Write Protection

CHGIMGCLGE   IMGCLG(MYCLG)  IMGCLGIDX(5)  WRTPTC(*YES)

This command write protects the image file associated with image catalog entry 5.

Example 4: Changing the Maximum Size for a Tape Image File

CHGIMGCLGE   IMGCLG(TAPECLG)  IMGCLGIDX(*VOL) VOL(VOL002)
             IMGSIZ(10000)  ALCSTG(*IMGSIZ)

This command will change the maximum allowed size of image file VOL002 to be 10000 megabytes and allocate the 10000 megabytes of storage.