Verify APPC Connection (VFYAPPCCNN)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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).
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| RMTLOCNAME | Remote location | Character value | Required, Positional 1 |
| MODE | Mode | Communications name, *NETATR | Optional, Positional 2 |
| RMTUSER | Remote user ID | Character value, *NONE, *CURRENT | Optional |
| RMTPWD | Remote password | Character value, *NONE | Optional |
| MSGMODE | Message mode | *VERBOSE, *QUIET | Optional |
| PKTLEN | Packet length (in bytes) | 0-32763, 100 | Optional |
| NBRITER | Number of iterations | 1-32767, 2 | Optional |
| NBRPKT | Number of packets | 1-32767, 1 | Optional |
| ECHO | Echo | *YES, *NO | Optional |
| WAITTIME | Wait time (in seconds) | 2-3600, 10, *NOMAX, *NOWAIT | Optional |
| Top |
Remote location (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).
| Top |
Mode (MODE)
Specifies the name of the mode to be used for the APPC conversation.
- *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.
| Top |
Remote user ID (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, the command will fail.
- *CURRENT
- The user ID of the job (signed-on user) using this command is sent.
- character-value
- 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.
| Top |
Remote password (RMTPWD)
Specifies the password sent to the target system.
- *NONE
- The system does not send a password. If a user identifier (ID) is specified on the RMTUSER parameter and password security is active on the target system, the command will fail.
- character-value
- 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.
| Top |
Message mode (MSGMODE)
Specifies the amount of information displayed by the command.
- *VERBOSE
- Display verification message after each iteration.
- *QUIET
- Display only initial and summary messages.
| Top |
Packet length (in bytes) (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.
- 0-32763
- Specify the number of bytes for each packet.
| Top |
Number of iterations (NBRITER)
Specifies the number of iterations. For each iteration, the specified number of data packets are exchanged between the local and remote systems.
- 2
- Two iterations are performed.
- 1-32767
- Specify the number of iterations.
| Top |
Number of packets (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.
- 1-32767
- Specify the number of packets that are sent for each iteration.
| Top |
Echo (ECHO)
Whether the remote location should echo packets back to the local location.
- *YES
- Packets are echoed back from the remote location 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.
| Top |
Wait time (in seconds) (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.
- *NOMAX
- The system waits forever.
- *NOWAIT
- The system returns immediately if there is a connection ready and available.
- 2-3600
- Specify the number of seconds to wait.
| Top |
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.
| Top |
| Top |