Name

snalu62_change_session_limit − Changes the LU/mode session limit and contention-winner polarities for parallel-session connections.  This verb does not terminate active conversations. 
 
 
 

FORMAT

STATUS_RTN snalu62_change_session_limit(
     STATUS_VEC status_vec,
     char ∗local_lu_name,
     char ∗remote_lu_name,
     char ∗mode_name,
     UINT32 lu_mode_session_limit,
     UINT32 min_conwinners_source,
     UINT32 min_conwinners_target,
     UINT32 responsible,
     SRV_INFO ∗server_info
     );
 
 
 
 

Arguments

status_vec
 
A pointer to a STATUS_VEC array to receive the completion status information. 
 
 

local_lu_name
 
A pointer to a null-terminated ASCII string specifying either the fully-qualified network name or the locally-known alias of the local LU.
 
 

min_conwinners_source
 
A UINT32 value specifying the new minimum number of sessions for which the source LU is the contention winner. 
 
 

min_conwinners_target
 
A UINT32 value specifying the new minimum number of sessions for which the remote (target) LU is the contention winner. 
 
 

responsible
 
A UINT32 value specifying which LU is responsible for selecting and deactivating sessions if this call results in a change that decreases the session limit or the maximum number of contention-winner sessions for the source or target.  If no sessions need to be deactivated, this parameter is ignored.  Specify one of the following values:
 

•SNALU62_C_SOURCE (the default)

Specifies that the source LU is responsible. 

•SNALU62_C_TARGET

Specifies that the remote (target) LU is responsible.  The target LU can negotiate with the source LU and request that the source LU be the responsible party. 
 

The responsible LU deactivates the sessions after current conversations complete and after all queued conversations complete.  The LU cannot deactivate a session with an active conversation or one with any queued conversations. 

server_info
 
A pointer to a SRV_INFO structure specifying the LU6.2 Server to utilize.  Supply sufficient information to uniquely identify the LU6.2 Server.  If this parameter is not specified, the interface attempts to connect to a local server with the name LU62_SRV. 
 
 
 

Description

 
This verb applies to the group of sessions using the specified mode name between the source LU and the specified remote (target) LU. The new remote LU/mode session limit and contention-winner polarities are enforced until changed by subsequent CNOS processing. As a consequence of changing the LU/mode session limit and contention-winner polarities, LU-LU sessions with the specified mode name may be activated or deactivated to conform to the new session limit and polarities.

 
All of the parallel sessions between two LUs can be partitioned into groups, with all sessions in a group having the same mode name. Use this verb to change the maximum number of active sessions that can exist concurrently within a mode name group between the source LU and target LU. The limits imposed on the number of active parallel sessions within a mode name group are:
 

•The number of active sessions cannot exceed the LU/mode session limit. 

•The number of active contention-winner sessions for the source LU cannot exceed the LU/mode session limit minus the minimum number of contention-winner sessions for the target LU. 

•The number of active contention-winner sessions for the target LU cannot exceed the LU/mode session limit minus the minimum number of contention-winner sessions for the source LU. 
 

 
As a result of calling this verb, sessions may be activated, deactivated, or both to conform to the new limits. When a remote LU (like CICS) fails, its underlying communication system automatically deactivates the remote LU’s sessions. When the communication system restarts the remote LU, it sets all the LU’s mode session limits to zero. If you attempt to establish a conversation to a remote transaction program using the remote LU, the session activation request will fail because the mode session limits are not initialized. You should use one or more of the CNOS verbs described in this chapter to negotiate new session limits.

Restrictions

 
Only a process having superuser privileges or a user listed in the system group in the /etc/group file can call this verb. 

 
If you are using this verb to manage an LU6.2 Server on a remote node, the remote server must have access to an access validation file that includes your node name.
 

Return Values

SNALU62_S_OK_ASNEG
normal successful completion was negotiated

SNALU62_S_OK_ASSPEC
normal successful completion as specified

SNALU62_S_ALLERR
conversation could not be allocated

SNALU62_S_EXCMAX
request exceeds maximum allowed

SNALU62_S_MSLIMZ
LU-mode session limit zero

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_RACEREJ
command race reject

SNALU62_S_RESFNO
resource failure no retry

SNALU62_S_SESLIM
LU session limit exceeded

SNALU62_S_UNKMODE
unrecognized mode name

SNALU62_S_UNSUC
verb did not execute successfully