Create Image Catalog (CRTIMGCLG)

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.
Image file status: The status of the image within the virtual device.
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:
  1. *USE authority to the reference image catalog.
  2. *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.

Parameters

Keyword	Description	Choices	Notes
IMGCLG	Image catalog	Name	Required, Positional 1
DIR	Directory	Path name, *REFIMGCLG	Required, Positional 2
TYPE	Image catalog type	OPT, TAP	Optional, Positional 3
CRTDIR	Create directory	YES, NO	Optional
REFIMGCLG	Reference image catalog	Name	Optional
TEXT	Text 'description'	Character value, *BLANK	Optional
AUT	Authority	Name, EXCLUDE, LIBCRTAUT, CHANGE, ALL, *USE	Optional

Top

Directory (DIR)

Specifies the directory to be associated with this image catalog.

This is a required parameter.

path-name: Specify the path name of the directory for the image catalog. If symbolic links exist in the path name, the links will be resolved and the absolute path will be used.
*REFIMGCLG: Specify the name of another image catalog as a reference for the new image catalog.
Note: The requirements for catalogs created using the *REFIMGCLG parameter are complex with respect to the limitations and supported uses. For details see the Storage solutions topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

Create directory (CRTDIR)

Specifies whether the directory (DIR parameter) should be created if it doesn't exist.

*YES

The directory will be created if it does not exist. The created directory will have the following default authorities:

                Data            Object Authorities
User         Authority     Exist  Mgt  Alter  Ref
*PUBLIC        *EXCLUDE
Owner          *RWX          X     X     X     X

For all other attributes, the defaults as provided on the CRTDIR command are chosen.

*NO

The directory will not be created.

Reference image catalog (REFIMGCLG)

Specifies the name of the image catalog as a reference for the new image catalog. The new dependent image catalog will contain the image catalog entries that exist in the reference image catalog at the time the dependent image catalog is created. Any additional changes to the reference image catalog will not be reflected in the dependent image catalog.

This parameter is valid only when DIR(*REFIMGCLG) is specified.

name: Specify the name of the reference image catalog.

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

*EXCLUDE: The user cannot access the object.

*LIBCRTAUT: The system determines the authority for the object by using the value specified for the Create authority (CRTAUT) parameter on the Create Library command (CRTLIB) for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.

*USE: The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.

name: Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

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.