Name

snalu62_display_mode − Displays the parameters for the specified mode name. 
 
 
 

FORMAT

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
     );
 
 
 
 

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 to display.
 

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, which is the number of sessions for which the local LU is responsible to 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 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 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.
 

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

 
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_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