Recovering a historical version of a specific resource definition

To recover a historical version of a specific resource definition:

  1. Enter H next to an item on one of the following list panels:
    • A list panel of resource definitions, shown under various primary menu options, such as 2 CICS Resources and 4.1 Multiple Configs

      (The H line action is only available on some list panels of resource definitions.)

    • A list panel of changes, shown under primary menu option 4.3 CICS changes

    The H line action displays a list panel of all historical versions of the resource definition.

  2. Enter E next to the historical version that you want to recover.

    An edit panel appears, showing the attributes of the historical version.

  3. On the command line of the edit panel, enter SAVE: this recovers the historical version by overwriting the current resource definition, if it still exists.

    If the resource definition that you want to recover no longer exists in the CSD file or context (it has been renamed or deleted), then the panel displays the message "SAVEAS command required" after you enter SAVE, because there is no current version to overwrite. Enter SAVEAS and then specify the location where you want to save the resource definition.

  4. Press the Exit key (F3) to return to the list of historical versions.

    Notice that, if you saved the resource definition to its original location, there is now one more item in the list of historical versions, reflecting the version that you have just overwritten.

Figure 1. Recovering a historical version of a specific resource definition
Tips:
  1. You can edit the attribute values of the historical version prior to saving, and the current version will contain these edits. Keep in mind that you are not editing the actual historical version stored in the journal: that remains unchanged. The ISPF dialog does not allow you to edit journal records. Instead, you are editing an on-screen copy of the historical version, that you use to overwrite the current version.
  2. To recover the historical version under a different name, enter SAVEAS instead of SAVE.
  3. On a list panel of changes, you can bypass the H line action, and enter E next to the change. This displays an edit panel for the after image, with one exception: if the change is a deletion, entering E displays the before image (the resource definition before it was deleted).