Journaling in AS400 - skill-at/AS-400-Training GitHub Wiki

Journaling · Journaling, generally speaking, is a process of recording activity.

· On the iSeries, journaling refers to the process of recording object activity.

· Journaling on the iSeries typically involves the recording of the activity related to files, namely, physical files. When a file is being journaled, activity such as file-opens, file-closes and data updates are recorded.

Set up journaling

  1.  Use the Create Journal Receiver (CRTJRNRCV) command to create a journal receiver.

The journal receiver is where the journal entries are actually recorded. The journal "connects" the receiver to the file.

It's a good habit to name the journal receiver the same as the journal, plus a numeric suffix such as 0 or 1.

Also, you should put journal receivers in the same library as the file.

  1.  Create a journal. Use the Create Journal (CRTJRN) command to create a journal and specify the receiver created in step 1. Although you can journal multiple files to the same journal (and, in some cases, that is actually preferable), you will generally want to have a journal "serving" a single file.

  2.  Start journaling the file. This is done by using the Start Journal Physical File (STRJRNPF) command. This is how you associate a file to a journal. Once the association is made, the system will record in the journal receiver a copy of any record added, updated or deleted from the file. Other activity, such as when the file is opened and closed, can also be recorded in the journal receiver if you choose by selecting the appropriate options on the STRJRNPF command.

    Four basic journal entry categories

· The most common journal entries fall into four basic categories (J, F, R, C).

· Within each category there are number of different journal entry types represented by a two-character entry code (e.g. PR, NR for journal entry J).

  1.  Journal and journal receiver operations (J). These include such things as references to the previous receiver (PR) or the next receiver (NR) in a chain. Also, at IPL-time, an entry is made (e.g., an IN entry for IPL after normal end) marking a critical chronological boundary in the file activity.

  2.  File operations (F). This category includes file opens (OP) and file closes (CL).

  3.  Record operations (R). Record updates (UP), deletes (DL), and new records written (PT and PX) all fall into this category.

  4.  Commitment control (C). Anything related to commitment control falls into this category. Some examples are begin commitment control (BC), start a commit cycle (SC), commit operation (CM) and rollback operation (RB).

To get journal entries use DSPJRN command , either take output to OUTFILE or display results. Example : - DSPJRN JRN(JRNFILE) FILE((EMPPF)) RCVRNG(*CURCHAIN) OUTPUT(*OUTFILE) OUTFILFMT(*TYPE3) OUTFILE(PRAF12121/JRNOUTPUT)