WRKJRNLIB -- Work Journal Library

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

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