Use FileAuditRollback to reverse updates to a file using the file's audit trail (see File Auditing).
FileAuditRollback may also be entered as FileAuditRoll[back], FileAuditRl, AuditRoll[back], AuditRl, AudRoll[back], or AudRl.
FileAuditRollback supports workstation files only. It does not support BIM, PDS, or VSE files. (BIM files can be rolled back by using the BIM-EDIT AUDRL command. Enter 'BI HELP AUDRL' for information.)
Optional Operands
FILE is the workstation file to be rolled back.
Default: last referenced file.
DATE specifies, together with TIME, how far to roll back the file. If DATE is specified as an asterisk (*), the file is returned to its status before any updates. Otherwise, DATE is entered according to Date Format. In this instance, any updates occuring after DATE/TIME are reversed.
Default: The last Edit session is rolled back.
TIME specifies, together with DATE, how far to roll back the file. TIME is entered in the format hh:mm:ss (hh=hours, mm=minutes, ss=seconds).
Default: 23:59:59.
For workstation files, FileAuditRollback creates a copy of the file at each SAVE point prior to reversing that session's updates. The copies 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
The version with the latest date and time is actually a copy of the file prior to any rollback operation. After an errant rollback operation, one of the copies could be renamed to the file name to in effect reverse the rollback. For example, in the ApcIssu.C example above, the following commands would reverse the rollback operation.
=> pur apcissu.c
=> ren apcissu.c.940606.141049,ApcIssu.C
Copies created by FileAuditRollback remain in the directory until explictly deleted by the user.
FileAuditRollback sets the last referenced file.
When Valid
FILE must not currently be undergoing editing.
Return Codes
OK Successful.
ED File is being edited.
NF File not found.
SC Inadequate access level.
Procedure Notes
FileAuditRollback sets the TXM variables to the attributes of FILE.
Examples
Reverse the last Edit session for workstation file Apc0010:
=> audrl apc0100
Restore the workstation file ApcIssu.C to its Dec 31, 1993 status:
=> audrl apcissu.c,12/31/93