Change Image Catalog (CHGIMGCLG)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Image Catalog (CHGIMGCLG) command is used to change the attributes of an image catalog object (*IMGCLG) in library QUSRSYS.
Restrictions:
- The following authorities are required to change an image catalog:
- Execute (*EXECUTE) authority to library QUSRSYS.
- Change (*CHANGE) authority to the image catalog.
- Execute (*X) authority to each directory in the image catalog path name.
- If the Directory (DIR) parameter is specified, the following additional authorities are required:
- Execute (*X) authority to each directory specified on the DIR parameter.
- Read (*R) and object management (*OBJMGT) authorities to each image file in the specified directory for which there is an entry in the image catalog.
- If IMPORT(*YES) is specified, read (*R) and object management (*OBJMGT)authorities are required to the image catalog object in the directory as specified on the Directory (DIR) parameter.
- A directory can only be associated with a single image catalog.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| IMGCLG | Image catalog | Name | Required, Key, Positional 1 |
| WRTPTC | Write protect | *SAME, *ALL, *NONE | Optional |
| DIR | Directory | Path name, *SAME | Optional |
| IMPORT | Import image catalog | *NO, *YES | Optional |
| CLGASPTHLD | Catalog ASP threshold | 1-99, *SAME, *CALC, *MAX | Optional |
| ALCSTG | Allocate storage size | *SAME, *IMGSIZ, *MIN | Optional |
| TEXT | Text 'description' | Character value, *SAME, *BLANK | Optional |
| Top |
Image catalog (IMGCLG)
Specifies the image catalog to be changed.
This is a required parameter.
- name
- Specify the name of the image catalog.
| Top |
Write protect (WRTPTC)
Specifies whether to force all catalog entries to be write protected or all entries to not be protected. The image catalog specified on the IMGCLG paramter must not be in ready status.
- *SAME
- The value for the write protect will not be changed.
- *ALL
- The write protect value will be set on for all images.
- *NONE
- The write protect value will be set off for all images.
| Top |
Directory (DIR)
Specifies the directory to be associated with this image catalog.
- *SAME
- The directory will not be changed.
- path-name
- Specify the path name of the directory to be associated with this image catalog.
| Top |
Import image catalog (IMPORT)
Specifies whether to change the catalog by importing the data from the image catalog in the path specified on the Directory (DIR) parameter.
- *NO
- Do not change the catalog by importing the data.
- *YES
- Change the image catalog by importing the data from image catalog object (QIMGCLG) located in the directory specified on the Directory (DIR) parameter.
Note: The values of the Image catalog (IMGCLG), Directory (DIR), and Text description (TEXT) parameters specified on the Change Image Catalog (CHGIMGCLG) command are used for the image catalog. All other values are imported from image catalog object QIMGCLG.
| Top |
Catalog ASP threshold (CLGASPTHLD)
Specifies the auxiliary storage pool (ASP) threshold for this image catalog. For image catalogs residing in QOPT file system, the threshold value is ignored and set to *MAX.
- *SAME
- The ASP threshold will not be changed.
- *CALC
- The maximum storage threshold is calculated. The ASP space to be used by an image catalog virtual volume is the greater of either 95% or 5GB of space remaining in the ASP. The tape operation will stop with an end of media error when the maximum storage threshold for the virtual volume is reached. Adding of a virtual volume will also check for this limit when ALCSTG(*IMGSIZ) is specified.
- *MAX
- The maximum storage available in the location of the image catalog directory will be used by virtual volumes.
- 1-99
- Specify the percent of image catalog directory ASP space to be used by virtual volumes.
| Top |
Allocate storage size (ALCSTG)
Specifies for tape image catalogs, whether to change the storage allocation of image files.
- *SAME
- The storage allocation for the image files associated with the tape image catalog will not be changed.
- *MIN
- The storage allocation for the image files associated with the tape image catalog will be changed to a size required to contain the data in the image file.
- *IMGSIZ
- The storage allocation for the image files associated with the tape image catalog will be changed to match the size of the image files.
| Top |
Text 'description' (TEXT)
Specifies the text that briefly describes the image catalog.
- *SAME
- The text description will not be changed.
- *BLANK
- The text description will be blank.
- character-value
- Specify up to 50 characters of text for this image catalog.
| Top |
Examples
Example 1: Changing the Text Associated with an Image Catalog
CHGIMGCLG IMGCLG(MYCLG) TEXT('New Text')
This command changes the text associated with image catalog MYCLG.
Example 2: Changing the Directory Associated with an Image Catalog
CHGIMGCLG IMGCLG(MYCLG) DIR('/MyDir2')
This command changes the directory associated with image catalog MYCLG to /MyDir2.
Example 3: Changing an Image Catalog by Importing From the Image Catalog Directory
CHGIMGCLG IMGCLG(MYCLG) DIR('/MyDir') IMPORT(*YES)
This command changes image catalog MYCLG in library QUSRSYS and updates the catalog and entry information from the image catalog object in directory /MyDir.
Example 4: Changing the Allocated Size for all Image Files in a Tape Image Catalog
CHGIMGCLG IMGCLG(TAPECLG) ALCSTG(*MIN)
This command will change the size of each image file associated with image catalog TAPECLG to an allocated size required to contain the data.
| Top |
Error messages
*ESCAPE Messages
- CPFBC08
- Image catalog &1 not changed.
- CPFBC45
- Image catalog &1 not found.
- CPF9802
- Not authorized to object &2 in &3.
- CPF9820
- Not authorized to use library &1.
| Top |