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