Administrator Command
Reference Manual
Command Details
:
Detailed Descriptions of Commands
: GENERATE (Global Project Administration - Hub only)
GENERATE (Global Project Administration - Hub only)
Function
:
Generates the files required for a new location.
Description
:
All the Project files are copied to a transfer directory at the Hub, ready for transmission to the new satellite. The transfer directory is specified by the environment variable
project_locid
where
project
is the 3-character project code and
locid
is the 3-character identifier of the new location.
Before the command is given, the environment variable must be set, the transfer directory must exist and contain the normal project sub-directories, and the transaction database for the location must already have been created. The project Hub should have already been initialised (or its LINIT attribute set True).
All the files in the Project will be copied to the transfer area. They must then be transferred to the Location before the Location is initialised.
After a LOC element has been created for a new Location, the LOCID and LOCREF must be set. The LOCID assigns a unique three-character code to the new Location. The LOCREF defines the position of the new Location within the network by specifying its unique parent Location.
This command sets the LINIT flag for an
offline
Location. The LINIT flag must be set by the INITIALISE command for an on-line Location.
If the ALLOCATE option is specified, all the Databases allocated to the Location’s Parent will be allocated to the new Location as well. The NOALLOCATE option means that no databases (other than its transaction database) will be allocated to the new Location: no database files will be copied to the transfer area.
Note:
That a transaction database must have been created for the location (and for the Hub), and the Hub must have been initialised.
When a location is generated, it will allocate the system database for that location to other locations as part of the generation process.
Examples:
GENERATE LOCATION LON
Generates a location with identifier LON. By default, all Databases at the Hub will be allocated to LON.
GENERATE LOCATION /LONDON
Generates a location
/LONDON
, allocating all databases.
GENERATE LOCATION LON NOALLOCate
Generates a location with identifier LON. No Databases will be allocated.
Note:
If the location identifier contains numeric characters, it must be enclosed in quotes
.
Command Syntax:
>-- GENerate LOCation <loc> --+--- ALLOCate -----.
| |
‘--- NOALLOCate ---+-->
Related Commands:
INITIALISE
For Offline locations:
TRANSFER
Querying
:
>--- Q LINIT --->
>--- Q DBALL --->
>--- Q DBPRIM --->
1974 to current year.
AVEVA Solutions Limited and its subsidiaries. All rights reserved.