Remove Image Catalog Entry (RMVIMGCLGE)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Remove Image Catalog Entry (RMVIMGCLGE) command removes an image catalog entry from an image catalog object (*IMGCLG) in library QUSRSYS. Optionally, the image files associated with the catalog entry can be deleted from the system.
If the image catalog is currently loaded into a virtual device, an error message is sent and the image is not removed from the image catalog. The Load/Unload Image Catalog (LODIMGCLG) command can be used to unload the current image catalog from the virtual device.
Restrictions:
- The following authorities are required to remove an image catalog entry:
- 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.
- This command is not supported for reference and dependent image catalogs.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| IMGCLG | Image catalog | Name | Required, Positional 1 |
| IMGCLGIDX | Image catalog index | 1-256, *VOL | Required, Positional 2 |
| VOL | Image catalog volume | Character value | Optional |
| KEEP | Keep image file | *YES, *NO | Optional |
| Top |
Image catalog (IMGCLG)
Specify the image catalog that the image is to be removed from.
This is a required parameter.
- name
- Specify the name of the image catalog.
| Top |
Image catalog index (IMGCLGIDX)
Specifies the image catalog index of the entry to be removed.
- 1-256
- Specify the image catalog index number to be used.
- *VOL
- Remove the entry by specifying a volume name.
| Top |
Image catalog volume (VOL)
Specifies the volume name of the entry to be removed.
- name
- Specify the volume name of the entry to be removed. For optical image catalogs, the first volume that matches the volume specified will be removed.
| Top |
Keep image files (KEEP)
Specifies whether the image associated with the image catalog entry is to be kept.
- *YES
- The image associated with the image catalog entry will not be deleted from the system.
- *NO
- The image file associated with the image catalog entry will be deleted from the system.
| Top |
Examples
Example 1: Removing an Image Catalog Entry
RMVIMGCLGE IMGCLG(MYCLG) IMGCLGIDX(2)
This command removes the image catalog entry at index 2 from image catalog MYCLG. The associated image is not deleted.
Example 2: Remove an Image Catalog Entry and Delete the Image File
RMVIMGCLGE IMGCLG(MYCLG) IMGCLGIDX(1) KEEP(*NO)
This command removes the image catalog entry at index 1 from image catalog MYCLG. The associated image file is deleted from the system.
Example 3: Removing a Tape Image Catalog Entry by Volume Name
RMVIMGCLGE IMGCLG(TAPECLG) IMGCLGIDX(*VOL) VOL(TAP001)
KEEP(*NO)
This command removes the tape image catalog entry with a volume name of TAP001 from image catalog TAPECLG. The associated image file is deleted from the system.
| Top |
Error messages
*ESCAPE Messages
- CPFBC30
- Catalog entry at index &2 not removed from image catalog &1.
- CPFBC31
- Catalog entry at index &2 not removed from image catalog &1.
- CPFBC45
- Image catalog &1 not found.
- CPF9802
- Not authorized to object &2 in &3.
- CPF9820
- Not authorized to use library &1.
| Top |