Retrieve

If you enter 'R' to select a version to be retrieved, the SCLM Audit and Version Utility - Retrieve Panel, shown in Figure 1, is displayed. Information about the selected version is shown in the top section of the panel.

Figure 1. SCLM Audit and Version Utility - Retrieve Panel (FLMVSR#P)

   Menu  SCLM  Utilities  Help
 ──────────────────────────────────────────────────────────────────────────────
 FLMVSR#P       SCLM Audit and Version Utility - Retrieve Panel

 SCLM Library:
   Version  . . : SLMTEST7.DEVELOP.ASM(JJMSCPR)
   Version Date : 2002/04/12
   Version Time : 11:54:23

 SCLM retrieve group and type:
   To Group . . .                 Authorization code . .         
   To Type  . . .                 (Defaults to auth code from audited member)

 Other Data set:
   Data Set Name                                                              






 Command ===>                                                                 
  F1=Help      F2=Split     F3=Exit      F7=Backward  F8=Forward   F9=Swap
 F10=Actions  F12=Cancel

The fields for the panel shown in Figure 1 are:

Version: Displays the full name of the selected member version.
Version Date: The date on which the selected member version was written.
Version Time: The time at which the selected member version was written.
To Group: The SCLM Group into which the version is to be retrieved.
To Type: The SCLM Type into which the version is to be retrieved.
Auth Code: The Authorization code used in the retrieval process. If left blank, this defaults to the Authorization code from the selected member version.
Data Set Name: The ISPF data set into which the version is to be retrieved. If the data set is a PDS, a member must be specified.
Note: If a data set name is specified in this field, the To Group and To Name fields are ignored.

When you retrieve more than one member into a sequential data set, each member after the first is copied over the previous member. To retrieve more than one member to a sequential data set, copy the first member to another data set before retrieving a second member. We recommend that you use a partitioned data set if you intend to copy more than one member.

SCLM will not allow you to retrieve a second version of the same member but you can retrieve a version of a different member. To retrieve a second version of the same member you must first return to the SCLM Audit and Version Utility Entry panel and then come back to the SCLM Version Selection panel.

Note: When you retrieve the most recent version of a source member into a development group of the hierarchy, the accounting data and ISPF statistics match those of the member that is already in the hierarchy. Therefore, outputs are not produced when the member is built because the outputs that are already in the library are current.

In addition, when the recovered member is promoted to the level where the member resides, the existing member is not overwritten. If the content of the existing member has been corrupted and it is important to replace that member, you must save the member in the hierarchy after it is recovered. You can save the member using SCLM edit, migrate in forced mode, or the SAVE service.

If you perform a retrieve using the To Group and To Type fields, it may result in predecessor verification errors when promoting the member because both the member and its accounting information are restored. Using the Other Data set field restores only the member, but not its accounting information. If you do not plan to make further changes to the restored member, enter the SAVE command explicitly to force SCLM to generate new accounting information. Entering the END command with the AUTOSAVE option in the edit profile does not cause SCLM to generate new accounting information and results in a predecessor verification error.