Work with Optical Directories (WRKOPTDIR)
| Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC) Threadsafe: No |
Parameters Examples Error messages |
The Work with Optical Directories (WRKOPTDIR) command displays a list of optical directories and provides options to create, to copy, to delete, and to display or print a list of directories and their attributes. This command also allows you to work with files in the directories.
Restrictions:
- To use this command you must have at least *USE authority to the authorization list securing the volumes containing the optical directories.
- You must have *CHANGE authority to create, copy, or delete optical directories.
- If this command is issued for a directory on an optical volume which is in a remote optical server, only the following can be specified:
- DIR(optical-directory-name)
- VOL(volume-identifier)
- SORT(*DIR)
- SLTLVL(1).
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| DIR | Optical directory | Character value, *ALL | Optional, Positional 1 |
| VOL | Volume identifier | Character value, *ALL | Optional, Positional 2 |
| SORT | Sort by | *DATE, *DIR | Optional, Positional 3 |
| SLTLVL | Select directory level | Integer, 1, *ALL | Optional |
| STRDATE | Starting date | Date, *AVAIL | Optional |
| Top |
Optical directory (DIR)
Specifies the optical directories to be listed.
- *ALL
- All directories in the specified optical volume are listed.
- optical-directory-name
- Specify the name of a directory.
| Top |
Volume identifier (VOL)
Specifies the identifier of the volume that contains the directories specified on the DIR parameter.
- *ALL
- Optical volumes in direct-attached optical devices are listed.
- volume-identifier
- Specify the volume identifier of the volume to search.
| Top |
Sort by (SORT)
Specifies how the output for each volume is sorted.
Note: If the optical volume was initialized as a backup volume, this parameter is ignored.
- *DATE
- The output list is sorted in order by the date that the volume was created, beginning with the most recent date.
- *DIR
- The output list is sorted in alphabetical order by directory name.
| Top |
Select directory level (SLTLVL)
Specifies the number of levels of the directory structure to include in the list when SORT(*DIR) is specified.
Note: If the optical volume was initialized as a backup volume, this parameter is ignored.
- 1
- Only first level directories are listed.
- *ALL
- All directories are listed.
- select-directory-level
- Specify the number of subdirectory levels for the specified directory. Valid values range from 1 through 32767.
| Top |
Starting date (STRDATE)
Specifies the starting date for the list when SORT(*DATE) is specified. Only directories created on or before the starting date are listed.
Note: If the optical volume was initialized as a backup volume, this parameter is ignored.
- *AVAIL
- The directories created on all available dates are included in the output list.
- starting-date
- Specify the starting date.
| Top |
Examples
WRKOPTDIR VOL(VOL01)
This command displays the Work with Optical Directories panel, showing a list of all optical directories on the volume VOL01 sorted by the date they were created.
| Top |
Error messages
*ESCAPE Messages
- OPT1205
- Directory not found.
- OPT1215
- Directory cannot be deleted.
- OPT1317
- Directory name is too long.
- OPT1320
- Optical volume &1 in use.
- OPT1325
- Optical volume format not recognized.
- OPT1331
- Optical volume &1 not found.
- OPT1340
- Optical volume &1 not initialized.
- OPT1805
- Error accessing optical volume index file.
- OPT1810
- Error accessing optical directory index file.
- OPT1815
- Internal program error occurred.
- OPT2301
- Internal system object in use.
*STATUS Messages
- OPT1937
- Unable to display all requested files.
| Top |