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.