IBM Support

How to Save and Restore Versions of Changes in SCLM

How To


Summary

A version is a way of re-creating an editable member the way it used to be. If you defined your SCLM project to perform versioning, you have a history of the changes made to your members. Whenever a member is changed, SCLM creates a list of the differences between the old and new member. This list is called a delta. When you need to retrieve the member, the changes are stripped from the new member until it is restored to its former condition.

Steps

Saving Versions

Once versioning is turned on, any time you perform a STORE or a PROMOTE, versions are saved in the versioning partitioned data set. STOREs are most often done through the SCLM Edit process (ISPF option 10.2) or the Migration Utility (ISPF option 10.3.3). They also occur when you use the EDIT, STORE, or MIGRATE service. PROMOTEs are done either through the Promote option (ISPF option 10.5) or the PROMOTE service.

Recovering Versions

To retrieve versions of a member, you have two choices:

  1. Audit and Version Utility (ISPF option 10.3.8)
  2. VERRECOV service

The fields on the utility panel and the service parameters are similar. The SCLM Audit and Version Utility - Entry Panel requests the following information:

SCLM Audit and Version Utility - Entry Panel

The panel gives you the choice of getting a list of the version and audit information or just the version information. Use the Group, Type, and Member fields to specify which version information is displayed. To further limit the amount of information displayed, you can type in a start date or end date. Use the Date From and Date To fields to specify the earliest and latest dates you are interested in.
On the SCLM Audit and Version Selection panel, you can:
  • View Audit Information,
  • Compare a version to either an existing version or an eXternal data set,
  • Delete versions or audit records,
  • View version History,
  • Retrieve a version, or
  • View a version.
SCLM Audit and Version Utility - Selection Panel
This panel shows both the audit and the version data. A # in the V (Version) column shows that there is a version associated with the record. Use the R line command in the S column to select the version to retrieve. When you use the R command, the following panel displays:
SCLM Audit and Version Utility - Retrieve Panel
You can either recover a version to a non-SCLM data set, or you can recover directly into a development group in the SCLM hierarchy. Some people like to recover into a non-SCLM data set, so they can verify that the version is the one they want. Other people like the convenience of recovering the member directly into the hierarchy.
If you recover a version into a non-SCLM-controlled data set, replace the failing version that exists in the hierarchy. To replace the failing member, use SCLM Edit (ISPF option 10.2) to draw the failing member down into a development group. Then, you can either
  • COPY the new member from the version in the non-SCLM data set and replace the failing one, or
  • Edit the failing member, and use the COMPARE command to compare the failing member with the other data set. Make changes based on the highlighted differences.
Whichever way you recovered your member, rebuild it to re-create any outputs for that member. After you test it, promote it to the appropriate level of the hierarchy.

For an example of how to use the VERRECOV service, SCLM provides a member, FLMSVERR, in the ISPF sample library ("ISP.SISPSAMP").

Comparing Versions

If you are not sure which version you want to retrieve, you can look at the differences between two versions to see which one is correct. There are two types of comparisons.

  • Compare - compare a version against another version of the same member.
  • External compare - compare a version against a data set member or other data set.

To compare two versions of a member, select the member name with the line command C. On the SCLM Audit and Version Utility - Compare Panel, enter the Compare Type, Listing Type, and Sequence Number Values. Put a data set name in the Listing DS Name field. Then, use the S line command to select the member version you want to compare against, as shown:

SCLM Audit and Version Utility - Compare Panel

Similarly, you can compare a version of a member to an external data set by selecting the member name with the line command X. On the SCLM Audit and Version Utility - External Compare, you can select to compare the version to
  • An SCLM group in the same hierarchy, or
  • An ISPF data set and member. 
The comparison results are displayed in standard SuperC format. 

Document Location

Worldwide

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSCVRUA","label":"SCLM for z\/OS"},"Component":"","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
20 March 2020

UID

ibm11288738

Page Feedback