CL Command Reference - PING
CL Command List > PING Reference
Description:
The Verify TCP/IP Connection (VFYTCPCNN) command, also known as PING, tests the connectivity between a system and the remote system specified by the remote system parameter.
Notes:
. The VFYTCPCNN (PING) command cannot be used to verify IP over SNA connections.
. The local domain name is used by many applications including PING. PING appends the local domain to a host name if a domain is not specified or if a period (.) does not appear at the end of the specified host name.
Examples:
Example 1: Verify TCP/IP Connection with a Specified Host Name
VFYTCPCNN RMTSYS(IPHOST) PKTLEN(100) NBRPKT(10) WAITTIME(15)
This command attempts to send 10 packets of 100 bytes each to a remote system (known to the TCP/IP configuration as IPHOST) over a TCP/IP link. Each packet transfer must take place within 15 seconds or it fails.
Example 2: Verify TCP/IP Connection with an IP Address
VFYTCPCNN RMTSYS(*INTNETADR) INTNETADR(¡¯128.1.1.10¡¯)
PKTLEN(100) NBRPKT(10) WAITTIME(15)
This command attempts to send 10 packets of 100 bytes each to a remote system over a TCP/IP interface. The user represents the RMTSYS with its internet address 128.1.1.10, rather than with an assigned system name. Each packet transfer that takes more that 15 seconds fails.
Example 3: Verify TCP/IP Connection with Host Name and Using a Specific Local Interface Address
VFYTCPCNN RMTSYS(IPHOST) MSGMODE(*QUIET) LCLINTNETA(¡¯9.2.2.3¡¯)
This command attempts to send 5 packets (default) of 256 bytes each (default) to a remote system over a specific TCP/IP interface that has the local address 9.2.2.3.
Because MSGMODE(*QUIET) is specified, only the primary output messages are displayed. The interface parameter is useful on multi-homed hosts to verify network connectivity through a specific physical interface.
Example 4: Verify TCP/IP Connection with an IP Version 6 Address
VFYTCPCNN RMTSYS(*INTNETADR) INTNETADR(¡¯1:2:3:4:5:6:7:8¡¯)
This command attempts to verify the TCP/IP connection of a remote system that has the local address of 1:2:3:4:5:6:7:8.
Example 5: Verify TCP/IP Connection with a Specified IP Version 6 Defined Host Name
VFYTCPCNN RMTSYS(IPV6HOST)
This command attempts to send 5 packets (default) of 256 bytes each (default) to a remote system (known to the IP Version 6 TCP/IP configuration as IPV6HOST) over a TCP/IP link.
The default ¡åAddress version format¡å is *CALC. Host name resolution may return multiple IP addresses for a given host name. But, in the case (*CALC), the first IP address (IP Version 4 or IP Version 6) resolved will be the address used when attempting to verify its connection over a TCP/IP link.
Example 6: Verify TCP/IP Connection and Explicitly Use IP Version 6 Host Name Resolution
VFYTCPCNN RMTSYS(IPV6HOST) ADRVERFMT(*IP6)
This command attempts to send 5 packets (default) of 256 bytes each (default) to a remote system (known to the IP Version 6 TCP/IP configuration as IPV6HOST) over a TCP/IP link.
This example differs from example 5 in that only a valid IP version 6 resolved address, for IPV6HOST, will be used when attempting to verify its connection over a TCP/IP link.