CVTJRNDBF CONVERT JOURNALED DB FILES TAAJROA |
The Convert Journaled Data Base Files command converts the physical
files that are being journaled to a specific journal to an outfile
(CVTJRNP) in a specific library. Each data base record contains the
name and library of the file being journaled. Other tools such as
RTVPFJRNA may be used to retrieve the journal attributes of a
specific file. A Journal API is used internally to access the
journaled files.
The model file used is TAAJROAP with a format name of JRNDBFR.
A typical command would be:
CVTJRNDBF JRN(xxx) OUTLIB(yyy)
The Journal API 'QjoRetrieveJournalInformation' is used to access the
information.
There is no API solution for accessing the files that have been
specified for access path journaling. The CVTJRNA tool uses a
technique of accessing the physical files and then the dependent
files. Each dependent logical file is then checked to see if it is
journaled.
CVTJRNDBF escape messages you can monitor for
---------------------------------------------
None. Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
JRN The qualified name of the journal to convert the
physical files from. Only physical files being
journaled are converted (logical files with
journaled access paths are not converted).
The library value defaults to *LIBL. *CURLIB may
also be used.
OUTLIB The output library for the CVTJRNP file. *LIBL is
the default.
If the file does not exist, a specific library must
be named.
The model file used is TAAJROAP with a format name of JRNDBFR.
REPLACE A *YES/*NO parameter for whether the data in the
CVTJRNP should be cleared before writing any journal
information to the file. The default is *YES.
*NO may be specified to add to existing information
in the file.
Restrictions
------------
A maximum of 250,000 files may be output from a journal.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKOBJ3 Check object 3
CRTDUPPF Create duplicate physical file
EDTVAR Edit variable
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
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
------ ---- --------- ---------- ----------
CVTJRNDBF *CMD TAAJROA QATTCMD
TAAJROAC *PGM CLP TAAJROAC QATTCL
TAAJROAR *PGM RPGLE TAAJROAR QATTRPG
TAAJROAP *FILE PF TAAJROAP QATTDDS
|
Added to TAA Productivity tools February 28, 2000