CRTIMGCLG (Create Image Catalog)

CRTIMGCLG Command syntax diagram

 

Purpose

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 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 reside
Image file name
The name of the image file
Index number
The order of this image within the image catalog
Status
The status of the image within the virtual optical device
Text
A short description of the image

 

Restrictions

  1. You must have *SECADM and *ALLOBJ special authorities to use this command.
  2. A directory can only be associated with a single image catalog.

 

Required Parameters

IMGCLG
Specifies the name of the image catalog to be created.

image-catalog-name: Specify the name of the image catalog to be created.

DIR
Specifies the name of the directory to be associated with this image catalog.

'directory-name': Specify the name of the directory to be associated with this image catalog.

 

Optional Parameters

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

*NO: The directory will not be created.

*YES: The directory will be created.

TEXT
Specifies the text that briefly describes the image catalog being created.

*BLANK: The text description will be blank.

'text-description': Specify up to 50 characters of text for this image catalog.

AUT
Specifies the authority given to users who do not have specific authority to the library, who are not on an authorization list, and whose user group has no specific authority to the image catalog.

*EXCLUDE: The user cannot access the image catalog.

*LIBCRTAUT: The authority for the object is the same as the create authority for QSYS. The create authority for QSYS can be displayed by using the Display Library Description (DSPLIBD) command. If the create authority is changed with the Change Library (CHGLIB) command, the new authority does not affect existing objects.

*USE: The user can perform basic operations on the image catalog, such as displaying. The user cannot change the image catalog. *USE authority provides object operational authority, read authority, and execute authority.

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

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management 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 image catalog.

authorization-list-name: Specify the name of the authorization list used.

Examples for CRTIMGCLG

Example 1: Creating an Image Catalog

CRTIMGCLG  IMGCLG(MYCLG)  DIR('/MyDir')

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

Error messages for CRTIMGCLG

*ESCAPE Messages

CPFBC00
Image catalog &1 not created.
CPFBC40
Not authorized to command &1.
CPFBC41
&1 command failed.