The Display Exclusive Locks command displays or lists the
objects/members that have exclusive locks. This can be a very slow
running command if many physical file objects are specified to be
checked as CVTOBJLCK must be used on each to determine if any members
are locked exclusively. DSPEXCLCK can assist in determining what
cannot be processed because of exclusive locks.
For the best use, an *ALLOBJ user should run the command. If the
user of the command is not authorized to a physical file, the members
cannot be checked.
In most cases, you should avoid a library value of *LIBL, *ALL, or
*IBM as this will cause the QSYS library to be checked which has a
large number of physical files.
You must have *ALLOBJ special authority to use DSPEXCLCK with a
library value of *ALL, *ALLUSR, or *IBM.
A typical command would be:
DSPEXCLCK OBJ(xxx/*ALL)
A listing would be displayed with the objects/members in the named
library that have *EXCL locks.
DSPEXCLCK escape messages you can monitor for
---------------------------------------------
None. Escape messages from based on functions will be re-sent.
DSPEXCLCK Command parameters *CMD
----------------------------
OBJ The qualified name of the object to be listed. A
specific object, a generic name, or *ALL may be
entered.
The default for the qualified name is *LIBL. A
specific library or the special values *USRLIBL,
*CURLIB, *ALL, *ALLUSR, or *IBM may also be entered.
OBJTYPE The type of object to be selected. *ALL is the
default.
For a list of the supported object types, use the
prompter.
OBJATTR The object attribute to be selected such as RPG or
PF. *ALL is the default.
OUTPUT How to output the results. * is the default to
display the spooled file if the command is entered
interactively. The spooled file is deleted after it
is displayed.
If the command is entered in batch or *PRINT is
specified, the spooled file is output and retained.
Restrictions
------------
You must have *ALLOBJ special authority to use DSPEXCLCK with a
library value of *ALL, *ALLUSR, or *IBM.
If the user of the command is not authorized to a physical file, the
members cannot be checked.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
CVTOBJLCK Convert object lock
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
DSPEXCLCK *CMD TAAOBLR QATTCMD
TAAOBLRC *PGM CLP TAAOBLRC QATTCL
TAAOBLRC2 *PGM CLP TAAOBLRC2 QATTCL
TAAOBLRR *PGM RPG TAAOBLRR QATTRPG
|