TRANSFER (Global Project Administration)

Administrator Command Reference Manual

Command Details : Detailed Descriptions of Commands : TRANSFER (Global Project Administration)

Generate a directory containing copies of all database files at the current location, including inter-db macro files, for transfer between the Hub and an offline Location.

Description:

This command is used at the Hub and at an offline location. All the databases at the current location will be transferred. Before the command is given, the environment variable pointing at the transfer directory must be set, and the transfer directory must exist and contain the normal project sub-directories.

The current location must be either the Hub or an offline location. The location to which the files are transferred must be either the Hub or an offline location.

The transfer directory is specified by the environment variable project_loc where project is the 3-character project code and loc is the 3-character identifier of the remote location. For example, in a Project ABC where the Hub is CAM and the offline Satellite is SYD, the following environment variables must be set:


At CAM:	ABC_SYD
At SYD:	ABC_CAM

TRANSFER TO copies all the Project files to the transfer directory specified by the project_loc variable. The files are then physically transferred by some means (tape, FTP etc.), and read on to the transfer directory specified by the project_loc variable.

The System Administrator at the receiving end then uses the TRANSFER FROM command, which updates the Location with the transferred files.

Offline Location:

Special care should be taken when using CHANGE PRIMARY for an offline location. Before changing the primary location, it is important to make sure that the database at the new primary location is up-to-date. This may be done by using the TRANSFER TO command at the old primary location followed by the TRANSFER FROM command at the new primary location. All users should have left AVEVA E3D™ before this transfer is made. Any subsequent work on the database will be lost, due to the change in primary location.

Examples:


TRANSFER TO loc Copies all database files at the current location, together with appropriate inter db macro files etc. to the transfer directory specified by the project_loc variable. TRANSFER FROM loc Updates the current location with the files transferred from Location loc. Only databases that are allocated at the current location will be read in.

Note:

There is an additional option TRANSFER - FORCEPROPG which transfers all allocated DBs regardless of the Propagation flag. Refer to Transfer of Other Data for a detailed explanation of this option.

Related Commands:

GENERATE LOCATION

Command Syntax:


>--- TRANSFer ---+--- TO pathname <loc> ---. \| \| ‘--- FROM pathname -------+--->