CL Command Reference - CRTIMGCLG

CL Command List > CRTIMGCLG Reference

Description:

The Create Image Catalog (CRTIMGCLG) command is used to create an image catalog object (*IMGCLG) in library QUSRSYS and associate the image catalog with a target directory. An image catalog can be associated with a virtual optical or virtual tape device.

An image catalog contains information about images that have been added to the image catalog using the Add Image Catalog Entry (ADDIMGCLGE) command. The image catalog contains the following information:

Directory name
The directory where the image files will reside.

Device name
The device name of the virtual device associated with the image catalog.

Catalog Status
The current status of the image catalog and its association with a virtual device.

The image catalog contains the following information for each entry:

Image file name
The name of the image file.

Volume identifier or name
The formatted name of the optical or tape volume that image file represents.

Index number
The order of this image within the image catalog.

Text
A short description of the image.

Restrictions:

. This command is shipped with public *EXCLUDE authority.

. The following authorities are required to create an image catalog:
1. Read (*READ) and Add (*ADD) authority to library QUSRSYS.
2. Execute (*X) authority to each directory in the image catalog path name.
3. If the REFIMGCLG parameter is specified, the following additional authorities are required:
a. *USE authority to the reference image catalog.
b. *EXECUTE authority to library QUSRSYS.

. A directory can only be associated with a single image catalog.

. If DIR(*REFIMGCLG) is specified, the catalog defined by the REFIMGCLG parameter must not be in ready status.

. The following file-systems are supported for the image catalog directory:
1. ¡åroot¡å (/)
2. QOpenSys
3. User_defined file systems (UDFSs) that support *TYPE2 files.


Examples:

Example 1: Creating an Image Catalog

CRTIMGCLG IMGCLG(MYCLG) DIR(¡¯/MyDir¡¯)

This command creates optical type image catalog MYCLG in library QUSRSYS and associates directory /Mydir with it.



Example 2: Creating an Image Catalog Using a Reference Image Catalog

CRTIMGCLG IMGCLG(MYCLG) DIR(*REFIMGCLG) REFIMGCLG(MYCLG2)

This command creates optical type image catalog MYCLG, based on image catalog MYCLG2 in library QUSRSYS and associates the directory specified in image catalog MYCLG2 with it.



Example 3: Creating a Tape Type Image Catalog

CRTIMGCLG IMGCLG(TAPECLG) DIR(¡¯/TapeDir¡¯) TYPE(*TAP)

This command creates tape type image catalog TAPECLG in library QUSRSYS and associates directory /TapeDir with it.