HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
INITIALIZE_SESSION_LIMIT
set_negotiable
Specifies whether the maximum negotiable session limit for this mode, as defined by DEFINE_MODE, should
be modified. Possible values are:
AP_YES
Use the value specified by plu_mode_session_limit as the maximum negotiable session limit for this
LU-LU-mode combination.
AP_NO
Leave the maximum negotiable session limit as the value specified for the mode.
plu_mode_session_limit
Requested total session limit for this LU-LU-mode combination: the maximum number of parallel sessions
permitted between these two LUs using this mode. Specify a value in the range
1–32,767 (which must not
exceed the session limit specified for the local LU on the DEFINE_LOCAL_LU verb). This value may be
negotiated with the partner LU.
min_conwinners_source
Minimum number of sessions using this mode for which the local LU is the contention winner. Specify a value
in the range 0–32,767. The sum of the min_conwinners_source and min_conwinners_target parameters must
not exceed the plu_mode_session_limit parameter.
min_conwinners_target
Minimum number of sessions using this mode for which the partner LU is the contention winner. Specify a
value in the range 0–32,767. The sum of the min_conwinners_source and min_conwinners_target parameters
must not exceed the plu_mode_session_limit parameter.
auto_act
Number of sessions to activate automatically. Specify a value in the range 0–32,767 (which must not
exceed the plu_mode_session_limit parameter or the session limit specified for the local LU on the DE-
FINE_LOCAL_LU verb). The actual number of automatically activated sessions is the minimum of this
value and the negotiated minimum number of contention winner sessions for the local LU.
3.84.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
secondary_rc
Possible values are:
AP_AS_NEGOTIATED
The session limits were initialized, but one or more values were negotiated by the partner LU.
AP_AS_SPECIFIED
The session limits were initialized as requested, without being negotiated by the partner LU.
3.84.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
324