CL Command Reference - LODIMGCLGE
CL Command List > LODIMGCLGE Reference
Description:
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)
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.