HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_RTP_TUNING
3.41.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.42 DEFINE_RTP_TUNING
DEFINE_RTP_TUNING specifies parameters to be used when setting up RTP connections. After you issue this
verb, the parameters you specify will be used for all future RTP connections until you modify them by issuing a
new DEFINE_RTP_TUNING verb.
3.42.1 VCB Structure
typedef struct define_rtp_tuning
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char path_switch_attempts; /* number of path switch attempts */
unsigned char short_req_retry_limit; /* short request timer retry limit */
AP_UINT16 path_switch_times[4]; /* path switch times */
unsigned char reserved[90]; /* reserved */
} DEFINE_RTP_TUNING;
3.42.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_RTP_TUNING
path_switch_attempts
Number of path switch attempts to set on new RTP connections. Specify a value in the range 1–255. If you
specify 0(zero), SNAplus2 uses the default value of 6.
short_req_retry_limit
Number of times a Status Request is sent before SNAplus2 determines that an RTP connection is disconnected
and starts Path Switch processing. Specify a value in the range 1–255. If you specify 0(zero), SNAplus2
uses the default value of 6.
path_switch_times
Length of time in seconds for which SNAplus2 attempts to path switch a disconnected RTP connection.
This parameter is specified as four separate time limits for each of the valid transmission priorities in order:
AP_LOW, AP_MEDIUM, AP_HIGH, and AP_NETWORK. Each of these must be in the range 1–65535. The
value you specify for each transmission priority must not exceed the value for any lower transmission priority.
If you specify 0(zero) for any of these values, SNAplus2 uses the corresponding default value as follows:
• 480 seconds (8 minutes) for AP_LOW
• 240 seconds (4 minutes) for AP_MEDIUM
251