Operands related to unit structure

192) pdunit -x host-name: -u unit-identifier; [-d "HiRDB-directory-name"]; [-c host-name]; [-p port-number]; This operand must be specified; it cannot be omitted.

HiRDB/Single Server

The unit structure of a HiRDB/Single Server or a utility special unit is defined. The following items can be specified:

Host name
Unit identifier
HiRDB directory name
Secondary system host name
Port number of the utility special unit (or port number of the HiRDB/Single Server)

Specification guidelines

This operand may be omitted if the system consists of a single HiRDB/Single Server. If this operand is omitted, the HiRDB directory specified by the pdsetup command is assumed. However, it cannot be omitted when the system switchover facility is used.
When a utility special unit is used, the unit information for the HiRDB/Single Server and for the utility special unit is specified in the system common definition of the HiRDB/Single Server. One pdunit operand is specified for the HiRDB/Single Server and another pdunit operand is specified for the utility special unit.
The unit information for the HiRDB/Single Server and for the utility special unit is specified in the system common definition of the utility special unit. One pdunit operand is specified for the HiRDB/Single Server that uses the utility special unit and another pdunit operand is specified for the utility special unit.
When the system switchover facility is used, the same definition must be applied to both the primary and secondary systems.
In the case of mutual system switchover, a multi-HiRDB structure is used (two different HiRDB/Single Servers coexist in a single host), and the same definition cannot be used for two different HiRDB/Single Servers.

Table 2-2 shows the host name when the pdunit operand's -x option and the pd_hostname operand are specified.

Table 2-2 Host name when pdunit operand's -x option and pd_hostname operand are specified (for HiRDB/Single Server)

Condition	pdunit operand's -x option value	pd_hostname operand value
System switchover facility is not used	Standard host name (host name, IP address, or FQDN)	Default or standard host name (host name, IP address, or FQDN)
	Host name other than the standard host name (host name, IP address, or FQDN)	Standard host name or the host name specified in the pdunit operand's -x option^#1 (host name, IP address, or FQDN)
	Loopback address (localhost or 127.0.0.1)^#2	Loopback address (localhost or 127.0.0.1)^#1#2
Monitor mode (IP address inherited)	Relocatable IP address, host name with a relocatable IP address, or FQDN	Standard host name or the host name specified in the pdunit operand's -x option^#1 (host name, IP address, or FQDN) (host name, IP address, or FQDN)
Monitor mode (IP address inherited)	Loopback address (localhost or 127.0.0.1)^#2	Loopback address (localhost or 127.0.0.1)^#1#2
Server mode (IP address inherited)	Relocatable IP address, host name with a relocatable IP address, or FQDN	Primary system's standard host name (host name, IP address, or FQDN)
Monitor mode or server mode (IP address not inherited)^#³	Primary system's host name (host name, IP address, or FQDN)	Primary system's standard host name (host name, IP address, or FQDN)

Note: If the standard host name is specified as FQDN in the pdunit operand's -x option or in the pd_hostname operand, the standard host name must be defined in the FQDN format.

#1: Use the same format as in the pdunit operand's -x option.

#2: localhost can be specified if it can be used as the host name (such as when it is already set in the hosts file or name server).

#3

Specify the secondary system's host name (host name, IP address, or FQDN) in the pdunit operand's -c option.

Note

When a utility special unit is used, HiRDB uses the host name specified by this operand to effect communication between the HiRDB/Single Server and the utility special unit. Therefore, if the host name specification is incorrect, various types of communication errors and timeouts may occur.

-x host-name

<host name>((1-32 characters))

Specifies in one of the formats listed below the host name of the server machine in which the HiRDB/Single Server is defined. Always use the same specification format for a server machine. For example, once a host name is specified, an IP address must not be specified for a host on the same server machine.

host name
IP address
FQDN
loopback address (localhost or 127.0.0.1)

For specification examples, see Settings for a DNS server to manage IP addresses in the HiRDB Version 8 Installation and Design Guide.

When specifying the host name

You cannot specify aliases for host names.
If you do not use a DNS server, register the host name specified here in the hosts file.

When specifying the loopback address

Use the multi-connection address facility or high-speed connection facility. If these functions are not used, the HiRDB server cannot be accessed from other server machines.

-u unit-identifier: <identifier>((4 characters)); Specifies a unit identifier. The unit identifier specified here is also specified in the pd_unit_id operand in the unit control information definition.

-d "HiRDB-directory-name": <pathname of up to 128 characters><</opt/HiRDB_S>>; Specifies the name of the HiRDB directory.

-c host-name

<host name>((1-32 characters))

Specifies the secondary system's host name in one of the formats listed below. You specify this option for system switchover in which IP addresses are not inherited. Always use the same specification format for a server machine. For example, once a host name is specified, an IP address must not be specified for a host on the same server machine.

host name
IP address
FQDN
loopback address (localhost or 127.0.0.1)

Do not specify this option for a utility special unit because system switchover cannot be performed for a utility special unit. If this option is specified, a definition error occurs and HiRDB cannot start.

When specifying the host name

You cannot specify aliases for host names.
If you do not use a DNS server, register the host name specified here in the hosts file.

When specifying the loopback address

Use the multi-connection address facility or high-speed connection facility. If these functions are not used, the HiRDB server cannot be accessed from other server machines.

-p port-number

<unsigned integer>((5001-65535))

Specifies the port number of the HiRDB at the other system that uses the local system (the same number as in the pd_name_port operand of the system common definition).

If this option is omitted, the local system's port number (the value specified by the pd_name_port operand of the system common definition) is assumed.

Specification guidelines

