OpenTP1 Version 7 Operation
namsvinf (Display OpenTP1 server information)
Format
namsvinf {-b|[-r] [-w maximum-response-wait-time]} |
Function
The namsvinf command checks whether the OpenTP1 nodes specified in the all_node operand and the all_node_ex operand in the system common definition have started. Then the command displays the result and information about the OpenTP1 nodes (IP addresses and the port number of the name service).
Options
-b
Indicates whether OpenTP1 nodes are registered in the RPC suppression list in shared memory, but does not check whether OpenTP1 nodes have started. Either of the following characters is output depending on the registration status:
OpenTP1 nodes are registered in the RPC suppression list: D
OpenTP1 nodes are not registered in the RPC suppression list: A
This option cannot be specified together with the -r or -w option. If you do, an error occurs.
If you do not specify this option, the command checks whether OpenTP1 nodes have started. When Y is specified for the name_global_lookup operand in the name service definition, a global search is performed to check whether OpenTP1 nodes have started.
-r
Outputs the startup status of OpenTP1 nodes in the sequence they are checked.
This option cannot be specified together with the -b option. If you do, an error occurs.
If you do not specify this option, the startup statuses of all OpenTP1 nodes are output in a batch after all the startup statuses are checked.
-w maximum-response-wait-time ~<unsigned integer>((0-3600))<<8>>(unit: seconds)
Specify the maximum time to wait for a response which starts after an all_node information acquisition request is sent to OpenTP1 in the OpenTP1 nodes specified in the all_node operand, and the maximum time to wait for a response to a startup check request. If the -w option is specified, you must always specify the maximum response wait time. The startup status of an OpenTP1 node is S (transmission to the node is possible) if a response is not returned within the specified maximum response wait time.
This option cannot be specified together with the -b option. If you do, an error occurs.
If you do not specify all the options, the command checks whether OpenTP1 nodes have started, and shows the startup statuses of all nodes in a list after all the startup statuses are checked.
Output format
When all the options are omitted
Information is output in a batch when the startup check of all the nodes finishes. Therefore, it may take some time depending on the status of the target nodes.
If you do not specify both the -b option and the -r option, a message indicating the progress of checking is output to the standard output until the startup check finishes. The procedure from entering the command to the end of node information output is shown below.
1. Enter the command.
2. namsvinf:asking node information... is output.
3. namsvinf:checking alive... is output.
4. The output of node information begins.
5. The output of node information ends.
The system displays information about the nodes in the all_node operand of the node where the command is executed, and then information about the nodes in the all_node_ex operand.
Table 13-6 Node startup statuses displayed by the namsvinf command
Specification of the -b option | Startup status to be displayed | Main cause of displayed startup status |
---|---|---|
When the -b option is omitted | A (Normally running.) | OpenTP1 determined that the displayed node was operating normally because the version of the node supports the namsvinf command, the message for checking startup was sent successfully, and the response message was received successfully. |
D (Not started.) | OpenTP1 determined that the displayed node was not operating normally because the message to the node for checking the startup status of the node was not successfully sent due to a communications error or an inactive destination when the message was sent. | |
S (Transmission to the node is possible.) | OpenTP1 determined that messages could be sent to the node because the message for checking startup was sent successfully. No response message was received, however, the possible causes are as follows:
|
|
When the -b option is specified (communications for checking startup are not performed) | A (Normally running.) | The displayed node is not registered in the RPC suppression list. |
D (Not started.) | The displayed node is registered in the RPC suppression list. | |
Blank | The displayed node is specified in the all_node_ex operand. |
The displayed startup status does not change even when the -r and -w options are specified. However, if the value specified in the -w option is too small, the displayed startup status may change when the reception time expires.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.