Displaying information for journaled objects, journals, and receivers
IBM Navigator for i, Control Language commands, and APIs provide several ways for you to display information about journaled objects, journals, and journal receivers.
You can use Navigator for i 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 Navigator for i to display
journaling information for the following object types:
- Tables (database files)
- Libraries (through the QSYS.LIB file system)
- Data Areas (through the QSYS.LIB file system)
- Data Queues (through the QSYS.LIB file system)
- Integrated file system directories
- Integrated file system stream files
- Integrated file system symbolic links
Using Navigator for i, you can get information about one object at time using the Journaling action, or about groups of objects journaled to a given journal using the Show Journaled Objects action. 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:
- IBM Navigator for i Journal Receivers properties dialog
- 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.
- 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 Navigator for i,
you can the find status of a journal receiver by doing the following
steps:
- With Navigator for i, connect to the system with the journal receiver
- Expand Journal Management.
- Select Set Database/Library to use with Journal Tasks and specify the database and library that you want to work with.
- Click Show All Journal Tasks.
- Select the Journal Receivers list.
- Select the journal receiver, and the Properties action.
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.