The Load/Unload/Mount Image Catalog Entry (LODIMGCLGE) command is used to change the status of an image catalog entry in an image catalog. The status of the image catalog entry will be changed based on the value specified for the Option (OPTION) parameter as follows:

*LOAD

This will cause the status of the image catalog entry to change to Loaded.

*UNLOAD

This will cause the status of the image catalog entry to change to Unloaded.

*MOUNT

This will cause the status of the image catalog entry to change to Mounted.

Only one image catalog entry can be in a mounted status. If OPTION(*MOUNT) is specified, an existing entry in mounted status will be changed to a loaded status.

Restrictions:

• This command is shipped with public *EXCLUDE authority.
• The following authorities are required to load an image catalog entry:
  1. Execute (*EXECUTE) authority to library QUSRSYS.
  2. *USE authority to the image catalog being loaded or unloaded.
  3. *USE authority to the virtual device description.
  4. Execute (*X) authority to each directory in the image catalog path name.
• The following parameters are only supported for tape type image catalogs:
  1. Image catalog volume (VOL)

Parameters

Keyword	Description	Choices	Notes
IMGCLG	Image catalog	Name	Required, Positional 1
IMGCLGIDX	Image catalog index	1-256, *FIRST, *LAST, *NEXT, *VOL	Optional, Positional 2
OPTION	Option	*MOUNT, *LOAD, *UNLOAD	Optional, Positional 3
VOL	Image catalog volume	Character value	Optional

Top

Image catalog (IMGCLG)

Specifies the image catalog to be used.

This is a required parameter.

name

Specify the name of the image catalog.

Image catalog index (IMGCLGIDX)

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

*FIRST

The first image catalog entry in the image catalog.

*LAST

The last image catalog entry in the image catalog.

*NEXT

The next image catalog entry in loaded status will be mounted. This value is only allowed when OPTION(*MOUNT) is specified.

*VOL

Specifies to load/unload/mount the entry by specifying a volume name.

1-256

Specify the image catalog index number to be used.

Option (OPTION)

Specifies the new status of the image catalog entry.

*MOUNT

The image catalog entry will be mounted into the image catalog.

*LOAD

The image catalog entry will be loaded into the image catalog.

*UNLOAD

The image catalog entry will be unloaded from the image catalog.

Image catalog volume (VOL)

Specifies the volume name of the entry to be unloaded, loaded, or mounted.

name

Specify the volume name of the entry to be unloaded, loaded, or mounted. For optical image catalogs, the first volume that matches the volume specifed will have its status changed.

Examples

Example 1: Mounting an Image Catalog Entry

LODIMGCLGE   IMGCLG(MYCLG)  IMGCLGIDX(*FIRST)  OPTION(*MOUNT)

This command mounts the first image catalog entry in image catalog MYCLG. If there is an image mounted, it will be changed to a loaded status.

Example 2: Loading an Image Catalog Entry

LODIMGCLGE   IMGCLG(MYCLG)  IMGCLGIDX(5)  OPTION(*LOAD)

This command loads the image catalog entry associated with index number 5 in image catalog MYCLG.

Example 3: Unloading an Image Catalog Entry

LODIMGCLGE   IMGCLG(MYCLG)  IMGCLGIDX(*LAST)  OPTION(*UNLOAD)

This command unloads the last image catalog entry in image catalog MYCLG.

Example 4: Mounting a Tape Image Catalog Entry by Volume

LODIMGCLGE   IMGCLG(TAPECLG)  IMGCLGIDX(*VOL)
             VOL(TAP002) OPTION(*MOUNT)

This command mounts the tape image catalog entry associated with volume TAP002 in image catalog TAPECLG.

Error messages

*ESCAPE Messages

CPFBC46

Catalog entry at index &1 not loaded.

CPFBC47

Catalog entry at index &1 not unloaded.

CPFBC48

Catalog entry at index &1 not mounted.

CPFBC0D

Catalog entry at index &1 not loaded.

CPFBC0E

Catalog entry at index &1 not unloaded.

CPFBC0F

Catalog entry at index &1 not mounted.

CPFBC45

Image catalog &1 not found.

CPF9802

Not authorized to object &2 in &3.

CPF9820

Not authorized to use library &1.