HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
CHANGE_SESSION_LIMIT
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 automatically activate after the session limit is changed. 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 DEFINE_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.
When sessions are deactivated normally (specifying AP_DEACT_NORMAL) below this limit, new sessions are
activated up to this limit.
responsible
Indicates whether the local or partner LU is responsible for deactivating sessions after the session limit is
changed. Possible values are:
AP_SOURCE
The local LU is responsible.
AP_TARGET
The partner LU is responsible.
3.5.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 changed, but one or more values were negotiated by the partner LU.
AP_AS_SPECIFIED
The session limits were changed as requested, without being negotiated by the partner LU.
3.5.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
Possible values are:
AP_EXCEEDS_MAX_ALLOWED
The plu_mode_session_limit, min_conwinners_source, min_conwinners_target,orauto_act parameter
was set to a value outside the valid range.
AP_CANT_CHANGE_TO_ZERO
The plu_mode_session_limit parameter cannot be set to zero using this verb; use RE-
SET_SESSION_LIMIT instead.
95