TAA Tools
CVTRCDLCK       CONVERT RECORD LOCKS                   TAAJOGG

The Convert  Record Locks command  converts the  record locks from  all
jobs  holding record locks  on a specific  file/member.  You  must have
*JOBCTL  special authority  to use CVTRCDLCK.   The  outfile is created
new each time with  a name of RCDLCKP  using a format name of  RCDLCKR.
The model file TAADBJMP in TAATOOL is used.

If the  file RCDLCKP file  and member do  not exist, they  are created.
If they do exist, the member is cleared.

See  the CVTRCDLCK2 command to convert the  record locks for a specific
job.

A typical command would be:

             CVTRCDLCK    FILE(ABC) MBR(*FIRST) OUTLIB(QTEMP)

All jobs  with  a  lock on  the  first  member  of file  ABC  would  be
accessed.  Those jobs  holding a DATA lock on the member  would then be
used  by CVTRCDLCK2 to  convert any record  locks they may  hold to the
outfile RCDLCKP  in  QTEMP.    If  the  RCDLCKP  file  and  member  had
previously existed in QTEMP, they would be cleared.

CVTRCDLCK escape messages you can monitor for
---------------------------------------------

      TAA9891    There are no record locks held
      TAA9892    There are no record locks on the file/member

Escape messages from based on functions will be re-sent.

CVTRCDLCK Command parameters                          *CMD
----------------------------

   FILE          The  qualified name  of  the  file to  convert  record
                 locks for.   The library  value defaults to  *LIBL.  A
                 specific library or *CURLIB may also be used.

   OUTLIB        The   library  in  which  the  file  RCDLCKP  will  be
                 placed.  The  default is *LIBL.   If the RCDLCKP  file
                 does not  already exist, a library  must be specified.

                 The  model file  used is  TAADBJMP with a  format name
                 of RCDLCKR.

   OUTMBR        The member  of  the RCDLCKP  file  to  be used.    The
                 default is  RCDLCKP.   If the  member does not  exist,
                 it is  added.  If the member  does exist, any existing
                 data is cleared before any records are added.

   MBR           The member to  convert record  locks for.   *FIRST  is
                 the default.   A specific member name may  be entered.


Restrictions
------------

You must have *JOBCTL special authority to use CVTRCDLCK.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKJOBCTL       Check *JOBCTL special authority
     CHKOBJ3         Check object 3
     CVTOBJLCK       Convert object lock
     CVTRCDLCK2      Convert record lock 2
     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVDAT          Retrieve date
     RTVDBFA         Retrieve data base file attributes
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CVTRCDLCK     *CMD                   TAAJOGG       QATTCMD
   TAAJOGGC      *PGM       CLP         TAAJOGGC      QATTCL
					

Added to TAA Productivity tools July 15, 2013


Home Page Up to Top