TAA Tools
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


Home Page Up to Top