NAME

snalu62_display_local_lu − Displays a local LU’s parameters. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

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

SUPPLIED PARAMETERS

 
 

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. 
 
 
 

 
 
 

SUPPLIED AND RETURNED PARAMETERS

 
 

fully_qualified_lu_name

A pointer to a 18-byte buffer which supplies or receives the fully-qualified network name of the local LU. Specify one of the following:
 
 
 

•If you want to supply the fully-qualified local LU name, specify a pointer to the 1- to 17-character null-terminated fully-qualified local LU name (in ASCII). 
 

•If you want to receive the fully-qualified local LU name, specify a pointer to a 18-byte buffer to receive the 1- to 17-character null-terminated fully-qualified local LU name (in ASCII).  This buffer must contain an initial null character. 
 

•If you do not want to supply or receive the fully-qualified local LU name, specify a NULL pointer. 
 

You must supply either the fully-qualified local LU name or the locally-known alias of the local LU. 

If you supply both the fully-qualified local LU name and the locally-known alias of the local LU, the interface uses the fully-qualified local LU name.  If you supply a pointer to a buffer, the interface always returns the fully-qualified local LU name.  To prevent the interface from overwriting the end of the buffer, always use an 18-byte buffer. 

 

 
 

local_lu_alias

A pointer to a 65-byte char buffer which supplies or receives the locally-known alias of the local LU.  Specify one of the following:
 
 
 

•If you want to supply the locally-known alias of the local LU, specify a pointer to the 1- to 64-character null-terminated locally-known alias of the local LU (in ASCII). 
 

•If you want to receive the locally-known alias of the local LU, specify a pointer to a 65-byte buffer to receive the 1- to 64-character null-terminated locally-known alias of the local LU (in ASCII).  This buffer must contain an initial null character. 
 

•If you do not want to supply or receive the locally-known alias of the local LU, specify a NULL pointer. 
 

You must supply either the fully-qualified local LU name or the locally-known alias of the local LU. 

If you supply both the fully-qualified local LU name and the locally-known alias of the local LU, the interface uses the fully-qualified local LU name.  If you supply a pointer to a buffer, the interface always returns the locally-known alias of the local LU.  To prevent the interface from overwriting the end of the buffer, always use a 65-byte buffer. 

 

 
 
 

 
 
 
 

RETURNED PARAMETERS

 
 

status_vec

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

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_names

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

 
 
 

 

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

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.