SCLM Version Selection

Using the SCLM Version Selection panel (FLMVSL#P), you can view the audit information and associated accounting information for that version of the member, compare versions of a member or compare the member version with an external data set, delete a version of a member, view the editing history of a version, retrieve a version of a member or view the current contents of a version.

To display the SCLM Version Selection panel, do the following from the SCLM Audit and Version Utility Entry panel:

Select "Versioning and Audit Tracking" or "Versioning Only" in the option field.
Enter the group name in the Group field.
If desired, enter the Type, Member, Date from and Date to information in the appropriate fields.
If desired, select the hierarchy option.
Press Enter.
The SCLM Version Selection panel (see Figure 1) displays the list of results.

Figure 1. SCLM Version Selection Panel (FLMVSL#P)

   Menu  SCLM  Utilities  Help
 ──────────────────────────────────────────────────────────────────────────────
                            SCLM - Version Selection           Row 1 to 8 of 82

 Project  . . . : SLMTEST7

 Line Commands:   A Audit Info  C Compare     D Delete      X External Compare
                  H History     R Retrieve    V View

                              Action   Action     Action
 S Member   Group    Type     Reason   Date       Time     Userid   V Status
 - -------- -------- -------- -------- ---------- -------- -------- - --------
   JJMSCPR  DEVELOP  ASM      PROMOTE  2002/08/02 16:20:20 JPHILP
   JJMSCPR  DEVELOP  ASM      PROMOTE  2002/08/02 16:19:37 JPHILP   #
   JJMSCPR  DEVELOP  ASM      DELETE   2002/08/02 16:17:52 JPHILP
   JJMSCPR  DEVELOP  ASMLIST  PROMOTE  2002/08/02 16:20:20 JPHILP
   JJMSCPR  DEVELOP  ASMLIST  PROMOTE  2002/08/02 16:19:39 JPHILP
   JJMSCPR  DEVELOP  NCAL     PROMOTE  2002/08/02 16:20:21 JPHILP
   JJMSCPR  DEVELOP  NCAL     PROMOTE  2002/08/02 16:19:39 JPHILP
   JJMSCPR  DEVELOP  OBJ      PROMOTE  2002/08/02 16:20:21 JPHILP


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

Use the SCROLL commands or the LOCATE command to scroll the list.

The fields for the Version Selection panel, shown in Figure 1, are:

Member

The names of the members matching the selection criteria on the SCLM Audit and Version Utility - Entry panel that have audit and version information.

Group

The name of the group you specified on the SCLM Audit and Version Utility - Entry panel.

Type

The types of the members matching the selection criteria on the SCLM Audit and Version Utility - Entry panel.

Action Reason

The action that was performed against the specified member. Valid values include:

BUILD
BLDDEL
DELETE
EXT LIB
FREE
IMPORT
LOCK
PROMOTE
STORE
UNLOCK
UPTATHCD (update authorization code)
UPTCHGCD (update change code)
UPTUENTY (update user entry)

Action Date

The date the action listed in the Action Reason field occurred.

Action Time

The time the action listed in the Action Reason field occurred.

Userid

The user ID of the person who performed the action.

V

Indicates, using a hash symbol (#), whether a version of the member exists.

Status

Indicates the status of the line command. Possible values are:

*SELECT
*DELETED
*FAILED
*ERROR
RETRVOLD
RETRVNEW

To the left of each member listed is a space for entering a line command. You can enter multiple commands on the panel as long as the commands do not conflict. All requests are handled in succession unless an error occurs. If an error occurs, the selection list indicating the error reappears. You must correct the error before further processing can occur.

The available line commands are as follows:

A

Display the audit information for the member.

When you enter the A line command beside a member name, the SCLM Audit/Version Record panel appears, as shown in Figure 1, giving you the information recorded for that member. From here, you can display the accounting information.

C

Display the version in the SCLM Audit and Version Utility - Compare panel.

When you enter the C line command beside a member version, SCLM displays the selected version information in the SCLM Audit and Version Utility - Compare panel, along with a subset of versions (not audit records) from the initial version selection results, where the Type and Member are the same. For more information, see SCLM Version Compare.

The C command can only be entered for member versions (not audit records).

D

Delete the audit record in the VSAM audit data set and delete the versioned member in the partitioned data set.

When you enter the D line command beside a member name, SCLM deletes the audit record and the corresponding versioned member, if one exists. The Status field displays the word "Deleted", indicating that the operation completed successfully.

X

Display the version in the SCLM Audit and Version Utility - External Compare panel.

When you enter the X line command beside a member version, SCLM displays the selected version information in the SCLM Audit and Version Utility - External Compare panel, in which you can specify the external data set to be used in the comparison. For more information, see External Compare.

H

Display the history of editing changes made between the selected version and the current version. The Key column indicates whether each line has changed and if so, in which version.

Figure 2. Audit and Version View panel (ISREDDE2) - sample data with history

   File  Edit  Edit_Settings  Menu  Utilities  Compilers  Test  Help
 ───────────────────────────────────────────────────────────────────────────────
 VIEW       SYS02225.T133058.RA000.USERID.VHIST.H01        Columns 00001 00072
 ****** ***************************** Top of Data ******************************
 ==MSG> -Warning- The UNDO command is not available until you change
 ==MSG>           your edit profile using the command RECOVERY ON.
 000001                   Version History
 000002           Changes since, but not including Version 2
 000003
 000004 CURRENT 0      02/04/17  12:49:34.19  JPHILP
 000005 VERSION 1      02/04/12  12:32:59.49  JPHILP
 000006 VERSION 2      02/04/12  11:54:23.25  JPHILP
 000007
 000008 |------Key-----||----------Description----------|
 000009 Ixxxxxx         Inserted into Version xxxxxxx
 000010         Dxxxxxx Deleted from Version xxxxxxx
 000011  (blank)        Unchanged since current version
 000012
 000013 |-------Key-----|------------------------------------Source-----------
 000014                          TITLE 'JJMSCPR  - COPYRIGHT CODE
 000015                 */04****************************************************
 Command ===>                                                  Scroll ===> PAGE
  F1=Help      F2=Split     F3=Exit      F5=Rfind     F6=Rchange   F7=Up
  F8=Down      F9=Swap     F10=Left     F11=Right    F12=Cancel

The H command can only be entered for member versions (not audit records).

R

Display the version in the SCLM Audit and Version Utility - Retrieve panel.

When you enter the R line command beside a member version, SCLM displays the selected version information in the SCLM Audit and Version Utility - Retrieve panel, in which you can specify the data set into which the version will be retrieved.

The R command can only be entered for member versions (not audit records). For more information, see Retrieve.

V

Display the current contents of the selected member version, using the SCLM VERRECOV service.

Figure 3. Audit and Version View panel (ISREDDE2) - sample data

   File  Edit  Edit_Settings  Menu  Utilities  Compilers  Test  Help
 ───────────────────────────────────────────────────────────────────────────────
 VIEW        USERID.VERBROWS.SLV89QK4                       Columns 00001 00072
 ****** ***************************** Top of Data ******************************
 ==MSG> -Warning- The UNDO command is not available until you change
 ==MSG>           your edit profile using the command RECOVERY ON.
 000001          TITLE 'JJMSCPR  - COPYRIGHT CODE                   '
 000002 */04*****************************************************************/
 000003 */*                                                                 */
 000004 */*                                                                 */
 000005 */*  OCO Source Materials                                           */
 000006 */*                                                                 */
 000007 */*  5696-234                                                       */
 000008 */*                                                                 */
 000009 */*  (C) Copyright IBM Corp. 1992,2000                              */
 000010 */*                                                                 */
 000011 */*  The source code for this program is not published or           */
 000012 */*  otherwise divested of its trade secrets, irrespective of       */
 000013 */*  what has been deposited with the U.S. Copyright Office.        */
 000014 */*                                                                 */
 000015 */*******************************************************************/
 Command ===>                                                  Scroll ===> PAGE
  F1=Help      F2=Split     F3=Exit      F5=Rfind     F6=Rchange   F7=Up
  F8=Down      F9=Swap     F10=Left     F11=Right    F12=Cancel

The V command can only be entered for member versions (not audit records).