OpenTP1 Version 7 Operation

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

namchgfl (Change domain configuration (by using the domain definition files))

Format

namchgfl [-n] [-d [-t time-for-monitoring-established-connection]] [-e]

Function

The namchgfl command changes the OpenTP1 domain configuration while OpenTP1 is running. Define the new domain configuration (arrangement of nodes) in the domain definition files for all_node and all_node_ex, and then execute the namchgfl command. The domain configuration in the domain definition files takes effect when the command successfully terminates. For details about the domain definition files, see 3.10.1(2) Using the namchgfl command to change the domain configuration.

The namchgfl command is available only when Y is specified in the name_domain_file_use operand in the system common definition. If you specify N in the name_domain_file_use operand, the command results in an error. You can execute the command only when OpenTP1 is running.

Options

-n

When you specify this option, the shared memory is not changed.

Specify this option only to check whether the nodes specified in the domain definition file for all_node can be stored in the area managed by the name service in the shared memory without changing the shared memory. When you specify the -e option, OpenTP1 checks the nodes specified in the domain definition file for all_node_ex as well. If all the nodes cannot be stored in the managed area in the shared memory, OpenTP1 outputs a message to the standard error output.

You cannot check the nodes that are specified in the all_node operand and the all_node_ex operand in the system common definition.

-d

Specify this option to check the startup status of the nodes specified in the domain definition file for all_node. OpenTP1 changes the node configuration only when all the nodes are active and the nodes specified in the domain definition file for all_node can be stored in the area managed by the name service in the shared memory. When you specify the -e option, OpenTP1 checks the nodes specified in the domain definition file for all_node_ex and includes those nodes in the new node configuration.

If there is an inactive node, OpenTP1 outputs information about the node to the standard output. However, depending on the startup status, OpenTP1 does not delete the service information from the area storing the service information of each node nor does it register or cancel the RPC suppression list. If there is no inactive node in the domain definition file for all_node and the domain definition file for all_node_ex (no node is specified or startup of all the nodes has been confirmed), OpenTP1 outputs no node information, including the header.

You cannot check the nodes specified in the all_node operand and the all_node_ex operand in the system common definition or include those nodes in the new node configuration.

Do not specify the -d option if you want to change the shared memory even though there is an inactive node among the nodes specified in the domain definition files.

-t time-for-monitoring-established-connection~<unsigned integer>((1-65535)) <<8>> (units: seconds)

Determines that an OpenTP1 node is inactive if the startup of the OpenTP1 node is not confirmed within the specified period of time.

The following table shows the options to be specified when you want to check the size of the area managed by the name service in the shared memory, check the startup status of the nodes, and change the shared memory.

Check the size of the area managed by the name service in the shared memory Check the startup status of the nodes Change the shared memory Options to be specified
Y N N namchgfl -n
Y Y N namchgfl -n -d
Y N Y namchgfl
Y Y Y# namchgfl -d

Legend:
Y: Performed.
N: Not performed.

#: If the size of the area managed by the name service in the shared memory does not permit the storage of all the nodes in the domain definition files, the shared memory is not changed.

-e

Checks the startup of the nodes specified in the domain definition file for all_node and the domain definition file for all_node_ex, and includes the started nodes in the new domain configuration. If you do not specify the -e option, OpenTP1 only checks the startup of the nodes specified in the domain definition file for all_node and includes those started nodes in the new domain configuration.

Output format

The output format is as follows when namchgfl -d -e is specified:

all_node information
No.|        Inactive node        | Port number
aaa|bb....bb                        |    ccccc
aaa|bb....bb                        |    ccccc
all_node_ex information
No.|        Inactive node        | Port number
aaa|bb....bb                        |    ccccc
aaa|bb....bb                        |    ccccc

aaa
Item number of the node (3-digit integer or smaller)

bb....bb
Name of the inactive node (maximum of 32 alphanumerics)

ccccc
Port number of the inactive node (5-digit integer or smaller)

Output messages

Message ID Description Output destination
KFCA00654-E The value of the all_node operand specified in the domain definition file exceeded the permitted limit. Standard error output
KFCA00655-E The value of the all_node_ex operand specified in the domain definition file exceeded the permitted limit. Standard error output
KFCA00656-E The specified node name is incorrect. Standard error output
KFCA00657-E The specified port number is incorrect. Standard error output
KFCA00658-W The same node information is defined more than once. Standard error output
KFCA00659-I The command (namchgfl) is started. Standard output
KFCA00660-I A startup check (namchgfl) has started. Standard output
KFCA00661-I A startup check (namchgfl) has ended. Standard output
KFCA00662-I Rewriting of the domain configuration (namchgfl) has ended. Standard output
KFCA00663-E The command (namchgfl) cannot be executed because N is specified for name_domain_file_use. Standard error output
KFCA00665-E An error occurred during analysis processing. Standard error output
KFCA00666-E The specified node name is undefined. Standard error output
KFCA00669-W The directory does not exist. OpenTP1 continues processing assuming that no operand is specified. Standard error output
KFCA00670-I No node is specified. The OpenTP1 system continues processing as a system that consists only of the local node. Standard output
KFCA00671-I The checking of the nodes specified in the domain definition file (namchgfl) has ended. Standard output
KFCA00672-E The command (namchgfl) ended abnormally. Standard error output

Notes