Applying journaled changes with the WRKJRN command

The Work with Journal (WRKJRN) command can be used to recover any journaled object. When you select option 2, you choose from a list of object types for recovery. Choose an object type to view the journaled objects of that type and the current status for each object.

The WRKJRN command support should be considered only if you are applying changes for less than 300 objects.

You can use the Work With Forward Recovery display to perform the following tasks:

Add object to list: To add an object to the list on the display, use Option 1 (Add member to list). Do this if you want to restore those objects. This task is not available for Integrated File System objects.
Apply journaled changes: To apply journaled changes to an object, use Option 2 (Apply journaled changes). This option applies journaled changes and changes the status to Recovered (if the apply operation was successful). If the apply operation was not successful, messages appear indicating why and the last successful status is displayed. If any required receivers are missing or damaged while running the APYJRNCHG command, the system prompts for the restore of the missing or damaged receivers.
If any of the objects in the list have a status of Damaged, the system prompts you with the command necessary to recover the object. For objects that are damaged, recovery involves deleting the object, a restore of the last save of the object, followed by the Apply Journaled Changes (APYJRNCHG) command. The system guides you through the recovery of physical files as follows:

The recovery is similar for data areas, data queues, and integrated file system objects, except for the dependent logical files references. Also, the restore command names are different for integrated file systems it is RST, but for all others its RSTOBJ.

For physical files, the system identifies all the logical files dependent on the specified damaged file. The Dependent Logical Files display appears identifying these files.
The dependent logical files are deleted.
The system deletes the files to be recovered (or restored).
The system displays prompts for the restore of files to be recovered. After all restores are completed successfully, the files to be recovered are allocated exclusively to prevent any other processing. This allocation is maintained until the recovery procedures are complete.
The system displays prompts for the restores of the dependent logical files.
An APYJRNCHG command is prompted.
If the APYJRNCHG command encounters a required journal receiver that is not online, the system prompts for the restore of the required receiver and again starts the APYJRNCHG command.

When the recovery process is complete, the status field for the member indicates Recovered (if the operation was successful). If the operation failed, the status field remains unchanged, and messages appear indicating why the operation failed.

Restore objects

If you wish to restore any objects, use Option 3 (Restore). This is particularly useful for objects with a status of Not Found. Objects that are restored successfully have a status of Restore Complete. Objects that are not restored keep their old status. A message is sent indicating that the restore did not complete successfully. All objects that are restored are included in the list of objects to recover.

The last save information is provided for the restore operation. If either of the following are true, then use the RSTOBJ command instead of Option 3 (Restore):

The device provided is tape, diskette, or optical and you choose to restore from a save file (*SAVF).
The device provided is a save file (*SAVF) and you choose to restore from tape, diskette, or optical media.

If you choose option 3 to restore a damaged object, the restore process involves deleting the object prior to prompting to restore the object. The process is similar for all object types except there are extra steps if restoring damaged physical files that have dependent logical files. The system guides you through the restore process of damaged physical files as follows:

The system identifies all the logical files dependent on the specified damaged physical file.
The Dependent Logical Files display appears identifying these logical files.
The system deletes the files to be restored.
The system then prompts with a restore command for the physical files.
Once the physical files are restored, the system prompts with a restore command to restore the logical files.

Remove object from list

To remove an object from the list, use Option 4 (Remove object or member from list). Option 4 removes objects from the list of objects to be recovered.

Parent topic:

Applying journaled changes