Audit and Version Utility

The audit and version utility enables you to audit SCLM operations on SCLM-controlled members and create versions of editable members. Using the audit and version utility, you can view the audit information for a member, retrieve a version to a sequential data set not controlled by SCLM, to a partitioned data set not controlled by SCLM, or to an SCLM-controlled development group. This utility also enables you to delete audit and version information from the database.

The project manager controls the audit and version capabilities through the use of macros within the project definition. Audit information is stored in a VSAM data set, and versions of the SCLM members are stored in one or more partitioned data sets allocated for this use.

Attention: The data kept in audit VSAM data sets and the versioning partitioned data sets is for the exclusive use of the audit and version utility. Do not edit or alter these data sets without using the audit and version utility or the data may be lost.

Figure 1 shows the panel that appears when you select Option 8, Audit and Version, from the SCLM Utilities panel.

Figure 1. SCLM Audit and Version Utility (FLMVUS#P)
   Menu  SCLM  Utilities  Help
 ──────────────────────────────────────────────────────────────────────────────
                  SCLM Audit and Version Utility - Entry Panel

   Option . . 1  1. Versioning and Audit Tracking
                 2. Versioning only
 SCLM Library:
   Project  . : SLMTEST7
   Group  . . . JPHILP
   Type . . . .                                                   
   Member . . .             (Member name or blank for member list)

 Selection date range:
   Date from  . .             (Blank or start date for member list)
   Date to  . . .             (Blank or end date for member list)

   Enter "/" to select option
      Hierarchy view



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

The fields on the SCLM Audit and Version Utility - Entry panel are:

Option
Versioning and Audit Tracking: shows all audited actions for the selected members and date range.

Versioning only: shows only those entries that have version data associated with them. Includes records for attempts and failures that would otherwise have version data.

Project
The project that you specified on the SCLM Main Menu. An Alternate field also appears if you specified an alternate project definition.
Group
The group for which you want audit and versioning information. The specified group must have an audit VSAM data set defined in the project definition. It must also be defined on an FLMATVER macro in the project definition. If the Hierarchy option is selected, this field will be used to determine the group hierarchy to be searched and the results will include records from the current group and all parent groups.
Type
Specify up to four types of member for which you want the version and audit information displayed or retrieved. The types must be defined on an FLMATVER macro in the project definition.
Member
The member for which you are requesting information. If you leave this field and the Command field blank, SCLM displays the SCLM Version Selection panel. The Member field is optional. A trailing * may be entered in this field to request a selection list according to a pattern match.
Date from
The starting date of the range of dates to search for the specified member. The date must be in the form YYYY/MM/DD. If you specify a member and leave this field blank, SCLM searches from the beginning of the file to the TO date. If you specify a member and leave the Date from and Date to fields blank, all versions of the member appear.

SCLM verifies that the date you enter is valid and not greater than today's date. The Date from field is optional.

Date to
The ending date of the range of dates to search for the specified member. The date must be in the form YYYY/MM/DD. If you specify a member and leave this field blank, SCLM uses the current date as the end date for the search. If you leave the Date from and Date to fields blank, all versions of the member appear.

SCLM verifies that the date you enter is valid and greater than or equal to the Date from value. The Date to field is optional.

Hierarchy view
When this option is selected, SCLM searches for audit/versioning records for the current group and for all groups above it in the hierarchy. The current group is determined by the value in the Group field on this panel.