Specifying the operands explained here can shorten the time to connect to a foreign HiRDB server. The following table shows a list of the operands necessary for connecting to a foreign HiRDB server.
Operand name | When the foreign server is a HiRDB/Single Server | When the foreign server is a HiRDB/Parallel Server |
---|
Regular connection | High-speed connection | Single front-end server | Multi front-end servers |
---|
Regular connection | High-speed connection | Regular connection | Connection to a specific front-end server |
---|
FES host direct | High-speed |
---|
PDHOST | Y | Y | Y | Y | Y | Y | Y |
PDFESHOST | N | N | N | Y | N | Y | Y |
PDNAMEPORT | Y | Y | Y | Y | Y | Y | Y |
PDSERVICEPORT | N | Y | N | Y | N | N | Y |
PDSERVICEGRP | N | Y | N | Y | N | Y | Y |
- Legend:
- Y: Must be specified.
- N: Need not be specified.
- 13) PDHOST foreign-HiRDB-host-name[,foreign-HiRDB-secondary-system-host-name]
<host name>- Specifies the host name of a foreign HiRDB (HiRDB at a foreign server).
- If the foreign HiRDB is a HiRDB/Single Server, this operand specifies the host name of the server machine where the single server is located. If the foreign HiRDB is a HiRDB/Parallel Server, this operand specifies the host name of the server machine where the system manager is located.
- The function and specification method of this operand are the same as those of the PDHOST operand of the client environment definition. For details on the PDHOST operand, see the HiRDB Version 8 UAP Development Guide. If the HiRDB version number of the foreign server is different, see the manual for the correct version.
- 14) PDFESHOST foreign-HiRDB-front-end-server-host-name[:foreign-HiRDB-front-end-server-port-number][,foreign-HiRDB-secondary-system-front-end-server-host-name[:foreign-HiRDB-secondary-system-front-end-server-port-number]]
<identifier>- Specify this operand if the foreign HiRDB is a multi front-end server. Specify the host name of the connection target front-end server for the foreign HiRDB. If this operand is omitted, the foreign HiRDB decides to which front-end server to be connected.
- The function and specification method of this operand are the same as those of the PDFEHOST operand of the client environment definition. For details on the PDFEHOST operand, see the HiRDB Version 8 UAP Development Guide. If the HiRDB version number of the foreign server is different, see the manual for the correct version.
- 15) PDNAMEPORT foreign-HiRDB-port-number
<unsigned integer>((5001-65535))- Specifies the port number of the foreign HiRDB (the value of the pd_name_port operand of the foreign HiRDB). This operand is required and cannot be omitted.
- The function and specification method of this operand are the same as those of the PDNAMEPORT operand of the client environment definition. For details on the PDNAMEPORT operand, see the HiRDB Version 8 UAP Development Guide. If the HiRDB version number of the foreign server is different, see the manual for the correct version.
- 16) PDSERVICEPORT foreign-HiRDB-high-speed-connection-port-number[,foreign-HiRDB-secondary-system-high-speed-connection-port-number]
<unsigned integer>((5001-65535))- Specifies the port number for high-speed connection. Specify a value for the pd_service_port operand of the foreign HiRDB. Specifying this operand can shorten the time needed to connect to the foreign HiRDB.
- The function and specification method of this operand are the same as those of the PDSERVICEPORT operand of the client environment definition. For details on the PDSERVICEPORT operand, see the HiRDB Version 8 UAP Development Guide. If the HiRDB version number of the foreign server is different, see the manual for the correct version.
- 17) PDSERVICEGRP foreign-HiRDB-server-name
<character string>- Specifies the server name of the foreign HiRDB. If the foreign HiRDB is a HiRDB/Single Server, this operand specifies a single server name. If the foreign HiRDB is a HiRDB/Parallel Server, this operand specifies a front-end server name. If the foreign HiRDB is a multi front-end server, this operand specifies the name of the connection target front-end server.
- The function and specification method of this operand are the same as those of the PDSERVICEGRP operand of the client environment definition. For details on the PDSERVICEGRP operand, see the HiRDB Version 8 UAP Development Guide. If the HiRDB version number of the foreign server is different, see the manual for the correct version.
- 18) PDSRVTYPE WS | PC
- Specifies a foreign HiRDB type.
- WS: Specify this option when the foreign HiRDB is the UNIX version.
- PC: Specify this option when the foreign HiRDB is the Windows version.
- 19) PDCLTRCVPORT receive-port-range-to-be-reserved
<unsigned integer>((5001-65535))- Specifies the reservation range of the port numbers to be used for communication with the foreign HiRDB. If this operand is omitted, the OS automatically assigns available ports. Therefore, normally you need not specify this operand.
- Operand specification methods
- Specification examples of this operand follow.
- To use a single port number (10000)
PDCLTRCVPORT 10000
- To specify a port number range (10000-105000)
PDCLTRCVPORT 10000 - 10500
- Specification guideline
- Specify this operand so that there will be no port number shortage. The number of port numbers necessary is as follows:
- Number of port numbers necessary > Value of the pd_max_bes_process operand of the foreign HiRDB
- Note
- If a unit contains multiple back-end servers for connecting to the foreign server, be careful about the value to be specified for this operand. If the value specified for this operand is duplicated in foreign server definitions (that is, if the same range of port numbers is reserved), the overlapping range of port numbers is used by the back-end servers. Consequently, a port number shortage may occur.
- The function and specification method of this operand are the same as those of the PDCLTRCVPORT operand of the client environment definition. For details on the PDCLTRCVPORT operand, see the HiRDB Version 8 UAP Development Guide. If the HiRDB version number of the foreign server is different, see the manual for the correct version.
- 20) PDCLTRCVADDR back-end-server-IP-address-or-host-name-for-connecting-to-foreign-server
<unsigned integer> or <identifier>- Specify this operand if multiple communication routes are provided in the server machine (where the back-end server for connecting to the foreign server is located) is used. Specify the IP address or host name of the communication route to be used for communication with the foreign server.
- If this operand is omitted, the IP address of the standard host name of the server machine where the back-end server for connecting to the foreign server is located is used.
- The function and specification method of this operand are the same as those of the PDCLTRCVADDR operand of the client environment definition. For details on the PDCLTRCVADDR operand, see the HiRDB Version 8 UAP Development Guide. If the HiRDB version number of the foreign server is different, see the manual for the correct version.
- 21) PDAUTORECONNECT YES | NO
- Specifies whether to use the automatic reconnect facility for the foreign HiRDB. For details on the automatic reconnect facility, see the HiRDB Version 8 UAP Development Guide.
- YES: Uses the automatic reconnect facility.
- NO: Does not use the automatic reconnect facility.
- The CONNECT retry count and CONNECT retry interval for reconnection are specified by the PDRCCOUNT and PDRCINTERVAL operands of the foreign server information definition.
- The function and specification method of this operand are the same as those of the PDAUTORECONNECT operand of the client environment definition. For details on the PDAUTORECONNECT operand, see the HiRDB Version 8 UAP Development Guide.
- 22) PDRCCOUNT maximum-number-of-CONNECT-retries-using-automatic-reconnect-facility
<unsigned integer>((1-200)) <<5>>- Specifies the maximum number of CONNECT retries for reconnecting using the automatic reconnect facility. If the number of CONNECT retries exceeds the value of this operand, the attempt to connect to the foreign server is cancelled.
- Condition
- The PDAUTORECONNECT operand of the foreign server information definition must be set to YES.
- 23) PDRCINTERVAL CONNECT-retry-interval-for-using-automatic-reconnect-facility
<unsigned integer>((0-600)) <<5>> (seconds)- Specifies the CONNECT retry interval (units: seconds) to be used for reconnecting using the automatic reconnect facility.
- Condition
- The PDAUTORECONNECT operand of the foreign server information definition must be set to YES.