Displaying information for journaled objects, journals, and receivers

 

iSeries™ Navigator, Control Language commands, and APIs provide several ways for you to display information about journaled objects, journals, and journal receivers. You can use iSeries Navigator to display information such as whether the object is journaled, the name of the object's journal, what library the object's journal is in, and which journaling options are being used. You can use iSeries Navigator to display journaling information for the following object types:

• Tables (database files)

• Integrated file system directories

• Integrated file system stream files

• Integrated file system symbolic links

Using iSeries Navigator, you can only get information about one object at time. The advantage to using commands and APIs is that they can get information about groups of objects. Use the following commands and APIs to get information about journaled objects.

• Display File Description (DSPFD) command

• Display Object Description (DSPOBJD) command

• Display Object Links (DSPLNK) command

• Get Attributes (Qp0lGetAttr()) API

• List Objects (QUSLOBJ) API

• Open List of Objects (QGYOLOBJ) API

• Work with Object Links (WRKLNK)

Ways that you can display information about journal receivers are as follows:

• iSeries Navigator

• Display Journal Receiver Attributes (DSPJRNRCVA) command

• Retrieve Journal Information (QjoRetrieveJournalInformation) API

• Work with Journal Attributes (WRKJRNA) command

• Retrieve Journal Receiver Information (QjoRtvJrnReceiverInformation) API

These methods can identify:

• The journal receivers currently attached to the journal.

• A directory of the journal receivers still on the system that are associated with the journal.

• The names of all of the objects that are being journaled instead of the journal.

• The commitment control uses of this journal.

• The attributes of the journal.

• Information about all remote journals that are associated with the journal.

Furthermore, the DSPJRNRCVA command or the QjoRtvJrnReceiverInformation API can identify:

• Fixed-length data

• ASP of the journal receiver

• Minimized entry data

• The next and previous journal receiver information

You can find the status of a journal receiver by using the WRKJRNA command, then pressing F15 (Receiver directory) from the Work with Journal Attributes display. You can also use the DSPJRNRCVA command. Or in iSeries Navigator, you can the find status of a journal receiver by doing the following steps:

1. Expand the system with the journal receiver

2. Expand Databases and the database with the journal receiver.

3. Expand Schemas and the schema (library) with the journal receiver.

4. Click Journal Receivers.

5. Right-click the journal receiver, and select Properties.

When the journal receiver is in partial status, the partial status of a journal receiver indicates the following:

• The disk unit on which the journal receiver is stored is damaged. No more journal entries can be recorded.

• A journal receiver was saved while it was attached to the journal. This means that additional entries may have been recorded in the journal receiver after the save operation occurred. The receiver was later restored, and no complete version is available.

• The journal receiver is associated with a remote journal. It does not contain all the journal entries that are in the associated journal receiver that is attached to the source journal.

• A partial receiver does not contain all the entries that are recorded in the journal while this receiver was attached. It does contain entries that are recorded up to the last save operation.

• The most complete version of the journal receiver is no longer on the system because it was destroyed during a failure.

• You have restored an older, partial version.

 

Parent topic:

Managing journals

Related concepts
Journal receiver chains Getting information about remote journal entries