Display Optical Locks (DSPOPTLCK)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Display Optical Locks (DSPOPTLCK) command displays a list of locks held on an optical volume, directory, or file. If TYPE(*JOB) is specified, this command displays a list of all jobs currently performing an optical request. The information can be printed or displayed.
This command does not identify any locks to volumes, directories, or files which are in remote optical servers. It also does not identify any jobs which are currently using a remote optical server. Use the Display Optical Server (DSPOPTSVR) command with TYPE(*CONV) specified to determine if any jobs are currently using a remote optical server.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| TYPE | Type | *VOL, *DIR, *FILE, *JOB | Required, Positional 1 |
| VOL | Volume identifier | Character value | Optional, Positional 2 |
| PATH | Path | Character value | Optional |
| OUTPUT | Output | Optional |
| Top |
Type (TYPE)
Specifies the type of locks to be displayed or printed.
- *VOL
- Job information and locks on the specified optical volume are displayed or printed.
- *DIR
- Job information and locks on the specified optical directory are displayed or printed.
- *FILE
- Job information and locks on the specified optical file are displayed or printed.
- *JOB
- Job information and locks on all jobs currently performing optical requests are displayed or printed.
| Top |
Volume identifier (VOL)
Specifies the volume identifier of the optical volume for which the locks are listed.
| Top |
Path (PATH)
Specifies the path name of the directory or file on the volume for which the locks are listed.
Note: This parameter is valid only if TYPE(*DIR) or TYPE(*FILE) is specified.
| Top |
Output (OUTPUT)
Specifies whether the output from the command is shown at the requesting workstation or printed with the job's spooled output.
- *
- Output requested by an interactive job is shown on the display. If the command is run as part of a batch job, the output is printed with the job's spooled output.
- The output is printed with the job's spooled output.
| Top |
Examples
Example 1: Displaying Locks on a File
DSPOPTLCK TYPE(*FILE) VOLUME(VOL001)
PATH('/PAYROLL/JAN1995')
This command displays the locks held on the file JAN1995 in the directory /PAYROLL on the VOL001 volume.
Example 2: Displaying Locks for Active Jobs
DSPOPTLCK TYPE(*JOB)
This command diplays a list of active jobs performing optical requests.
| Top |
| Top |