CL Command Reference - LODIMGCLG
CL Command List > LODIMGCLG Reference
Description:
The Load or Unload Image Catalog (LODIMGCLG) command is used to associate an image catalog and its images to a virtual device. The status of the image catalog 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 to change to Ready. All image catalog entries that are in mounted or loaded status will be loaded in the specified virtual device. The allow save attribute will be set to not allow save for all image catalog files.
*UNLOAD
This will cause the status of the image catalog to change to Not ready. All image catalog entries are removed from the specified virtual device. The allow save attribute will be set to allow save for all image catalog entries.
Only one image catalog can be associated with a virtual device. If the virtual device already has an image catalog associated with it, you can use OPTION(*UNLOAD) to unload the current image catalog.
Restrictions:
. This command is shipped with public *EXCLUDE authority.
. The following authorities are required to load an image catalog:
1. Execute (*EXECUTE) authority to library QUSRSYS.
2. *USE authority to the image catalog.
3. *USE authority to the virtual device description.
4. Execute (*X) authority to each directory in the image catalog path name.
5. If WRTPTC(*ALL) or WRTPTC(*NONE) is specified, the following authority is required:
a. *CHANGE authority to the image catalog.
Examples:
Example 1: Loading an Image Catalog
LODIMGCLG IMGCLG(MYCLG) DEV(OPTVRT01) OPTION(*LOAD)
This command loads image catalog MYCLG into device OPTVRT01. Write protection is set based on the current value for each catalog entry. This example assumes that MYCLG is not a dependent or reference catalog.
Example 2: Loading an Image Catalog as read-only
LODIMGCLG IMGCLG(MYCLG) DEV(OPTVRT01) OPTION(*LOAD)
WRTPTC(*ALL)
This command loads image catalog MYCLG into device OPTVRT01. Write protection is set on for all catalog entries.
Example 3: Unloading an Image Catalog
LODIMGCLG IMGCLG(MYCLG) DEV(OPTVRT01) OPTION(*UNLOAD)
This command unloads image catalog MYCLG from device OPTVRT01.
Example 4: Loading a tape type Image Catalog
LODIMGCLG IMGCLG(MYCLG) DEV(TAPVRT01) OPTION(*LOAD)
This command loads image catalog MYCLG into device TAPVRT01.