Administrator Command Reference Manual
Command Details : Detailed Descriptions of Commands : RECONFIGURE (Reconfiguration)
RECONFIGURE (Reconfiguration)
Function:
Starts a reconfiguration operation. You can specify that the reference numbers stay the same in the reconfigured database. You can specify that session information such as the original session comment, session number, username and original date stays the same in the reconfigured database.
Description:
You can specify that the reference numbers stay the same in the reconfigured database. The SAMEREF option will fail if:
•
The database specified in the TO DB command has a different DB number from the database given in the FROM DB command.
•
An element already exists with the same reference number.
•
You can specify that session information stays the same in the reconfigured database by using the SESSIONS option:
•
The option is not valid for SYSTEM, or GLOBAL DBs.
•
The option is not available if you are doing a partial reconfiguration. You must use the RCFCOPY ALL command with RECONFIG SESSIONS.
•
For extracts, RECONFIG SESSIONS will be assumed, even if the option is not given.
•
For Draft DBs, the picture files will be ignored.
•
The reconfigured data must go TO a file.
•
After reconfiguration, data can be read back in from the file, replacing the original DB data. The SAMEREF option is assumed when reading the data.
•
When reading in data created by RECONFIG SESSIONS, the DB number and extract number must be the same as the originating DB number and extract number.
•
If errors occur when reading in data created by RECONFIG SESSIONS, the data is not saved unless you use the RECONFIG FORCE option.
The normal procedure for reconfiguring a database and maintaining the reference numbers is as follows:
1.
Reconfigure from the target database to a file.
2.
Delete the target database, and create a new one with the same DB number.
3.
Reconfigure from the file to the new database.
For Global projects, note the following:
•
To reconfigure the Global Database in a Global Project, give the command FROM GLOBAL followed by RECONFIGURE. For more information, see Reconfiguration.
•
In a Global Project, the TO NEW option is only valid at the Hub (see the TO command).
•
To reconfigure a satellite transaction database, reconfigure the DB to file, renew the file to empty it (see the RENEW command), stop the daemon at the satellite, and then reconfigure the transaction database from file. For information about reconfiguring a transaction database, refer to Transaction Database Management in Running Global Projects.
•
If the TO database is allocated to other locations, the Recover command should be used to copy the database to all secondary locations.
Examples:
RECONFIGURE
Command Syntax:
>--- RECONfigure ---+---- FORCE ----.
                    |               |
                    |--- SESSIONS --|
                    |               |
                    ‘--- SAMEREF ---+--->
Related Commands:
FROM, TO, RCFCOPY,
RENEW (Global project only)
1974 to current year. AVEVA Solutions Limited and its subsidiaries. All rights reserved.
AVEVA Logo