D NET,APING performs a VTAM-based Advanced Peer to Peer Networking (APPN) Ping test from the originating host to the remote host. The D NET,APING command is the VTAM-based equivalent of the TCP/IP Ping command. D NET,APING is used to diagnose APPN availability and response time issues for a specific APPN Transmission Group (TG) that may be defined between two APPN endpoints, or to test network connectivity of Enterprise Extender links.
D NET,APING also has the capability to designate a specific logon mode table (LOGMODE) that is used to test network connectivity of Enterprise Extender (EE) links. Because each defined EE UDP port has an associated priority assigned to it, D NET,APING tests a specific UDP port relative to that port’s TOS (Types of Service) priority assignment. This test can be extremely useful to verify and compare newer High Performance Routing/Enterpise Extender (HPR/EE) connections from the perspective of APPN as well as from TCP/IP. To test connectivity as well as network reponse time, you must first specify a destination Control Point (CP) or host for the resource name ID parameter, and then choose to either use the defaults or specify one or more of six optional D NET,APING parameters before submitting the command.
Once the D NET,APING command has been submitted, it sends an ‘echo’ request to the foreign node or CP to determine if the remote host or resource is accessible. If a response to the D NET,APING command is received, information is provided regarding the LOGMODE and Class of Service (COS) used as well as TG information. It then returns D NET,APING test iteration response data as well as summaries of the minimum, average, and maximum response times in milliseconds for the specified test period.
The standard syntax for issuing the D NET,APING command via VTAM is:
D
NET,APING,ID=SSCP2X,SIZE=100,LOGMODE=#INTER,ITER=2,CONSEC=1,
TP=APINGD,ECHO=YES
The following parameters are available for the D NET,APING command:
CP or Resource Name |
The destination Control Point or Resource Name ID to which the D NET,APING request will be sent. You can enter up to 8 characters for a Resource Name. You must enter a CP or Resource Name in this field. |
Packet Size for Each Send |
Default=100. The size in bytes for each test packet. Valid values are 1 to 32,763. |
Logon Mode Name |
Default=#INTER. The Logon Mode Name must be taken from the default logon mode table (ISTINCLM), but cannot be the names CPSVCMG, CPSVRMGR, OR SNASVCMG. |
Number of Iterations |
Default=2. The number of ‘send and receive’ iteration tests to be performed before the test ends. Valid values are 0 to 32,763. Specifying a value of 0 will perform a transaction program version exchange only. |
Number of Consecutive Packets (Per Iteration) |
Default=1. The number per iteration of consecutive packets as defined by the size parameter. Valid values are 0 to 32,763. Specifying a value of 0 will perform a transaction program version exchange only. |
Destination Transaction Program Name |
Default=APINGD. The Destination Transaction Program (TP) Name for data to be sent to for acknowledgment, and optionally to return. You can enter up to 64 characters. The default name is available in most VTAM environments. If unavailable, specify another TP Name. |
ECHO Data Back to Sender |
Default=YES. Indicates that you want to data to be returned to the sending transaction (if the remote TP supports ECHO). |
User ID |
Optional field. Use for conversation level security. You must also specify a Password. You can enter up to 8 characters. |
Password |
Optional field. Use with your User ID for conversation level security. The password you enter will not display for security purposes. You can enter up to 8 characters. |
The Commands module provides the following D NET,APING command formats:
APING – Use Defaults |
Use the D NET,APING command with the defaults listed above. |
APING – Change Parameters |
Modify selected parameters from their default values. |
To use the D NET,APING command under the Expert-Assist Interface, perform the following steps:
1. From the Commands main screen, click the D NET,APING hyperlink under Route Diagnostic Commands. The APING Command screen displays:
Figure 158. APING Command screen
2. From the APING menu, select either APING – Use Defaults or APING – Change Parameters.
3. Enter the CP or Resource Name. This is a required field.
4. Do one of the following:
The D NET,APING Command Results screen displays:
Figure 159. D NET,APING Results screen
5. Do one of the following:
· To enter another D NET,APING command, click the Back button on the browser.
· To return to the main menu for Commands, click the Commands navigation tab.
· To return to the SysPoint Home Page, click SysPoint on the main menu bar.
See also: