Each HiRDB administrator separately defined with a multi-HiRDB server uses the PDDIR environment variable to identify his/her own HiRDB. Specify the HiRDB directory in the PDDIR environment variable for each HiRDB administrator.

If you specify $PDDIR/bin in the PATH environment variable for each HiRDB, only the previously specified HiRDB operation commands in PATH become available. To operate each HiRDB individually, you should provide a window for each HiRDB and define the environment variable for each window.

For details about the environment variables, see 2.3.4 Setting environment variables.

Create a HiRDB system definition for each HiRDB. Specify the following information appropriately to each HiRDB in the HiRDB system definition:

• HiRDB identifier (pd_system_id operand in the system common definition)
• HiRDB port number (pd_name_port operand in the system common definition)
• Unit identifier (pd_unit_id operand in the unit control information definition)

Use the PDNAMEPORT operand of the client environment definition to specify a HiRDB to be accessed from a client. Specify the port number of a HiRDB to be accessed in the PDNAMEPORT operand. For details about the client environment definition, see the HiRDB Version 9 UAP Development Guide.

When the utility special unit facility is to be provided for a multi-HiRDB, one of the following system configurations can be selected:

1. System configuration in which one utility special unit is installed for each HiRDB.
2. System configuration in which one utility special unit is shared among multiple HiRDBs.

Configuration 1 should be used if different applications are to be executed by the individual HiRDBs. Configuration 2 should be used when the system switching facility is to be used in a mutual system switching configuration.

Figure 10-1 Example of utility special unit installation for a multi-HiRDB system: One utility special unit provided for each HiRDB system and Figure 10-2 Example of utility special unit installation for a multi-HiRDB system: One utility special unit shared among multiple HiRDB systems show examples of utility special unit installation for a multi-HiRDB.

Figure 10-1 Example of utility special unit installation for a multi-HiRDB system: One utility special unit provided for each HiRDB system

Figure 10-2 Example of utility special unit installation for a multi-HiRDB system: One utility special unit shared among multiple HiRDB system

All HiRDBs constituting the multi-HiRDB can share a portion of a library in the installation directory (/opt/HiRDB_S or /opt/HiRDB_P). You can save memory by using the pdmemsv -s command to share a portion of the library.

To share a portion of a library, the following conditions must be satisfied:

• All HiRDBs constituting the multi-HiRDB must be the same version.
• All HiRDBs constituting the multi-HiRDB use the same character encoding.
• All HiRDBs constituting the multi-HiRDB use the same load type (the POSIX library must be used with all HiRDBs).

If you share a library, place the installation directory and the HiRDB directory on separate volumes. If you do this and a hard disk failure affects the installation directory, you can use the pdmemsv -d command to cancel library sharing and enable HiRDB operation. The following shows the procedure for sharing a library:

# pdsetup /USERS/DB1           1
# pdsetup -d /USERS/DB1        2
# PDDIR="USERS/DB1"            3
# export PDDIR
# $PDDIR/bin/pdmemsv -s        4
# pdsetup /USERS/DB1           5

Explanation:

This procedure must be executed by the superuser.

1. Sets up the HiRDB environment in a directory other than the installation directory.
2. Releases the HiRDB registration from the OS. When the KFPS0036-Q message is displayed, enter n as the response.
3. Defines the PDDIR environment variable.
4. Sharing the library.
5. Registers the HiRDB into the OS again.

Note

When reinstalling HiRDB, use the pdmemsv -d command to release library sharing. After reinstalling, re-execute the pdmemsv -s command to share libraries.

When you execute the pdsetup -d command, if you respond with y to message KFPS00036-Q and cancel registration with the OS, re-execute the pdmemsv command using the procedure described above.