PREVOWNER (Global Project Administration - Hub Only)

Function:

Restores the Hub to its previous Location, or restores the previous Primary Location of a Database (DB), if the commands to change these attributes have failed.

CAUTION: This command should not be used, except under special circumstances.

Description:

If a CHANGE PRIMARY command on a DB fails, the DB 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 DB.

• 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 a built-in 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 built-in 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:

Command Syntax:

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, the administrator can use this query at /*GL to query NXTHB. NXTHB is used to record the future new Hub until the HUBLOCATION command has completed.

Related Commands:

HUBLOCATION (Global Project Administration - Hub only)

SYSTEMLOCATION (Global Project Administration - Hub Only)

CHANGE PRIMARY