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. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

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

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 this mode name is associated. 
 
 

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

mode_name

A pointer to a 1- to 8-character 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.  If a race condition occurs, the transaction program whose fully-qualified local LU name has the highest hexadecimal value completes the reinitiation. 
 

•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.  If a race condition occurs, the transaction program whose fully-qualified local LU name has the highest hexadecimal value completes the reinitiation. 
 
 
 
 

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 0 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 this mode’s session limit.  A value of 0 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
 
 
 
 
 

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

 
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. 

Note that the LU6.2 protocol enforces a limited set of RU sizes. The interface rounds down all supplied RU size values to the next lowest allowable RU size. 
 
 

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

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

RETURN VALUES

SNALU62_S_OKnormal successful completion

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_UNSUC
verb did not execute successfully
 
 
 

ERRORS

 
None

RELATED INFORMATION

 
Functions: snalu62_display_mode

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.