Load/Unload/Mount IMGCLG Entry (LODIMGCLGE)

Where allowed to run: All environments (*ALL)
Threadsafe: No

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:

The following authorities are required to load an image catalog entry:
1. Execute (*EXECUTE) authority to library QUSRSYS.
2. Use (*USE) authority to the image catalog being loaded or unloaded.
3. Use (*USE) authority to the virtual device description.
4. Execute (*X) authority to each directory in the image catalog path name.
If a device of type 632B and model 003 is specified on the Virtual device (DEV) parameter the command will be restricted to only *MOUNT and *LOAD requests.

Top

Parameters

Keyword	Description	Choices	Notes
IMGCLG	Image catalog	Name, *DEV	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
DEV	Virtual device	Name	Optional

Top

Image catalog (IMGCLG)

Specifies the image catalog to be used.

This is a required parameter.

*DEV: Use the virtual device specified on the Virtual device (DEV) parameter to locate the image catalog image.
name: Specify the name of the image catalog.

Top

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.

Top

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.

Top

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 specified will have its status changed.

Top

Virtual device (DEV)

Specify the name of the virtual device.

name: Specify the name of the virtual device that has an image catalog image or a device type 632B model 003 that has image catalog image loaded from a network file server to be loaded or mounted.

Top

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.

Example 5: Mounting a Optical Image Catalog Entry by Volume

LODIMGCLGE   IMGCLG(*DEV) DEV(OPTVRT01) IMGCLGIDX(1) OPTION(*MOUNT)

This command mounts the optical volume at index 1 of device OPTVRT01.

Top

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.

Top