Variable-length portion of the journal entry

This topic provides the layouts of the variable-length portion of the journal entries.

For output formats *TYPE1 and *TYPE2, the variable length portion of the journal entry includes just the Entry-specific data field. The contents of the Entry-specific data field depends on the journal entry code and entry type. For the layout of the output format *TYPEPTR or *JRNENTFMT, see the QjoRetrieveJournalEntries API. For all other output formats, the variable-length portion of the converted journal entry potentially has two fields:

  • Null value indicators
  • Entry-specific data

The Null Value Indicators field, contains relevant information only for entries with journal code R. Null value indicators are present in journal entries for record level operations as follows:

  • The corresponding physical file has null capable fields.
  • The record image has been minimized in the entry specific data.

Otherwise, it contains blanks. If the record image has not been minimized in the entry specific data, the Null Value Indicators field is a character string with one character for each field in the physical file that has record images appearing in the journal. Each character has the following interpretation:

  • 0 = corresponding field in the record is not NULL.
  • 1 = corresponding field in the record is NULL.

If the record image was minimized on field boundaries (MINENTDTA(*FLDBDY), and it has been formatted when reading (FMTMINDTA(*YES)) then each character has the following interpretation:

  • 0 = The corresponding field was recorded and is not NULL.
  • 1 = The corresponding field was recorded and is NULL.
  • 9 = The corresponding field was not recorded and it's default value was returned.

System-supplied output files

The following system-supplied output files define the Null Value Indicators and Entry-Specific Data fields as variable-length character fields:

  • QSYS/QADSPJR3
  • QSYS/QADSPJR4
  • QSYS/QADSPJR5

For additional details regarding the *TYPE3, *TYPE4, and *TYPE5 formats and the exact layout of these two fields, see the following commands:

  • Display Journal (DSPJRN)
  • Receive Journal Entry (RCVJRNE)
  • Retrieve journal entry (RTVJRNE)

Layouts for journal entry types

Use the Journal entry information finder to find the layout for the variable-length portion of the journal entry. Some one journal entry types are described in other places than this topic. The Journal entry information finder indicates those journal entries.

Some journal entry types are documented in QSYSINC library includes, as indicated in the Journal code finder. Some entry types do not have entry-specific data.

These layouts include specific values for fields in the fixed-length portion of the entry and the fields in the entry-specific portion of the entry. The offsets show the relative offset within the Entry-specific data field. The beginning position of the Entry-specific data field depends on the format type that you specify. You can also use the Journal entry information finder to see these layouts.