HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs

APING

primary_rc

AP_OK

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

The minimum time in milliseconds required for a data-sending iteration (the shortest measured time for a

single iteration of sending data and receiving either data or conﬁrmation). If iterations was set to zero, this

parameter is not used.

avg_time

The average time in milliseconds required for a data-sending iteration (the average time for a single iteration

of sending data and receiving either data or conﬁrmation). If iterations was set to zero, this parameter is not

used.

max_time

The maximum time in milliseconds required for a data-sending iteration (the longest measured time for a

single iteration of sending data and receiving either data or conﬁrmation). If iterations was set to zero, this

parameter is not used.

partner_ver_len

Length of veriﬁcation string returned by the partner TP.

In addition to these returned parameters, the veriﬁcation string returned by the partner TP is appended to the end of

the APING VCB. The length of this string is given by

partner_ver_len.Ifpartner_ver_len is zero, then this string

is not returned.

3.4.4 Returned Parameters: Parameter Check

If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:

primary_rc

AP_PARAMETER_CHECK

secondary_rc

Possible values are:

AP_INVALID_LU_ALIAS

The lu_alias parameter did not match any deﬁned LU alias.

AP_INVALID_LU_NAME

The lu_name parameter did not match any deﬁned LU name.

AP_BAD_SECURITY

The security parameter was not set to a valid value.

AP_UNKNOWN_PARTNER_MODE

The value speciﬁed for plu_alias, fqplu_name,ormode_name did not match any deﬁned partner LU or

mode.

AP_BAD_PARTNER_LU_ALIAS

The value speciﬁed for plu_alias did not match any deﬁned partner LU.

Appendix B, Common Return Codes lists further secondary return codes associated with

AP_PARAMETER_CHECK,

which are common to all NOF verbs.