NAME

snalu62_display_mode − Displays the parameters for the specified mode name. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_display_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 ∗local_max_session_limit,
       UINT32 ∗lu_mode_session_limit,
       UINT32 ∗min_conwinners,
       UINT32 ∗min_conlosers,
       UINT32 ∗termination_count,
       UINT32 ∗drain_local_lu,
       UINT32 ∗drain_remote_lu,
       UINT32 ∗lu_mode_session_count,
       UINT32 ∗conwinners_session_count,
       UINT32 ∗conlosers_session_count,
       SES_LIST ∗session_ids,
       CONV_GROUP_LIST ∗conversation_group_ids,
       UINT32 ∗preferred_recv_ru_size,
       UINT32 ∗preferred_send_ru_size,
       char ∗session_deactivation_tp_name,
       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. 
 
 

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

mode_name

A pointer to a null-terminated ASCII string specifying the mode name to display. 
 

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 PARAMETERS

 
 

status_vec

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

send_max_ru_size_lower_bound

A pointer to a UINT32 location to receive a value indicating the lower bound for the maximum size of normal-flow requests that the local LU sends on its sessions. 
 
 

send_max_ru_size_upper_bound

A pointer to a UINT32 location to receive a value indicating the upper bound for the maximum size of normal-flow requests that the local LU sends on its sessions. 
 
 

recv_max_ru_size_lower_bound

A pointer to a UINT32 location to receive a value indicating the lower bound for the maximum size of normal-flow requests that the local LU receives on its sessions. 
 
 

recv_max_ru_size_upper_bound

A pointer to a UINT32 location to receive a value indicating the upper bound for the maximum size of normal-flow requests that the local LU receives on its sessions. 
 
 

single_session_reinitiation

A pointer to a UINT32 location to receive the value indicating the responsibility for session reinitiation of a single session with the remote LU.  If a session is active between the remote and local LU, this parameter returns an indication of the actual session reinitiation responsibility; otherwise it returns an indication of the responsibility currently defined at the local LU. It can have one of the following values:
 
 
 
 

•SNALU62_C_UNDEFINED

Indicates that the remote LU supports parallel sessions. 
 

•SNALU62_C_OPERATOR

For single-session LUs, indicates 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, indicates 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, indicates 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, indicates 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 pointer to a UINT32 location to receive a value indicating the limit on 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). 
 
 

local_max_session_limit

A pointer to a UINT32 location to receive a value indicating the LU-LU session limit that the local LU uses during CNOS processing for the session limit. 
 
 

lu_mode_session_limit

A pointer to a UINT32 location to receive a value indicating the current LU/mode session limit for this mode. 
 
 

min_conwinners

A pointer to a UINT32 location to receive a value indicating the current minimum number of sessions for which the local LU should be the contention winner. 
 
 

min_conlosers

A pointer to a UINT32 location to receive a value indicating the current minimum number of sessions for which the local LU should be the contention loser. 
 
 

termination_count

A pointer to a UINT32 location to receive a value indicating the termination count. The termination count is the number of sessions that the local LU can deactivate as a result of CNOS processing. 
 
 

drain_local_lu

A pointer to a UINT32 location to receive a value indicating whether the local LU is allowed to drain (discard) its allocation requests as a result of CNOS processing that resets the LU/mode session limit. 
 
 

drain_remote_lu

A pointer to a UINT32 location to receive a value indicating whether the remote LU is allowed to drain (discard) its allocation requests as a result of CNOS processing that resets the LU/mode session limit. 
 
 

lu_mode_session_count

A pointer to a UINT32 location to receive a value indicating the current LU/mode session count. 
 
 

conwinners_session_count

A pointer to a UINT32 location to receive a value indicating the number of active sessions for which the local LU is the contention winner. 
 
 

conlosers_session_count

A pointer to a UINT32 location to receive a value indicating the number of active sessions for which the local LU is the contention loser. 
 
 

session_ids

A pointer to a SES_LIST structure to receive the session identifiers assigned to the active sessions. 
 

The interface allocates the memory referenced by the SES_LIST structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

 
 

conversation_group_ids

A pointer to a CONV_GROUP_LIST structure to receive the conversation group identifiers associated with the active sessions. 
 

The interface allocates the memory referenced by the CONV_GROUP_LIST structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

 
 

preferred_recv_ru_size

A pointer to a UINT32 location to receive a value indicating the preferred maximum size of normal-flow requests that the local LU receives on its sessions. 
 
 

preferred_send_ru_size

A pointer to a UINT32 location to receive a value indicating the preferred maximum size of normal-flow requests that the local LU sends on its sessions. 
 
 

session_deactivation_tp_name

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

 

DESCRIPTION

 
Use this verb to retrieve the current values of parameters that control the operation of the local LU in conjunction with a group of sessions to a remote LU, the session group being identified by a mode name.

This verb returns operating parameters that the snalu62_define_mode verb and the CNOS verbs establish. 
 
 

RESTRICTIONS

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

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