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:
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.
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
The user must have *OBJMGT rights to an object to start or end
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
*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
*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
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.
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
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
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
TAAJRNLC4 CL Pgm - Does RTVOBJJRNA, STRJRNOBJ, ENDJRNOBJ