jp1ping
- Organization of this page
Function
The jp1ping command displays the IP address corresponding to a specified host name and its communication result (the result of executing the ping command) for the IP address, based on the JP1/Base communiation settings.
Use this command to check the validity of network settings for a host that has multiple network interfaces (a host assigned multiple IP addresses for a single host name).
Format
jp1ping [-h logical-host-name] [-v] [-s] host-name
Required execution permission
In Windows: None.
In UNIX: None.
Command directory
- In Windows:
-
installation-folder\bin\
- In UNIX:
-
/opt/jp1base/bin/
Arguments
-h logical-host-name
When using JP1/Base in a cluster system, specify the logical host for which you want to execute the jp1ping command. If you omit this option, the host name set in the environment variable JP1_HOSTNAME is assumed. If the environment variable JP1_HOSTNAME is not set, the physical host name is assumed.
-v
Specify this option to display the IP addresses resolved from the host name under the heading Resolved Host List, with each address on its own line. If you omit this option, the IP addresses in Resolved Host List are displayed all on one line separated by commas.
-s
Specify this option to display how many seconds it took to resolve the IP addresses from the host name, beside Time Required.
host-name
Specify the name of a host on the network.
Notes
-
If you specify a logical host name that does not exist, the following message is output and processing stops.
The specified logical host does not exist.
-
If you specify the -h option more than once, the logical host name in the -h option specified last takes effect.
-
If you specify multiple host names, the host name specified first takes effect.
Return values
0 |
Normal end |
-1 |
Invalid option (in Windows) |
255 |
Invalid option (in UNIX) |
Other than 0 |
Abnormal end (but the command ends normally if the command usage is displayed after command execution without any arguments specified) |
Example
The following shows a result (output example) of executing the jp1ping command to check what IP address server1 is using:
C:\>jp1ping server1 LogicalHostnameKey : no define. use JP1_DEFAULT jp1hosts : no entry. extract hostlist is disabled. Search jp1hosts : server1 is not found. Resolved Host List : server1 -> server1.hitachi.co.jp(172.16.0.10, 172.16.0.20), Check with ping command --- Pinging 172.16.0.10 with 32bytes of data: Reply from 172.16.0.10: bytes=32 time<10ms TTL=128 Reply from 172.16.0.10: bytes=32 time<10ms TTL=128 Reply from 172.16.0.10: bytes=32 time<10ms TTL=128 Reply from 172.16.0.10: bytes=32 time<10ms TTL=128 Pinging 172.16.0.20 with 32bytes of data: Reply from 172.16.0.20: bytes=32 time<10ms TTL=128 Reply from 172.16.0.20: bytes=32 time<10ms TTL=128 Reply from 172.16.0.20: bytes=32 time<10ms TTL=128 Reply from 172.16.0.20: bytes=32 time<10ms TTL=128 C:\>
From the output, you can tell that the host name server1 resolved to the two IP addresses 172.16.0.10 and 172.16.0.20, and that the pinging to the NIC is actually enabled.
The following shows the command output when the -v option and -s option are specified.
C:\>jp1ping -v -s server1 : Time Required : 0.005sec Resolved Host List : server1 -> server1.hitachi.co.jp (1) 172.16.0.10 (2) 172.16.0.20 Check with ping command --- :