BACKTRACK (Project Administration)
- Last UpdatedMar 21, 2022
- 2 minute read
Function:
Allows the administrator to backtrack a Database (DB) to a previous session.
Description:
Sessions are defined as the work done between SAVEWORK commands. The administrator can backtrack to the date or session number required, or, if the required session has been stamped, the administrator can backtrack to the stamp. The current state of the DB will be lost.
In a Global Project, this command can only be used when the DBs are Primary at your administering Location.
In a Global Project, use the REMOTE <loc> BACKTRACK command to backtrack a constructor DB that is Primary at a remote Location, where <loc> is the Location identifier. Refer to the REMOTE (Global Project Administration) command for examples.
If the administrator tries to backtrack over any stamped sessions to a previous session, the administrator will receive an error message. Backtracking over stamped sessions is not allowed. The administrator must remove the stamp from the intervening sessions before they backtrack.
BACKTRACK removes the sessions permanently. The related command REVERT adds a session containing the data for the specified old session.
The backtracked DB is written to a new file. This is done to avoid the situation where secondary DB files in a Global Project could still contain removed sessions. This situation would cause propagation failures if further sessions were added to the backtracked file.
Note:
For extracts, the REVERT command is used instead of BACKTRACK.
Examples:
|
BACKTRACK HANGERS/PADD TO SESSION 4 Backtracks the HANGERS/PADD DB to Session 4. The Team ID (HANGERS) and TO can be omitted. BACKTRACK HANGERS/PADD TO STAMP /stamp_007 Backtracks the HANGERS/PADD DB to the session that has the Stamp stamp_007. The Team ID (HANGERS) and TO can be omitted. BACKTRACK /HVAC 10:30 31 / 8 / 96 BACKTRACK /HVAC 10:30 31 AUGUST 1999 Backtracks the HVAC DB to 10.30 am on the 31 August 1999. If the time is omitted, 11.59 p.m. is assumed. If the month is not given, the current month is assumed. If the year is not given, the current year is assumed. This example assumes that the Team name has been specified using the SET command. BACKTRACK PIPE/PIPE-A AT OXF TO SESSION 4 In a Global Project, backtracks the PIPE/PIPE-A DB at Location OXF to Session 4. The Team ID (PIPE) and TO can be omitted. (The DB PIPE/PIPE-A must be Primary at the Location OXF, and the System DB for OXF must be Primary at the current Location. Refer to the ADMINISTER SYSTEM command. |
Command Syntax:
|
>- BACKTrack -+- teamid -. |
Querying:
Q SESSION
Related Commands:
REVERT (Project Administration)
MERGE CHANGES (Project Administration)
REMOTE BACKTRACK
REMOTE REVERT - Global only