OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

1.2.7 Setting up environment for domain communication

Registering the domain representative schedule service in the domain data file makes it possible to perform domain qualification using dc_rpc_call(). In inter-domain communication, all the messages are sent to the destination schedule service via the domain representative schedule service.

A domain is composed of multiple OpenTP1 servers. Determine the OpenTP1 server that represents the domain. The schedule service of the OpenTP1 server becomes the domain representative schedule service. The user registers the domain representative schedule service with the host name in the domain data file. The domain data file refers to the hosts information file of DNS.

To perform domain-specified communication, issue an dc_rpc_call(), specifying the domain. On receiving a message, the domain representative schedule service passes it to the final destination schedule service in the domain.

Domain-specified communication requires the following settings:

Organization of this subsection
(1) Registering the domain representative schedule services
(2) Registering the port number of the domain representative schedule services
(3) System definitions
(4) When there is more than one schedule service in the same host

(1) Registering the domain representative schedule services

In a domain data file, three domain representative schedule services can be registered. Use the namdomainsetup command to register the host name of a domain representative schedule service. Only the superuser can register domain representative schedule services.

(2) Registering the port number of the domain representative schedule services

Register the port number of the domain representative schedule services in /etc/services. The port number of each domain must be the same and must be specified in the following format:

OpenTP1scd port-number/tcp alias-name

Register the port number of the domain representative schedule service in the /etc/services files of all the hosts where OpenTP1 is activated. However, if operated by NIS, register the port number in /etc/services of only the NIS server.

If issuing a domain-specified dc_rpc_call() when no port number is registered in /etc/services, error is returned with DCRPCER_NO_PORT.

(3) System definitions

  1. Schedule service definition
    Define the port number of the domain representative schedule service by specifying it in the scd_port operand of the schedule service definition. As the port number, specify the port number registered in /etc/services.
  2. System common definition
    Set the nodes that configure the local domain. Specify the node names by the all_node operand in the system common definition.

(4) When there is more than one schedule service in the same host

When starting more than one schedule service (OpenTP1) in the same host for multiOpenTP1 operation or system switchover, the schedule services have different port numbers. If assigning more than one schedule service in the same host to the domain representative schedule service, it is impossible to perform domain communication between the specified schedule services by issuing a domain-specified dc_rpc_call(). To start more than one schedule service in the same host, assign only one of them to the domain representative schedule service. The following shows the required environment settings.

  1. Registering the domain representative schedule service
    Register only one schedule service in the domain data file as the domain representative schedule service.
  2. Registering the port number
    Only one port number in /etc/services is registered. Register the port number for the schedule service registered in the domain data file.
  3. System definition
    Specify the port number for the domain representative schedule service by the scd_port operand in the schedule service definition. This is same as the port number registered in /etc/services.
    Specify the names of the nodes that configure the local domain by the all_node operand.