Name

snalu62_define_mode − Defines or changes parameters that control the operation of the local LU in conjunction with a group of sessions to the specified remote LU, the session group being identified by a mode name. 
 
 
 

FORMAT

STATUS_RTN snalu62_define_mode(
     STATUS_VEC status_vec,
     char ∗local_lu_name,
     char ∗remote_lu_name,
     char ∗mode_name,
     UINT32 send_max_ru_size_lower_bound,
     UINT32 send_max_ru_size_upper_bound,
     UINT32 recv_max_ru_size_lower_bound,
     UINT32 recv_max_ru_size_upper_bound,
     UINT32 single_session_reinitiation,
     UINT32 session_level_cryptography,
     UINT32 length_checked_compression,
     UINT32 inbound_compression_level,
     UINT32 outbound_compression_level,
     UINT8 rle_before_lz,
     UINT32 conwinner_auto_activate_limit,
     UINT32 preferred_recv_ru_size,
     UINT32 preferred_send_ru_size,
     char ∗session_deactivation_tp_name,
     UINT32 local_max_session_limit,
     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.
 
 

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

mode_name
 
A pointer to a null-terminated ASCII string specifying the mode name being defined. If the mode name is already defined, this verb changes the other parameter values. Do not specify any of the following SNA-architected mode names:
 

•default (see Note)

•#BATCH

•#INTER

•#BATCHSC

•#INTERSC

•CPSVCMG

•SNASVCMG
 
 
The default name is encoded as eight space (X’20’) characters.

send_max_ru_size_lower_bound
 
A UINT32 value specifying the lower bound for the maximum size of normal-flow requests that the local LU sends on its sessions.  Specify a value less than or equal to the value specified on the send_max_ru_size_upper_bound parameter. The local LU uses these lower- and upper-bound values to determine the value for its send maximum RU size specified in its BIND requests and responses. 
 
 

send_max_ru_size_upper_bound
 
A UINT32 value specifying the upper bound for the maximum size of normal-flow requests that the local LU sends on its sessions.  Specify a value greater than or equal to the value specified on the send_max_ru_size_lower_bound parameter. The local LU uses these lower- and upper-bound values to determine the value for its send maximum RU size specified in its BIND requests and responses. 
 
 

recv_max_ru_size_lower_bound
 
A UINT32 value specifying the lower bound for the maximum size of normal-flow requests that the local LU receives on its sessions.  Specify a value less than or equal to the value specified on the recv_max_ru_size_upper_bound parameter. The local LU uses these lower- and upper-bound values to determine the value for its receive maximum RU size specified in its BIND requests and responses. 
 
 

recv_max_ru_size_upper_bound
 
A UINT32 value specifying the upper bound for the maximum size of normal-flow requests that the local LU receives on its sessions.  Specify a value greater than or equal to the value specified on the recv_max_ru_size_lower_bound parameter. The local LU uses these lower- and upper-bound values to determine the value for its receive maximum RU size specified in its BIND requests and responses. 
 
 

single_session_reinitiation
 
A UINT32 value specifying the responsibility for session reinitiation of a single session with the remote LU.  The local LU uses this parameter to determine the indication for session reinitiation that it specifies in its BIND requests and responses. The remote LU must be defined to not support parallel sessions. Specify one of the following values:
 

•SNALU62_C_UNDEFINED

Use this value when the remote LU supports parallel sessions. 

•SNALU62_C_OPERATOR

For single-session LUs, specifies that neither LU should automatically attempt to reinitiate the session in the case of a session failure.  Both sides require operator intervention. 

•SNALU62_C_PLU

For single-session LUs, specifies that the primary LU (PLU) should automatically attempt to reinitiate the session in the case of a failure. 

•SNALU62_C_SLU

For single-session LUs, specifies that the secondary LU (SLU) should automatically attempt to reinitiate the session in the case of a failure. 

•SNALU62_C_PLU_OR_SLU

For single-session LUs, specifies that either the PLU or the SLU should automatically attempt to reinitiate the session in the case of a failure. 
 
 

session_level_cryptography
 
This parameter is a place holder. The functionality represented by this parameter is not implemented.
 
 

length_checked_compression
 
This parameter is a place holder. The functionality represented by this parameter is not implemented.
 

inbound_compression_level
 
This parameter is a place holder. The functionality represented by this parameter is not implemented.
 

outbound_compression_level
 
This parameter is a place holder. The functionality represented by this parameter is not implemented.
 

rle_before_lz
 
This parameter is a place holder. The functionality represented by this parameter is not implemented.
 

conwinner_auto_activate_limit
 
A UINT32 value specifying the limit for the number of contention-winner sessions that the local LU can automatically activate when the minimum number of contention-winner sessions for the local LU increases (as a result of CNOS processing).  A value of zero specifies that the local LU is to automatically activate no sessions. 
 

preferred_recv_ru_size
 
A UINT32 value specifying the preferred maximum size of normal-flow requests that the local LU receives on its sessions.  This value must be less than or equal to the value specified on the recv_max_ru_size_upper_bound parameter and greater than or equal to the recv_max_ru_size_lower_bound parameter. 
 
 

preferred_send_ru_size
 
A UINT32 value specifying the preferred maximum size of normal-flow requests that the local LU sends on its sessions.  This value must be less than or equal to the value specified on the send_max_ru_size_upper_bound parameter and greater than or equal to the send_max_ru_size_lower_bound parameter. 
 
 

session_deactivation_tp_name
 
This parameter is a place holder. The functionality represented by this parameter is not implemented.
 

local_max_session_limit
 
A UINT32 value specifying the session limit that the local LU can use during CNOS processing for the session limit.  A value of zero, indicates that no session limit can be negotiated, either by a remote CNOS request or by local execution of a CNOS verb.  If this parameter contains a non-zero value, the lu_session_limit parameter of the local LU must be large enough to include this value. The lu_session_limit must be greater than or equal to the sum of the local_max_session_limit parameter values for all mode names that reference the local LU (including the SNA-defined mode names). 
 
 

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

 
If this function is called to modify an existing mode name definition, the current value of the local_max_session_limit parameter and the active session count (as returned by the lu_mode_session_count parameter of the snalu62_display_mode verb) must be 0; otherwise, only the conwinner_auto_activate parameter is modified. 

 
If no automatic-activation limit for contention-winner sessions is defined for the mode name, the local LU does not automatically activate any sessions.
 

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.

 
Once you define a mode, you can only change a mode’s contention winner auto-activate limit.
 

Return Values

SNALU62_S_OK
normal successful completion

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_UNSUC
verb did not execute successfully