10.2 Notes about operation

Organization of this section
(1) Operation commands and utilities
(2) Specifying the port number for connection from a client
(3) Starting and terminating HiRDB with setup identifier
(4) Relationship with the system switchover facility

(1) Operation commands and utilities

To execute HiRDB operation commands and utilities on a HiRDB that has been installed with a setup identifier specified, you need to specify environment variables. HiRDB provides an environment variable specification batch file and a work console that specifies the environment variables according to the operation command and utility execution environment.

(a) How to use the work console

To start the work console, from Start, choose Program, HiRDBSingleServer Setup Identifier or HiRDBParallelServer Setup Identifier, then HiRDB Command Prompt. Use this work console to execute operation commands and utilities.

(b) How to use the environment variable specification batch file

Copy the environment variable specification batch file (%PDDIR%\SAMPLE\sampleconf\HiRDBCMD.BAT) under a different name and then customize the file contents. If you customize the original batch file, it is overwritten during update installation. Use the copy of the environment variable specification batch file for executing operation commands and utilities.

To execute operation commands and utilities at the command prompt, you need the following environment variables:

Environment variableDescription
PDDIRSpecify the HiRDB installation directory.
PDCONFPATHSpecify the absolute path of the directory where HiRDB system definition files are to be stored. For unit control information, the system uses a file under %PDDIR%\conf regardless of this specification.
PATHAdd %PDDIR%\BIN\;%PDDIR%\CLIENT\UTL; at the beginning of the PATH environment variable.
PDUXPLDIRSpecify %PDDIR%\UXPLDIR.

(2) Specifying the port number for connection from a client

For the HiRDB port number for connection from a client, specify a unique port number in each HiRDB. To specify the port number, use the pd_name_port operand in the system common definitions. For details about the pd_name_port operand, see the manual HiRDB Version 9 System Definition.

(3) Starting and terminating HiRDB with setup identifier

If you have installed a HiRDB specifying a setup identifier, the setup identifier is required to start or terminate a service. To start or terminate a service, use the service name with the specified setup identifier attached.

(4) Relationship with the system switchover facility

(a) Registering with MSCS or MSFC

When you register with MSCS or MSFC and reconfigure HiRDB as a system switchover configuration, you must use the same setup identifiers for the running and standby systems.

(b) Migrating to system switchover configuration

When you use MSCS or MSFC to reconfigure HiRDB as a system switchover configuration, start the same service name on separate server machines. If there is an existing environment, you need to change the existing service name to avoid duplication. To change a service name, uninstall the HiRDB and then reinstall it in the same directory. If the directory structure is duplicated, you need to migrate the HiRDB server and create a new environment. For details about HiRDB server migration, see the HiRDB Version 9 System Operation Guide.