Administrator Command Reference Manual
Command Details : Detailed Descriptions of Commands : PREVOWNER (Global Project Administration - Hub only)
PREVOWNER (Global Project Administration - Hub only)
Function:
Restores the Hub to its previous Location, or restores the previous Primary Location of a database, if the commands to change these attributes have failed.
CAUTION:
This command should not be used, except under special circumstances (see below).
Description:
If a CHANGE PRIMARY command on a Database fails, the Database will be left with no Primary Location. However, the original Primary Location will be recorded, and this command is used to restore the original Primary Location.
Similarly, if a HUBLOCATION command fails, and the Project is left with no Hub, this command will restore the previous Hub Location.
If a SYSTEMLOCATION command fails, the PREVOWNER SYSTEM command will restore the previous System database Location.
These three commands have built-in recovery operations to restore the previous primary location if they fail. The PREVOWNER command is provided to enable the previous location to be recovered in the following circumstances:
•
If the daemon is down
•
For offline locations
•
To recover a failed change primary on the location’s own transaction database
•
If the CREATE EXTRACT command fails before it has reached its Allocate Primary command.
Note:
PREVOWNER is not usually needed after a failure of this command since it contains an in-built recovery operation. However, the automatic recovery operation does not cover the CREATE command Allocate operation and PREVOWNER may be needed in the unlikely event of this failing.
In all other circumstances it is better to await the completion of the in-built recovery operation, since this prevents incompatible changes being made by two competing users at different locations.
Note:
This command cannot be used to reverse a successful CHANGE PRIMARY, HUBLOCATION or SYSTEMLOCATION command.
Examples:
PREVOWNER HUB
PREVOWNER dbname
PREVOWNER SYSTEM <loc>
 
Command Syntax:
>--- PREVOwner ---+--- HUB ---------------.
                  |                       |
                  |--- SYSTEM <loc> ------|
                  |                       |
                  ‘--- dbname ------------+--->
Related Commands:
HUBLOCATION, SYSTEMLOCATION, CHANGE PRIMARY
Querying:
>--- Query PRVRF --->
This query must be used at the appropriate element. For CHANGE PRIMARY, this is DBLOC 1 of <dbname>; for SYSTEMLOCATION, this is <loc>; for HUBLOCATION, this is
/*GL.
>--- Query NXTHB --->
If a problem occurs with the HUBLOCATION command, you can use this query at /*GL to query NXTHB. NXTHB is used to record the future new Hub until the HUBLOCATION command has completed.
1974 to current year. AVEVA Solutions Limited and its subsidiaries. All rights reserved.
AVEVA Logo