TAA Tools
STRJRNLIB2      START JOURNAL LIBRARY 2                TAAJRNO

The Start Journal  Library 2 command  provides a solution  for starting
journaling to  all or generic named files, data  areas, and data queues
in  a library.  The command may also  be used to ensure all appropriate
objects are journaled  in a consistent  manner.  The companion  command
End  Library Journal  ends journaling.    An option  exists for  access
path journaling.

The  system added STRJRNLIB/ENDJRNLIB  in V6R1M0 thus  causing a rename
of  the previous  TAA  Tool  and  commands.    The  system  version  is
similar.

A typical command would be:

             STRJRNLIB2   LIB(ABC) JRN(JRNX)

This would  start journaling  to any  physical files,  data areas,  and
data  queues  in the  library.   Access  path journaling  would  not be
started.

You can  run  the  command  again  to  cause  any  new  objects  to  be
journaled and to check the objects that are being journaled.

The companion command ends journaling such as:

             ENDJRNLIB2   LIB(ABC)

Any access  paths  that were  being journaled  would also  be ended  by
default.

Both the  Start and End  commands are tolerant  of existing conditions.
For  example,  if  STRJRNLIB2  is  used and  one  or  more  objects are
already  being journaled,  no  error  will  occur.   Options  exist  to
ensure  the  existing  journal,  images,  and  'omit  journal  entries'
values are the same as specified on the command.

STRJRNLIB2 escape messages you can monitor for
----------------------------------------------

      TAA9892    Errors were found.  See previous messages
                   such as 'journaling was unable to start' or
                   'a different journal exists for the object'.

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 STRJRNLIB2 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.

Technique used for data base files
----------------------------------

An  outfile is  created of  files, data  area, and  data queues  in the
specified  library.    If  STRJRNAP(*YES)  is  requested,  STRJRNPF  is
attempted against  the physical files.   When  all physical files  have
been processed  and STRJRNAP(*YES) is requested,  STRJRNAP is attempted
against all the data base files.

The  reverse  process  occurs  on ENDJRNLIB2.    That  is,  access path
journaling is ended first for  all files and then physical  journaling.

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

   LIB           The library to be processed for data base files.

   JRN           The qualified  name of  the journal to  be used.   The
                 library  value defaults  to *LIBL.   *CURLIB  may also
                 be used.

                 If the object  is already journaled,  see the  SAMEJRN
                 parameter.

   OBJ           The object  to start journaling  for.  The  default is
                 *ALL  for all  objects in  the  library of  the object
                 type  specified.  A specific  object name or a generic
                 name may be used.

   OBJTYPE       The  object  type  to  start  journaling   for.    The
                 default  is *ALL for  data base  files, data  area and
                 data  queue  objects.   *FILE, *DTAARA,  or  *DTAQ may
                 also be specified.

   STRJRN        Whether  to   start  journaling   for  the   specified
                 objects.  The  default is *YES.  *NO  may be specified
                 if only access path journaling is to be started.

   STRJRNAP      Whether   to  start  access  path   journaling.    The
                 default is *NO.   Only keyed  files will be  attempted
                 to  be  started.    *NO  may   be  specified  if  only
                 physical file journaling is to be started.

   IMAGES        The type  of images to  be journaled.   The default is
                 *AFTER  meaning the after image  of the change.  *BOTH
                 may be  specified for  both before  and after  images.
                 *BOTH   applies  to  data   base  files   and  *DTAARA
                 objects.    *DTAQ  objects only  support  *AFTER  so a
                 *BOTH entry is ignored.

                 If  the   object  is   already  journaled,   see   the
                 SAMEIMAGE parameter.

   OMTJRNE       Whether  to  omit  any  file  journal  entries.    The
                 default   is  *NONE  causing  all   types  of  journal
                 entries to occur.  *OPNCLO  may be specified to  avoid
                 journaling the open and close entries.

                 If the object  is already journaled, see  the SAMEOMIT
                 parameter.

   SRCF          Whether  to  include   or  omit  source  files.    The
                 default  is *OMIT  meaning any  source files  will not
                 be  started   for   journaling.     *INCLUDE  may   be
                 specified  to allow  source  files to  be started  for
                 journaling.

   SAMEJRN       A  *YES/*NO  parameter  for  whether  to  check if  an
                 object  which  is  already  journaled  has  the   same
                 'journal' value  as specified  for the  JRN parameter.
                 The default is *YES to cause checking.

                 *NO may be specified to bypass checking.

   SAMEIMAGE     A  *YES/*NO  parameter  for  whether  to  check if  an
                 object  which  is  already  journaled  has  the   same
                 'images'   value   as   specified   for   the   IMAGES
                 parameter.   Data Queue  objects only  support 'after'
                 images  so the value is ignored.   The default is *YES
                 to cause checking.

                 *NO may be specified to bypass checking.

   SAMEOMIT      A  *YES/*NO parameter  for  whether  to  check  if  an
                 object which  is already journaled has  the same 'omit
                 journal  entries' value  as specified for  the OMTJRNE
                 parameter.    The  OMTJRNE   value  only  exists   for
                 physical  files.    The   default  is  *YES  to  cause
                 checking.

                 *NO may be specified to bypass checking.

   OMIT          A  list  of  up to  90  object/type  entries to  omit.
                 This is  a 2  part  entry of  object name  and  object
                 type.    The   default  is  that  no   object/type  is
                 omitted.

                 The  object type  entered  may be  *DTAARA,  *DTAQ, or
                 *FILE.

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

   LIB           The library to be processed for data base files.

   OBJ           The  objects  to be  processed.   The default  is *ALL
                 for all data base  files, data areas, and  data queues
                 in the  library.   A specific name  or a  generic name
                 may be used.

   OBJTYPE       The  type  of  object  to  end  journaling  for.   The
                 default is *ALL for data  base files, data areas,  and
                 data queues.   *FILE,  *DTAARA, or  *DTAQ may also  be
                 specified.

   ENDJRN        Whether  to  end journaling.    The  default is  *YES.
                 *NO may be  specified if only  access path  journaling
                 is to be ended.

   ENDJRNAP      Whether to  end access path  journaling.   The default
                 is *YES.   *NO may be specified  if only physical file
                 journaling is to be ended.

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

None.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     EDTVAR          Edit variable
     RSNALLMSG       Resend all messages
     RSNLSTMSG       Resend last message
     RTVDBFA         Retrieve data base file attributes
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic 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
   ------        ----    ---------      ----------    ----------

   STRJRNLIB2    *CMD                   TAAJRNO       QATTCMD
   ENDJRNLIB2    *CMD                   TAAJRNO2      QATTCMD
   TAAJRNOC      *PGM       CLP         TAAJRNOC      QATTCL
   TAAJRNOC2     *PGM       CLP         TAAJRNOC2     QATTCL
   TAAJRNOC11    *PGM       CLP         TAAJRNOC11    QATTCL
   TAAJRNOC12    *PGM       CLP         TAAJRNOC12    QATTCL

Structure
---------

STRJRNLIB2  Cmd
   TAAJRNOC   CL Pgm
     TAAJRNOC11  CL Pgm

ENDJRNLIB2  Cmd
   TAAJRNOC2  CL Pgm
     TAAJRNOC12  CL Pgm
					

Added to TAA Productivity tools March 21, 2008


Home Page Up to Top