TAA Tools
DSPEXCLCK       DISPLAY EXCLUSIVE LOCKS                TAAOBLR

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
					

Added to TAA Productivity tools April 15, 2009


Home Page Up to Top