VFYAPPCCNN (Verify APPC Connection)

VFYAPPCCNN Command syntax diagram

 

Purpose

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 (APPC), and measures the round-trip time of each data exchange.

For this function to work, the remote location specified must be running the target portion of this function, APINGD (APING daemon).

 

Required Parameters

RMTLOCNAME

Specifies the remote location to connect with. Specify the remote location name using the format nnnnnnnn.cccccccc, where nnnnnnnn is the network identifier (ID) and cccccccc is the remote location name. If only the remote location name is specified, the local network ID (LCLNETID) network attribute is used as the value of the network identifier (ID).

MODE

Specifies the APPC mode that is to be used.

*NETATR: The mode in the network attributes is used.

mode-name: Specify a mode name. Specify BLANK for a mode name consisting of eight blank characters.

Note: SNASVCMG and CPSVCMG are reserved names and cannot be specified.

RMTUSER

Specifies the user identifier (ID) for the target system. If a user ID is specified for this parameter and password security is active on the target system, RMTPWD(*NONE) is not valid.

*NONE: No user ID is sent. If security on the target system is configured to require a user ID, this command will fail.

*CURRENT: The user ID of the job (signed-on user) using this command is sent.

remote-user-identifier: Specify a user ID to use that exists on the target system. If a user ID is specified and password security is active on the target system, a password must be specified.

RMTPWD

Specifies the password sent to the target system.

*NONE: The system does not pass a password. If a user identifier (ID) is specified on the RMTUSER parameter and password security is active on the target system, this command will fail.

password: Specify a password sent to the target system to verify the sign-on of the user ID specified in the RMTUSER parameter. The password may or may not be substituted across the communication line depending on whether the remote system supports password substitution.

MSGMODE

Specifies the amount of information displayed by the command.

*VERBOSE: Display verification message after each iteration.

*QUIET: Display only the initial APING message and the summary message.

PKTLEN

Specifies the length (in bytes) of the packets that are exchanged between the local and remote systems.

100: The packet length is 100 bytes.

packet-length: Specify the length of the packet. Valid values range from 0 through 32763 bytes.

NBRITER

Specifies the number of iterations. For each iteration, the specified number of data packets are exchanged between the local and remote systems, and a timing measurement is taken.

2: Two iterations are performed.

number-of-iterations: Specify the number of iterations. Valid values range from 1 through 32767.

NBRPKT

Specifies the number of packets that are sent by the local system for each iteration before giving the target system permission to send.

1: One packet is sent for each iteration.

number-of-packets: Specify the number of packets that are sent for each iteration. Valid values range from 1 through 32767.

ECHO

Whether the remote location should echo packets back to the local location.

*YES: Packets are echoed from the remote location back to the local location.

*NO: Packets are sent from the local location to the remote location only; packets are not echoed back to the local location.

WAITTIME

Specifies the time in seconds to wait for the return (echo) before declaring the remote location to be unreachable.

10: The system waits 10 seconds for the remote location to respond.

*NOMAX: The system waits indefinitely.

*NOWAIT: The system returns immediately if there is not a connection ready and available.

wait-time: Specify the wait time in seconds. Valid values are 2 to 3600 seconds.

Examples for VFYAPPCCNN

Example 1: Verify 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: APING

APING   RMTLOCNAME(RPCNET.CHICAGO)
  NBRITER(3)  NBRPKT(4)  PKTLEN(500)

This command is equivalent to the command in example 1.

Example 3: APING

APING RMTLOCNAME(RPCNET.CHICAGO)                     
      WAITTIME(20)                                   

This command 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.

Error messages for VFYAPPCCNN

*ESCAPE Messages

CPF91CC

Command did not complete successfully.