Administration Commands

aping

User ID required to access the partner TP. This parameter is required only if the security parameter is set to SAME, PGM or PGM_STRONG. This ID is a type-AE character string.

dlen

Length of the data string to be sent to the partner LU. (You do not need to provide a data string; the APING TP simply sends a string of zeros of the specified length.) Specify a value in the range 065,535.

consec

Number of consecutive data strings sent to the partner LU before a response is required. The APING TP sends this number of data strings, with each string containing the number of bytes specified by the dlen parameter. The APING TP then requests either data or a confirmation message from the partner TP, depending on the setting of the echo parameter. Specify a value in the range 165,535.

fqplu_name

Fully qualified name of the partner LU. Specify 3–17 type-A characters that consist of a 1–8 character network name, followed by a period, followed by a 1–8 character partner LU name.

This name should be the name of an LU on a remote node; using aping with a partner LU on the local node is not recommended.

This parameter is used only if the plu_alias parameter is not specified; it is ignored if plu_alias is specified.

echo

Specifies whether the APING TP receives data or requests confirmation from the partner LU after sending data to it. Possible values are:

YES

After sending the specified number of data strings, the APING TP receives data from the partner LU.

NO

After sending the specified number of data strings, the APING TP requests confirmation from the partner LU, but does not receive data.

iterations

Number of times that the APING TP performs the sequence of sending data to the partner LU and requesting either data or confirmation. Specify a value in the range 065,535.

partner_ver_len

Maximum length of the partner TP verification data string to return. Specify a value in the range 03000.

2.4.2 Returned Parameters

Parameter name

Type

Length

alloc_time

decimal

 

min_time

decimal

 

avg_time

decimal

 

max_time

decimal

 

partner_ver_len

decimal

 

partner_ver_data

hex array

(max_length as specified on command)

If the command executes successfully, SNAplus2 returns the following parameters:

alloc_time

The time in milliseconds to allocate a conversation to the partner—the time taken for the MC_ALLOCATE verb issued by the APING TP to complete.

min_time

46

Page 46
Image 46
HP UX Internet and Networking Software manual Dlen, Consec, Echo, Iterations, Partnerverlen, Alloctime, Mintime