Use FileAuditGenerate to create past versions of a file using the file's audit trail (see File Auditing).
The versions are created in the file's directory with a name composed of the file's name, a period, the SAVE date, a period, and the SAVE time. For example, if three versions of file ApcIssu.C are created, they might be assigned names as follows:
ApcIssu.C.19940605.122024
ApcIssu.C.19940606.081401
ApcIssu.C.19940606.141049
FileAuditGenerate may also be entered as FileAuditGen[erate], AuditGen[erate], or AudGen[erate].
FileAuditGenerate supports workstation files only. It does not support BIM, PDS, or VSE files.
Optional Operands
FILE is the workstation file for which past versions are to be created.
Default: last referenced file.
DATE specifies, together with TIME, the versions to be created. DATE is entered according to Date Format. Any versions originally saved on or after the DATE/TIME specification, will be generated.
Default: 01/01/1900 (Create all past versions).
TIME specifies, together with DATE, the versions to be created. TIME is entered in the format hh:mm:ss (hh=hours, mm=minutes, ss=seconds).
Default: 00:00:00.
FileAuditGenerate is typically used to create past versions of a file for viewing purposes only. If you want to restore the file to a prior version, use the FileAuditRollback command instead.
FileAuditGenerate sets the last referenced file.
Return Codes
OK Successful.
NF File not found.
SC Inadequate access level.
Procedure Notes
FileAuditGenerate sets the TXM variables to the attributes of FILE.
Examples
Generate all past versions for workstation file ApcIssu.C:
=> audgen apcissu.c
Generate all past versions of workstation file BIREXIO created 02/01/94 or after:
=> audgen birexio,02/01/94