DSPRCDLCK (Display Record Locks)

DSPRCDLCK Command syntax diagram

 

Purpose

The Display Record Locks (DSPRCDLCK) command allows the user to show the current record lock status of a particular database physical file member. This command displays the lock status for a particular relative record number, or the lock status of all locked records in the member.

 

Required Parameters

FILE
Specifies the qualified name of the physical file that contains the member whose record locks are shown on the display.

The name of the physical file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

physical-file-name: Specify the name of the physical file.

 

Optional Parameters

MBR
Specifies the name of the member in the file whose record locks are shown on the display.

*FIRST: The first member in the database file is used.

member-name: Specify the name of the physical file member that is shown.

RCDNBR
Specifies a particular relative record number or all records of a member.

*ALL: The lock status of all records currently locked in a physical file member is shown on the display.

record-number: Specify the number of the record whose lock status is shown on the display.

OUTPUT
Specifies whether the output from the command is shown at the requesting work station or printed with the job's spooled output. More information on this parameter is in commonly used parameters.

*: Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.

*PRINT: The output is printed with the job's spooled output.

Example for DSPRCDLCK

DSPRCDLCK   FILE(MASTER/PAYROLL)  MBR(*FIRST)
  RCDNBR(1)  OUTPUT(*)

This command shows the lock status of relative record number 1, in the first member of the physical file named PAYROLL in the MASTER library.

Error messages for DSPRCDLCK

*ESCAPE Messages

CPF3130
Member &2 already in use.
CPF3210
File &1 in library &2 not correct type.
CPF3247
Record number &4 does not exist in member &3.
CPF3275
Member &3 file &1 in &2 not found.
CPF7D41
Error occurred while logging order assistance request.
CPF7D42
Error occurred while performing database operation.
CPF9803
Cannot allocate object &2 in library &3.
CPF9810
Library &1 not found.
CPF9812
File &1 in library &2 not found.
CPF9845
Error occurred while opening file &1.
CPF9846
Error while processing file &1 in library &2.
CPF9847
Error occurred while closing file &1 in library &2.
CPF9871
Error occurred while processing.