CL Command Reference - APING
CL Command List > APING Reference
Description:
The Verify APPC Connection (VFYAPPCCNN) command, also known as APING, exchanges data packets between the local location and the specified remote location using Advanced Program-to-Program Communications, and measures the round-trip time of each data packet exchange iteration.
For this function to work, the remote location specified must be running the target portion of this function, APINGD (APING daemon).
Examples:
Example 1: Verify an APPC Connection
VFYAPPCCNN RMTLOCNAME(RPCNET.CHICAGO) NBRITER(3) NBRPKT(4)
PKTLEN(500)
This command exchanges four 500-byte packets in each of three iterations with remote location CHICAGO, network identifier RPCNET. The default mode used is taken from network attribute DFTMODE. Since the default MSGMODE(*VERBOSE) was taken, each iteration will result in an informational message in the job log indicating the elapsed time for the iteration.
Example 2: Using APING Alias Command
APING RMTLOCNAME(RPCNET.CHICAGO) NBRITER(3) NBRPKT(4) PKTLEN(500)
This command is equivalent to the command in Example 1 above.
Example 3: Using APING with a Wait Time
APING RMTLOCNAME(RPCNET.CHICAGO) WAITTIME(20)
This command will verify the connection with remote location CHICAGO, network identifier RPCNET. The maximum time to wait for a response from the remote location is 20 seconds.