HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_LS
Link-specific data for Enterprise Extender (HPR/IP):
ipdlc_link_spec_data.mux_info.dlc_type
Type of DLC. Set this to AP_IP.
ipdlc_link_spec_data.ack_timeout
Duration for the acknowledgment timer (sometimes called the T1 timer): the time in milliseconds within
which a response must be received for a command frame sent to the adjacent link station. If the response is
not received within this time, a duplicate frame is sent.
A lower value for this parameter means that lost packets will be detected quickly, but may increase network
traffic.
Specify a value in the range 0–65535. This parameter should be set to a value greater than twice the expected
network latency. A typical value is 2000 milliseconds.
ipdlc_link_spec_data.max_retry
The maximum number of times that the local station will retry sending a command frame. If this retry count
is exceeded without receiving a response, the link is considered to have failed.
A lower value for this parameter means that link failures will be detected quickly, but may cause unnecessary
reporting of link failures if a few packets are lost.
Specify a value in the range 0–255. A typical value is 10 retries.
ipdlc_link_spec_data.liveness_timeout
Duration for the liveness timer (sometimes called the TL timer): the time in milliseconds for which the link
will be held active if there is no evidence that the remote station is still active.
A lower value for this parameter means that link failures will be detected quickly, but may increase network
traffic on idle active links.
Specify a value in the range 1–65535 milliseconds. A typical value is 10000 (10 seconds).
ipdlc_link_spec_data.short_hold_mode
Specifies whether the liveness protocol runs only if there has been no evidence that the remote system is still
active since data was last transmitted (AP_YES or AP_NO).
Setting this parameter to AP_YES allows links to stay active and idle without unnecessary data traffic, but
means that link failures are not detected until the local station attempts to send data. In general this parameter
should be set to AP_NO.
ipdlc_link_spec_data.remote_hostname
Remote host name of the destination node for this link. This can be specified as a dotted-decimal IP address
(such as 193.1.11.100), as a name (such as newbox.this.co.uk), or as an alias (such as newbox).
If you specify a name or alias, the HP-UX system must be able to resolve this to a fully qualified name (either
using the local TCP/IP configuration or using a Domain Name server).
3.29.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
3.29.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
189