For a HiRDB/Single Server, the port number of the utility special unit that will be used by the HiRDB/Single Server is specified.
For a utility special unit, the port number of the HiRDB/Single Server that will use the utility special unit is specified. This option enables utility special units with different port numbers to be used.
This option must be specified when a single utility special unit will be shared in a multi-HiRDB configuration.

Notes

Specify a number that is not within the range of port numbers assigned automatically by the OS. The range of port numbers assigned automatically by the OS depends on the OS.
If a port number is specified that is within the range of port numbers assigned automatically by the OS, that number might be in use by another program. If it is, the HiRDB server will not start.

HiRDB/Parallel Server

The unit structure of a HiRDB/Parallel Server is defined. The following items can be specified:

Host name
Unit identifier
HiRDB directory name
Secondary system host name
Unit port number

Specification guidelines

This operand may be omitted if the system consists of a single unit. If this operand is omitted, the HiRDB directory specified by the pdsetup command is assumed.
Information on all units that comprise the HiRDB/Parallel Server must be defined with this operand. For example, if there are three units, three pdunit operands must be specified.
This operand cannot be omitted when the system switchover facility is used.
When the system switchover facility is used, the same definition must be applied to both the primary and secondary systems.
In the case of mutual system switchover, a multi-HiRDB structure is used (two different units coexist in a single host), and the same definition cannot be used for two different units.

Table 2-3 shows the host name when the pdunit operand's -x option and the pd_hostname operand are specified.

Table 2-3 Host name when pdunit operand's -x option and pd_hostname operand are specified (for HiRDB/Parallel Server)

Condition	pdunit operand's -x option value	pd_hostname operand value
System switchover facility is not used	Standard host name (host name, IP address, or FQDN)	Default or standard host name (host name, IP address, or FQDN)
System switchover facility is not used	Host name other than the standard host name (host name, IP address, or FQDN)	Standard host name (host name, IP address, or FQDN)
Monitor mode or server mode (IP address inherited)	Relocatable IP address, host name with a relocatable IP address, or FQDN	Primary system's standard host name (host name, IP address, or FQDN)
Monitor mode or server mode (IP address not inherited)^#¹	Primary system's host name (host name, IP address, or FQDN)	Primary system's standard host name (host name, IP address, or FQDN)

Note: If the standard host name is specified as FQDN in the pdunit operand's -x option or in the pd_hostname operand, the standard host name must be defined in the FQDN format.

#1

Specify the secondary system's host name (host name, IP address, or FQDN) in the pdunit operand's -c option.
The same host name cannot be specified more than once in the pdunit operand's -x and -c options. The following shows examples of correct and incorrect specifications:

Correct examples

pdunit -x hostA ... -c hostAA

pdunit -x hostB ... -c hostBB

Incorrect examples

pdunit -x hostA ... -c hostB

pdunit -x hostB ... -c hostA

For an example of HiRDB system definition that uses system switchover in which IP addresses are not inherited, see C.5 Example 5 (HiRDB/Parallel Server: when the standby system switchover facility is used).

-x host-name

<host name>((1-32 characters))

Specifies in one of the formats listed below the host name of the server machine in which the HiRDB/Parallel Server is defined. Always use the same specification format for a server machine. For example, once a host name is specified, an IP address must not be specified for a host on the same server machine.

host name
IP address
FQDN

For specification examples, see Settings for a DNS server to manage IP addresses in the HiRDB Version 8 Installation and Design Guide.

When specifying the host name

You cannot specify aliases for host names.
If you do not use a DNS server, register the host name specified here in the hosts file.

-u unit-identifier: <identifier>((4 characters)); Specifies a unit identifier. The unit identifier specified here is also specified in the pd_unit_id operand in the unit control information definition of each unit.

-d "HiRDB-directory-name": <pathname of up to 128 characters><</opt/HiRDB_P>>; Specifies the name of the HiRDB directory.

Notes

When using the standby-less system switchover (1:1) facility
Specify the same HiRDB directory name in the normal and back-end server units.
When using the standby-less system switchover (effects distributed) facility
Specify the same HiRDB directory name in all units belonging to the same HA group.

-c host-name

<host name>((1-32 characters))

host name
IP address
FQDN

This option cannot be specified for the units described below. If it is specified, HiRDB cannot start (message KFPS01896-E is output).

Unit to which the standby-less system switchover (1:1) facility is applied. (IP address inheriting does not occur.)
Unit to which the standby-less system switchover (effects distributed) facility is applied. (IP address inheriting does not occur.)
Utility special unit (A utility special unit cannot switch systems.)

When specifying the host name

You cannot specify aliases for host names.
If you do not use a DNS server, register the host name specified here in the hosts file.

-p port-number

<unsigned integer>((5001-65535))

This option is specified when the system switchover facility is used. Specifies the port number of the unit.

If this option is omitted, the port number of the local system (the value of the pd_name_port operand) is assumed.

Specification guidelines

For the unit in which the system manager is located, the port number specified in pd_name_port is specified.
For a unit in which the system manager is not located, the port number of that unit is specified.
If there are multiple units in a single server machine, as in a mutual system switchover configuration, a different port number must be specified for each unit.

Notes

Specify a number that is not within the range of port numbers assigned automatically by the OS. The range of port numbers assigned automatically by the OS depends on the OS.
If a port number is specified that is within the range of port numbers assigned automatically by the OS, that number might be being used by another program. If it is, HiRDB cannot start.
If you use the standby-less system switchover (1:1) facility, specify the same port number for the normal BES unit and the alternate BES unit.
If you use the standby-less system switchover (effects distributed) facility, specify the same port number for all units belonging to the same HA group.

2.3.39 Operands related to unit structure