WRKOPTDIR (Work with Optical Directories)

WRKOPTDIR Command syntax diagram

 

Purpose

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 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).

 

Optional Parameters

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.

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

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.

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.

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.

Example for WRKOPTDIR

WRKOPTDIR   VOL(VOL01)

This command displays a list of all optical directories on the volume VOL01 sorted by the date they were created.

Error messages for WRKOPTDIR

*ESCAPE Messages

OPT1205

Directory not found.

OPT1215

Directory cannot be deleted.

OPT1317

Directory name is too long.

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.

OPT1937

Unable to display all requested files.

OPT2301

Internal system object in use.