HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_LS
If your X.25 network or the remote system requires any other facilities data in addition to the above parameters,
specify it using this parameter. Check with the administrator of your X.25 network, or the administrator of
the remote system, to determine what to specify in this parameter.
If the X.25 network does not support facilities negotiation, or if you do not want to use it, ensure that the
X.25 provider software is configured not to allow flow control negotiation. In this case, the parameters
req_rev_charge–rem_wsize above must all be set to use the network’s default values, and fac_len must be set
to zero.
retry_limit
Number of times to retry sending a QXID, QSM, or QDISC message if no response is received within the
time specified by retry_timeout below.
Range is
1–255.Ifvc_type above is set to VQL_PVC, this parameter is ignored for QXID messages; XID
sending is retried indefinitely (so that an initially active LS can wait indefinitely for the remote station to
become active).
retry_timeout
Timeout in seconds for QXID, QSM, or QDISC messages. A message will be retried (up to the number of
times specified by retry_limit above) if no response is received within this time. Range is 1–255.
idle_timeout
Timeout in seconds used to detect a completely idle line. This value is used during connect processing for
SVCs when the local station is secondary and waiting for XIDs. If no message is received in this time,
SNAplus2 assumes that the remote station has failed.
Range is 1–255. This field is ignored if vc_type above is set to VQL_PVC.
pvc_id
PVC identifier. Set this to a decimal number to identify which PVC (from the range of PVCs defined for your
X.25 provider software) is to be used for this LS. This field is reserved if vc_type above is set to VQL_SVC.
sn_id_len
Length of the subnet identifier that follows (in the sn_id parameter). Set this parameter to 1 for a single-port
card, or 3 for a multi-port card, to match the length of the sn_id parameter as described below.
sn_id
Subnet identifier: this parameter identifies the physical connection to the X.25 network.
Set it to a character string that matches the final character(s) of the X.25 driver name, as follows:
• If you have more than one X.25 adapter card installed in the HP-UX computer, set the first byte of this
parameter to the ASCII character 0 (zero) to use the first card, the ASCII character 1 (one) to use the
second, and so on.
• If you have only one X.25 adapter card, set the first byte of this parameter to the ASCII character 0 (zero)
.
• If the card is a multi-port card, set the second byte to the ASCII character p, and the third byte to the
ASCII character 1 (one) to indicate the first port on the card, the ASCII character 2 to indicate the second,
and so on. For example, 0p2 indicates the second port on the first (multi-port) card.
The parameter must be set to the ASCII character value 0 or 1, not to the numeric value zero or one.
cud_len
Length of the Call User Data that follows (in the cud parameter).
cud
Call User Data: this parameter identifies the protocol to be used over the underlying X.25 virtual circuit,
and is used only if the vc_type parameter is set to VQL_SVC. For most implementations, this should be
187