OpenTP1 Version 7 Operation

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

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

[Figure]

1 and 2: One line is displayed for each.

2: Displayed for the number of nodes when there are multiple nodes to be checked.

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.

About the startup status of the nodes to be displayed by using the namsvinf command
The meaning of the startup status displayed by the namsvinf command differs depending on whether the -b option is specified. The following table shows the cases mainly responsible for each type of startup status according to whether the -b option is specified.

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:
  • The version of OpenTP1 running on the displayed node does not support the namsvinf command.
  • The response message from the displayed node could not be received successfully due to a communications error or some other reason or due to expiration of the response reception wait time.
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.