This page applies to Multiple Resilience Configurations Only
Release 4.622 introduces two special flags that can be passed to the db_open() function, which cause the normal rules for initial network layout to be completely over-ridden. In theory you can still update the network layout table to change where a database is accessed, but it is not intended that you should do so. These flags are intended to provide a facility for programs which want to work with a database on one particular server to be able to do so without having to worry about how or whether AUXDISTR is loaded.
If this flag is specified AUXDISTR will set the initial layout for all tables so that all tables are accessed locally, and the network.local flag is TRUE for all tables. Any persistent network records which would normally be used to set the default layout for tables are ignored. However this flag will be ignored if the -nolocal command tail was passed to AUXDISTR.
This flag is similar to the LOCAL_ONLY flag, but if the program has previously set a server for remote file operations by updating network_status.file_server field, then the initial layout for all tables is that all tables are marked remote (even if the server is in fact the local server in a combined server/client configuration) and accessed on that server only. If the program has not set a file server then FILE_SERVER_ONLY is exactly equivalent to LOCAL_ONLY.
Please note the following limitations of these two flags:
These flags are only effective when the process opening the database does not not already have an open database handle for the database. They cannot be used to change the initial layout for a database that the program has already opened and not yet closed.
If you want to use these flags and are unsure as to whether the database is already open, you should either open the database, close it, and then open it again, or you should obtain a new connection handle to the database manager and open the database using that handle.
If you delete the default network layout record (the table 0) record, the default layout will revert to that specified by the command tails passed to AUXDISTR, but AUXDISTR will continue to ignore persistent network layout records. If you want to revert to normal operation then you should close the database and re-open it without using these special flags.
Updating the network status table after the database has been opened has no effect on the server to which database operations are directed when you specify FILE_SERVER_ONLY. All database operations are directed to the file server that was in effect at the time the database was opened.
Both these flags are ignored except by AUXDISTR.