HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_MODE
If you specify an explicit limit, the LU session limit for any LU that uses this mode must be greater than or
equal to the sum of the session limits for all modes that the LU will use.
mode_chars.min_conwin_src
Minimum number of contention winner sessions that a local LU using this mode can activate. This value
is used when CNOS (Change Number of Sessions) exchange is initiated either by the remote system or
implicitly by SNAplus2. Specify a value in the range
0–32,767. The sum of the min_conwin_src and
min_conloser_src parameters must not exceed plu_mode_session_limit.
mode_chars.cos_name
Name of the class of service to request when activating sessions on this mode.
If the node supports mode to COS mapping (as defined by the mode_to_cos_map_supp parameter on
DEFINE_NODE), the COS specified by this field must be either an SNA defined COS or a COS previously
defined by issuing a DEFINE_COS verb. Otherwise, this parameter is ignored.
The name is an 8-byte type-A character string, padded on the right with spaces if the name is shorter than 8
characters.
mode_chars.auto_act
Number of sessions that will be activated automatically for this mode. This value is used when CNOS
(Change Number of Sessions) exchange is initiated implicitly. Specify a value in the range 0–32,767.
mode_chars.min_conloser_src
Minimum number of contention loser sessions that can be activated by any one local LU that uses this mode.
This value is used when CNOS (Change Number of Sessions) exchange is initiated implicitly. Specify a value
in the range 0–32,767. The sum of the min_conwin_src and min_conloser_src parameters must not exceed
plu_mode_session_limit.
mode_chars.max_ru_size_low
Lower bound for the maximum size of RUs sent and received on sessions that use this mode. Specify a value
in the range 256–61,440. The value 0 means that there is no lower bound.
The value is used when the maximum RU size is negotiated during session activation. This parameter is ig-
nored if the default_ru_size parameter is set to AP_YES.
mode_chars.max_receive_pacing_win
Maximum session pacing window for sessions in this mode. For adaptive pacing, this value is used to limit
the receive pacing window that the session will grant. For fixed pacing, this parameter is not used. (SNAplus2
always uses adaptive pacing unless the adjacent node specifies that it does not support it.)
Specify a value in the range 0–32,767. The value zero means that there is no upper bound.
3.36.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
3.36.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
213