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. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
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
       );
 
 
 
 

SUPPLIED PARAMETERS

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 with which the mode name is associated. 
 
 

min_conwinners_source

A UINT32 value specifying the new minimum number of sessions for which the source LU is the contention winner.  The sum of the value you specify for this parameter and the value you specify for the min_conwinners_target parameter cannot exceed the value you specify for the lu_mode_session_limit parameter. 
 
 

min_conwinners_target

A UINT32 value specifying the new minimum number of sessions for which the remote (target) LU is the contention winner.  The sum of the value you specify for this parameter and the value you specify for the min_conwinners_source parameter cannot exceed the value you specify for the lu_mode_session_limit parameter. 
 
 

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 use.  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. 
 
 

RETURNED PARAMETER

status_vec

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

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 LU6.2 Server access validation file that includes your node name.  includes your node name. 
 
 
For a description of the LU6.2 Server access validation file, see the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Administrator’s Guide. 
 
 

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
 
 
 

ERRORS

 
None

RELATED INFORMATION

 
Functions: snalu62_initialize_sess_limit and snalu62_reset_session_limit

Manuals: Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Programming and IBM’s Systems Network Architecture Transaction Programmer’s Reference Manual for LU Type 6.2.