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:

1. To use this command you must have at least *USE authority to the authorization list securing the volumes containing the optical directories.
2. You must have *CHANGE authority to create, copy, or delete optical directories.
3. 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).

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.

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.

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.

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.

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.

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.

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.