HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_MODE
AP_DEFINE_MODE
mode_name
Name of the mode. This is an 8-byte type-A EBCDIC string, padded on the right with EBCDIC spaces if the
name is shorter than 8 bytes.The name must start with a letter, or can start with # for one of the SNA-defined
modes such as #INTER. For information about SNA-defined modes, see the
HP-UX SNAplus2 Administration
Guide.
To specify the default COS that will be used for any unrecognized mode names, set this parameter to 8
binary zeros. In this case, the mode_chars.cos_name parameter is taken as the default COS name; all other
parameters supplied on this verb are ignored.
mode_chars.description
A null-terminated text string (0–31 characters followed by a null character) describing the mode.
This string is for information only; it is stored in the node’s configuration file and returned on the
QUERY_MODE_DEFINITION and QUERY_MODE verbs, but SNAplus2 does not make any other use of it.
mode_chars.max_ru_size_upp
Upper bound for the maximum size of RUs sent and received on sessions in this mode. The value is used
when the maximum RU size is negotiated during session activation.
Range: 256–61,440. If the default_ru_size parameter (see below) is set to AP_YES, this parameter is
ignored (and the value is not checked).
mode_chars.receive_pacing_win
Session pacing window for sessions using this mode; the range is 1–63. This value is used only for fixed
pacing (not for adaptive pacing), and specifies the maximum number of frames that can be received from
the partner LU before the local LU must send a response. SNAplus2 always uses adaptive pacing unless the
adjacent node specifies that it is not supported.
mode_chars.default_ru_size
Specifies whether a default upper bound for the maximum RU size will be used. Possible values are:
AP_YES
SNAplus2 ignores the max_ru_size_upp parameter, and sets the upper bound for the maximum RU size
to the largest value that can be accommodated in the link BTU size.
AP_NO
SNAplus2 uses the max_ru_size_upp parameter to define the maximum RU size.
mode_chars.max_neg_sess_lim
Maximum number of sessions allowed on this mode between any local LU and partner LU. This
value may be lowered for a particular LU-LU-mode combination when issuing initialize_session_limit or
change_session_limit.
Range: 1–32,767. Zero indicates that SNAplus2 should not initiate implicit CNOS exchange when an
application attempts to start a session using this mode; session limits must be specified explicitly using
initialize_session_limit.
mode_chars.plu_mode_session_limit
Default session limit for this mode. This limits the number of sessions on this mode between any one local
LU and partner LU pair. This value is used when CNOS (Change Number of Sessions) exchange is initiated
implicitly.
Specify a value in the range 1–32,767 (which must not exceed the value in max_neg_sess_lim). Zero
indicates that SNAplus2 should not initiate implicit CNOS exchange when an application attempts to start a
session using this mode; session limits must be specified explicitly using initialize_session_limit.
212