OpenTP1 Version 7 Operation
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 |
-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 |
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
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.