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
|
