ADMINISTER (Global Project Administration - Remote Administration)

Administrator Command Reference Manual

Command Details : Detailed Descriptions of Commands : ADMINISTER (Global Project Administration - Remote Administration)

ADMINISTER (Global Project Administration - Remote Administration)

Creates or opens a system database to allow you to administer a remote location.

Description:

Before you can use this command:

•

The Location must have been created using the NEW LOC command, and its Location identifier must have been set. For example:

•

The system database of the new Location must be made Primary at the administering Location using the SYSTEMLOCATION command. For example:

SYSTEMLOC /AAA PRIMARY AT /BBB

where /AAA is the identifier of the new Location, and /BBB is the identifier of the Administering Location, that is, the location where the System database for the Location will be Primary.

The NEWSYSTEM option is only available at the Hub. It creates a system database for a new location in the transfer area. (This is similar to the GENERATE LOCATION command.)

The system database created is a copy of the Hub system database without MDBs and with only a SYSTEM user. The Administrator at the Hub can then create Users and MDBs (as well as Teams and Databases) for the Location before it is set up.

The SYSTEM option is available at the Administering Location, that is, the location where the System database for the Location is Primary. This may be the Hub or another Satellite. This command will close the local system database and open the appropriate satellite system database. The database will be opened with Write access unless the READONLY keyword is used.

After the SYSTEM or NEWSYSTEM commands have been given, you will be able to carry out administration tasks for the remote location. To return to administering your own (current) Location, give the command ADMINISTER LOCAL. To return to administering the last system database which was open, give the command ADMINISTER SAME.

Any location may issue an ADMINISTER command for another other location’s system database. If the system database is not Primary, then the system database will be opened READONLY.

Once you have selected a remote system database, you can give most ADMIN commands, which will operate on the remote Location. In particular, the following commands can be used for housekeeping tasks on the remote System Database:
The Hub will not be allowed to REPLICATE the project when it is administering a remote location, since the wrong system database will be replicated. However REPLICATE SYSTEM commands (which generate macros to replicate the project structure) will still be valid.


EXPUNGE SYSTEM MERGE CHANGES SYSTEM CHECK SYSTEM RECONFIGURE SYSTEM

The administered location will still be able to lock or isolate the project locally. It will also be able to administer its primary constructor databases by using the REMOTE <loc> command, where <loc> is its own location identifier, followed by one of the normal commands:
Reconfiguration will also be possible provided that suitable databases are primary at the location.


EXPUNGE BACKTRACK MERGE CHANGES REVERT CHECK


ADMINISTER NEWSYSTEM /Cambridge ADMINISTER NEWSYSTEM 'CAM' Allows the Hub Administrator to create data (Users, MDBs etc) for a Location in the transfer directory. ADMINISTER SYSTEM /Cambridge ADMINISTER SYSTEM 'CAM' Allows any System Administrator to read the System Database for Cambridge. Only the Administrator at the Location where the Cambridge System Database is Primary will have write access to it. ADMINISTER SYSTEM SAME Allows a System Administrator who is administering other Locations to open the last System database opened. ADMINISTER SYSTEM LOCAL Allows a System Administrator who is administering other Locations to open the local System database. ADMINISTER SYSTEM AT /Cambridge ADMINISTER SYSTEM LOCAL READONLY This is equivalent to entering the ADMIN module as ADMIN READONLY.

Command Syntax:


>-- ADMINISTER --+--- NEWSYSTEM <loc> -----------------------------. \| \| ‘--- SYSTEM ------+-- AT <loc> ---. \| \| \| \| \|--- SAME -------\| \| \| \| \| ‘--- LOCAL ------+--- READONLY --\| \| \| ‘---------------+--->

Querying:


>--- Q CURLOC --->	Returns the true current location
>--- Q ADMLOC --->	Returns the currently administered location

1974 to current year. AVEVA Solutions Limited and its subsidiaries. All rights reserved.