Name

snalu62_display_local_lu − Displays a local LU’s parameters. 
 
 
 

FORMAT

STATUS_RTN snalu62_display_local_lu(
     STATUS_VEC status_vec,
     char ∗fully_qualified_lu_name,
     char ∗local_lu_alias,
     UINT32 ∗lu_session_limit,
     UINT32 ∗lu_session_count,
     SECUR_LIST ∗security,
     MAP_INFO ∗map_name,
     STRING_LIST ∗remote_lu_names,
     TP_LIST ∗tpns,
     UINT32 ∗bind_rsp_queue_capability,
     UINT32 ∗length_checked_compression,
     UINT32 ∗inbound_compression_level,
     UINT32 ∗outbound_compression_level,
     UINT8 ∗rle_before_lz,
     UINT8 ∗session_activation,
     UINT32 ∗max_sync_level,
     GWY_INFO ∗gateway,
     SRV_INFO ∗server_info
     );
 
 
 
 

Arguments

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

fully_qualified_lu_name
 
A pointer to a null-terminated ASCII string specifying the fully-qualified network name of the local LU to be displayed.
 
 

local_lu_alias
 
A pointer to a 65-byte null-terminated ASCII string to receive the locally-known alias of the local LU.
 
 

lu_session_limit
 
A pointer to a UINT32 location to receive the value indicating the limit for the total number of concurrent LU-LU sessions for the local LU.  A value of zero indicates that no limit is defined. 
 
 

lu_session_count
 
A pointer to a UINT32 location to receive the value indicating the active LU-LU session count for the local LU. 
 
 

security
 
A pointer to a SECUR_LIST structure to receive the conversation-level security verification information defined at the local LU. 
 
The interface allocates the memory referenced by the SECUR_LIST structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

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

remote_lu_names
 
A pointer to a STRING_LIST structure to receive the remote LU names currently defined at the local LU. 
 
The interface allocates the memory referenced by the STRING_LIST structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

tpns
 
A pointer to a TP_LIST structure to receive the transaction program names currently defined for this local LU. 
 
The interface allocates the memory referenced by the TP_LIST structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

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

session_activation
 
A pointer to a UINT8 location to receive a boolean value indicating whether LU-LU session activations (including CNOS sessions) before an snalu62_attach_listen verb is called should be prevented.  A value of TRUE (1)
 indicates that LU-LU activation should be prevented when an snalu62_attach_listen verb has not been called. 
 
 

max_sync_level
 
A pointer to a UINT32 location to receive a value indicating the maximum synchronization level allowed for all conversations using this local LU.  It can have one of the following values:
 

•SNALU62_C_SL_NONE

Indicates that conversations using this LU cannot use any confirmation verbs or sync-point processing. 

•SNALU62_C_SL_CONFIRM

Indicates that conversations using this LU have the option of using confirmation verbs. 

•SNALU62_C_SL_SYNCPT

Indicates that conversations using this LU have the option of using both confirmation verbs and sync-point processing. 
 
 

gateway
 
A pointer to a GWY_INFO structure to receive information about the gateway with which the local LU is associated.  This parameter contains the node name of the gateway, the transport to use to connect to the gateway, and the capability of the LU defined in the gateway. 
 
The interface allocates the memory referenced by the GWY_INFO structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

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 obtain operating parameter values established by the snalu62_define_local_lu verb, as well as to obtain the current LU-LU session count. 
 

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