CL Command Reference - CHKOPTVOL

CL Command List > CHKOPTVOL Reference

Description:

The Check Optical Volume (CHKOPTVOL) command will validate that all directories and files on the volume can be read. If all directories and file data can be read successfully, the command will complete with no errors and the OUTPUT parameter specified determines whether or not to print a list of files and the number of bytes used. If any directory cannot be successfully read the command will complete in error with no output. If the directories can be read but all file data cannot be read, the command will complete in error and the OUTPUT parameter specified determines whether or not to print a list of damaged files, the number of files that are not damaged, and the number of bytes occupied for each.

Restrictions:

1. To use this command you must have *USE authority to the authorization list securing the volume.

2. If this command is being used to check a volume with the Universal Disk Format (UDF), the user must have *RWX authority to the volume root directory.


Examples:

Example 1: Check an Optical Volume

CHKOPTVOL VOL(VOL01) OUTPUT(*ERROR)

This command checks the directories and files on VOL01. If any damaged files are found the file names are printed to the jobĄ¯s spooled output.



Example 2: Check an Optical Volume and Print the Results to the JobĄ¯s Spooled Output

CHKOPTVOL VOL(VOL01) OUTPUT(*PRINT)

This command checks the directories and files on VOL01 and prints a list of damaged files, the number of files that are not damaged, and the number of bytes occupied for each.



Example 3: Check Optical Volumes Using a Generic Volume Identifier

CHKOPTVOL VOL(PAY*) OUTPUT(*ERROR) DEV(*ALL)

This command checks the directories and files on all volumes in all optical devices that start with PAY. Spooled output created only if error occurs.



Example 4: Check all Optical Volumes in an Optical Media Library

CHKOPTVOL VOL(*ALL) OUTPUT(*ERROR) DEV(OPTMLB01)

This command checks the directories and files on all volumes in optical media library OPTMLB01.