TAA Tools
WRKJRNLIB       WORK JOURNAL LIBRARY                   TAAJRNL

The Work Journal Library  command provides a work display  of data base
files,  data areas, and  data queues  in a  library.  Options  exist to
start   and  end  journaling   of  objects  as   well  as  access  path
journaling.  Options  exist on the command  to select the objects  that
should be  displayed such as by  generic name, the type  of object, and
whether the objects are journaled not journaled.

A typical command would be:

             WRKJRNLIB     LIB(xxx)

All  data  base  files  (except source  files),  data  areas,  and data
queues in  the  specified library  would  be  displayed in  a  subfile.
Options exist  on the subfile  display to  Start and End  journaling or
Access  Path journaling.   These actions  result in command  prompts to
provide a confirmation.

The journal  and  library of  the  first  object found  that  is  being
journaled will  act as the  default journal and  library.  The  default
name  will appear when  the STRJRNPF,  STRJRNAP, or  STRJRNOBJ commands
are  prompted for.  If you change the  journal name, it will become the
new default value.

Security considerations
-----------------------

Normal library security exists.

If the  object is  private, a  non-authorized user  cannot display  any
information about the object.

The user must  have *OBJMGT and *OBJOPR to any journal  to start or end
journaling.

The  user  must  have *OBJMGT  rights  to  an object  to  start  or end
journaling.

Handling of arrival sequence files
----------------------------------

Arrival sequence files  can be  started for  physical file  journaling.
However, it  makes no  sense for access  path journaling  because there
are no keys.

The  system  allows you  start  access path  journaling  on  an arrival
sequence file  and  marks  the  access path  as  being  journaled  even
though nothing actually happens.

The WRKJRNLIB  tool follows  the system  rules and  allows access  path
journaling  to be started  and ended  on arrival sequence  access paths
even though no journaling will occur.

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

   LIB           The  library containing the  objects (data base files,
                 data areas, and data queues) to be considered.

   OBJECT        The object  or  generic object  name to  be  accessed.
                 The  default  is  *ALL  for  all  objects  (data  base
                 files,  data areas, and  data queues)  in the library.
                 The other parameters may be  used to subset the  list.

   OBJTYPE       The  object types  to  be accessed.    The default  is
                 *ALL  for physical and logical  files, data areas, and
                 data queues.

                 *PF may be specified for just physical files.

                 *LF may be specified for just logical files.

                 *DTAARA may be specified for just data areas.

                 *DTAQ may be specified for just data queues.

   JRNOPT        Whether to subset  the list for  whether an object  is
                 journaled or  not.   The default  is *ALL meaning  all
                 objects whether they are journaled or not.

                 *YES  may be  specified  to access  only  objects that
                 are  being  journaled.   Any  type of  file journaling
                 (physical  or  access path)  causes  the  file  to  be
                 selected.

                 *NO may  be specified to access only  objects that are
                 not  being  journaled.   Any type  of  file journaling
                 (physical or access  path) causes the  file not to  be
                 selected.

   SRCOPT        Whether  to include  source files  in the  list.   The
                 default  is *NO  to bypass any  source files.   Source
                 files are not good  candidates for journaling  because
                 SEU causes all records to be changed.

                 *YES may be specified to include source files.

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

None.

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

The following TAA Tools must be on your system:

     ADJVAR          Adjust variable
     EDTVAR2         Edit variable 2
     CHKGENERC       Check generic
     CHKOBJ3         Check object 3
     DSPACCPTH       Display access path
     DSPERRMSG       Display error message
     DSPMBRS         Display members
     FILEFDBCK       File feedback
     RTVDBFA         Retrieve data base file attributes
     RTVOBJJRNA      Retrieve object journal attributes
     RTVPFJRNA       Retrieve physical file journal attributes
     SNDESCMSG       Send escape message
     TAAEXC          TAA Execute command

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

None, the tool is ready to use.

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

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

   WRKJRNLIB     *CMD                   TAAJRNL       QATTCMD
   TAAJRNLC      *PGM       CLP         TAAJRNLC      QATTCL
   TAAJRNLC2     *PGM       CLP         TAAJRNLC2     QATTCL
   TAAJRNLC3     *PGM       CLP         TAAJRNLC3     QATTCL
   TAAJRNLC4     *PGM       CLP         TAAJRNLC4     QATTCL
   TAAJRNLR      *PGM       RPG         TAAJRNLR      QATTRPG
   TAAJRNLD      *FILE      DSPF        TAAJRNLD      QATTDDS

Structure
---------

WRKJRNLIB   Cmd
   TAAJRNLC    CL Pgm - Checks command parameters
   TAAJRNLR    RPG Pgm  - Accesses objects using APIs and displays
     TAAJRNLC2   CL Pgm - Does RTVDBFA and RTVPFJRNA
     TAAJRNLC3   CL Pgm - Does STRJRNPF etc journal cmds plus
                            DSPMBRS, DSPACCPTH
     TAAJRNLC4   CL Pgm - Does RTVOBJJRNA, STRJRNOBJ, ENDJRNOBJ
					

Added to TAA Productivity tools January 1, 1999


Home Page Up to Top