Displaying and printing journal entries

 

You can use the Display Journal (DSPJRN) command to display journal entries. The entries are displayed at a work station, printed, or written to an output file. You cannot directly access the journal entries in the form in which they are contained in the journal receivers.

The Journal entry information finder describes each type of journal entry and the information that it contains. It also provides links for topics that provide the layouts for the fixed-length portion and the variable-length portion of the journal entry. See the Display Journal (DSPJRN) Command Description for complete layouts for the model database output files that are provided by the system.

Often, to prepare for a recovery, you display or print the journal entries first. The Journal code descriptions provides a description of each code. Use this list to help you analyze the journal entries and to do the following:

• Prepare for the recovery of a particular object. The list contains the information you need to specify the starting and ending points for applying and removing journaled changes.

• Determine the functions that have been performed on the objects that are being journaled (such as save and restore, clear, reorganize).

• Determine the functions that have been performed on the journal (such as attaching new journal receivers).

• Determine the functions that have been performed on the associated journal receivers (such as save and restore).

• Review the activity that has occurred on an object.

• Analyze journal entries for debugging or problem analysis.

• Analyze journal entries for an audit trail.

The DSPJRN command can either selectively list journal entries for a particular object or list entries for all objects within a particular library or directory subtree. You can further identify journal entries by specifying other selection criteria such as:

• Journal entries for specific entry types or journal codes, such as U (user-created entries)

• Journal entries for a particular job, program, or file

• Commit cycle identifier

• Date and time

• Dependent entries (referential integrity, triggers, and entries that will be ignored during an Apply Journaled Changes (APYJRNCHG) or Remove Journaled Changes (RMVJRNCHG) operation)

• Any combination of these

The online help describes all the parameters for the DSPJRN command. To view the help, type DSPJRN on a command line and press F1.

 

Specifying journal codes

You can display entries that have specific journal codes, such as all file-member-level entries (F), all record-level entries (R), or all security entries (T). You specify journal codes in paired values. The first value in the pair is the journal code. The second value indicates whether the object selections you have specified apply when deciding to display entries with the journal code.

Following is an example:

DSPJRN JRN($JRNLIB/JRNA) FILE(CUSTLIB/FILEA)
       JRNCDE((F *ALLSLT) (R *ALLSLT)
             (U *IGNFLSLT))...

In this example, entries for the FILEA file with journal codes F and R are displayed if the entries meet all other selection criteria, such as date and time. Entries with journal code U are displayed regardless of whether they are for file FILEA, because ignore file selection (*IGNFLSLT) is specified for journal code U. Entries with journal code U must meet all other selection criteria, such as date and time, to be displayed.

You can select similar entries for other object types using the OBJ or OBJPATH parameters and specifying *IGNOBJSLT for the second value of the journal code.

• Output for journal entries directed to a workstation
  If you direct the output from the Display Journal (DSPJRN) command to the requesting workstation, basic information about the journal entries appears. Use the roll key to display the next sequential set of entries.

• Output for journal entries directed to a database output file
  If you direct the output from the Display Journal (DSPJRN) command to a database output file, you can further restrict the journal entries you want to process by creating logical files over the database output file.

• Format of database output files
  When you direct the output of the Display Journal (DSPJRN) command to a database file, the system creates the output file records in a standard format.

 

Parent topic:

Working with journal entry information

Related concepts
Layouts for the fixed-length portion of journal entries Layouts for variable-length portion of journal entries Journal code descriptions

Related reference
Display Journal (DSPJRN) command

Related information
Journal entry information finder