Start of change

Apply 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 status field for each object indicates the following:

Note: Start of changeThe WRKJRN command support should be considered only if you are applying changes for less than 300 objects.End of change
Parent topic: Apply journaled changes
Related concepts
Remove journaled changes with the WRKJRN command

Tasks with the Work With Forward Recovery display

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

Add object to list
Start of changeTo 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.End of change
Apply journaled changes
Start of changeTo 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:

Note: Start of changeThe 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.End of change
End of change
  1. Start of changeFor physical files, the system identifies all the logical files dependent on the specified damaged file. The Dependent Logical Files display appears identifying these files.End of change
  2. The dependent logical files are deleted.
  3. The system deletes the files to be recovered (or restored).
  4. 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.
  5. The system displays prompts for the restores of the dependent logical files.
  6. An APYJRNCHG command is prompted.
  7. 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.

Start of changeRestore objectsEnd of change
Start of changeIf 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.
Note: The last save information is provided for the restore operation. If either of the following are true, then you must 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.
Start of changeIf 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.
End of change
End of change
Remove object from list
Start of changeTo 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.End of change
End of change