HP-UX SNAplus2 R7 Administration Command Reference

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 speciﬁed length.) Specify a value in the range 0–65,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 speciﬁed by the dlen parameter.

The APING TP then requests either data or a conﬁrmation message from the partner TP, depending on the

setting of the echo parameter. Specify a value in the range 1–65,535.

fqplu_name

Fully qualiﬁed 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 speciﬁed; it is ignored if plu_alias is speciﬁed.

echo

Speciﬁes whether the APING TP receives data or requests conﬁrmation from the partner LU after sending

data to it. Possible values are:

YES

After sending the speciﬁed number of data strings, the APING TP receives data from the partner LU.

After sending the speciﬁed number of data strings, the APING TP requests conﬁrmation 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 conﬁrmation. Specify a value in the range 0–65,535.

partner_ver_len

Maximum length of the partner TP veriﬁcation data string to return. Specify a value in the range 0–3000.

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