Swapping journal receivers
An important task for journal management is to swap journal receivers. You typically swap journal receivers when they reach their storage threshold. You can swap journal receivers either with iSeries™ Navigator or with the Change Journal (CHGJRN) command. If you use system journal-receiver management, the system changes journal receivers for you.
You can use iSeries Navigator or the Change Journal (CHGJRN) command to change the attributes of the journal. You can also use the iSeries Navigator or the CHGJRN command to change the receiver for a journal (detach the current receiver, create and attach a new receiver) and to reset the sequence number for journal entries.
When you swap a journal receiver, the old journal receiver becomes detached. When you detach a journal receiver, you cannot reattach it to any journal. You can do these things with a detached journal receiver:
- Save or restore it.
- Display entries.
- Retrieve entries.
- Receive entries.
- Use it to apply or remove journaled changes.
- Use it to compare journaled images.
- Display its status or position in a receiver chain.
- Delete it.
- Replicate it with the remote journal function.
You must swap journal receivers to change the following journaling attributes:
- Manual or system journal management (MNGRCV parameter)
- Receiver size options (RCVSIZOPT parameter)
- Minimized entry specific data (MINENTDTA parameter)
- Journal receiver threshold value (THRESHOLD parameter)
- Fixed-length data (FIXLENDTA parameter)
- Journal object limit (JRNOBJLMT parameter)
- Reset journal sequence numbers (SEQOPT parameter)
To use iSeries Navigator to swap a journal receiver without changing options, follow these steps:
- In the iSeries Navigator window, expand the system you want to use.
- Expand Databases.
- Expand the database that you want to work with and Schemas.
- Right-click the journal you want to use and select Swap Receivers. The system generates a new name when it creates the receiver.
To change options when you swap a journal receiver with iSeries Navigator, proceed as follows:
- In the iSeries Navigator window, expand the system you want to use.
- Expand Databases.
- Expand the database that you want to work with and Schemas.
- Double-click the journal you want to use.
- Select Swap receivers and the journaling options you want to use.
- Click OK. The Journal properties dialog closes. The new journal receiver is automatically created and attached.
You can also use JRNRCV(*GEN) on the Change Journal (CHGJRN) command to create the new receiver with the same attributes as the currently attached receiver, and in the same library. These attributes include the owner, private authorities, public authority, object auditing, ASP identifier, threshold, and text.
You must use the CHGJRN command to change the journaling options to one of the following:
- Specify a journal receiver-size option.
- Specify that objects allow journal entries to have minimized entry-specific data.
- Specify a different journal receiver threshold value using the Journal Receiver Threshold (THRESHOLD) parameter in combination with the JRNRCV(*GEN) parameter.
- Specify the data that is included in the fixed-length portion of the journal entries.
- Specify the time to delay the next attempt to automatically attach or delete a new journal receiver with system journal receiver management.
- Specify journal caching.
- Specify journal standby state.
- Change the journal recovery count.
- Change the journal object limit.
CAUTION:If you use save-while-active operations to save objects before they reach a commitment boundary, ensure that you save the journal receiver after you detach it. If you delete the journal receiver before it is saved, you can lose the ability to recover any pending transactions for those objects.
Parent topic:
Swapping, deleting, and saving journals and receiversRelated concepts
Manual versus system journal-receiver management Threshold (disk space) for journal receivers Working with inoperable journal receivers Working with IBM-supplied journals Swapping journal receiver operations with remote journals