NAME

snalu62_display_remote_lu − Displays a remote LU’s parameters. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_display_remote_lu(
       STATUS_VEC status_vec,
       char ∗local_lu_name,
       char ∗fully_qualified_remote_lu_name,
       char ∗locally_known_lu_name,
       char ∗uninterpretted_lu_name,
       UINT32 ∗initiate_type,
       UINT8 ∗parallel_session_support,
       UINT8 ∗cnos_support,
       UINT32 ∗security_acceptance_local_lu,
       UINT32 ∗security_acceptance_remote_lu,
       STRING_LIST ∗mode_names,
       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 remote LU is associated. 
 
 

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_remote_lu_name

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

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

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

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

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

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

 

 
 

locally_known_lu_name

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

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

•If you want to receive the locally-known alias of the remote LU, specify a pointer to a 65-byte buffer to receive the 1- to 64-character null-terminated locally-known alias of the remote 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 remote LU, specify a NULL pointer. 
 

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

If you supply both the fully-qualified remote LU name and the locally-known alias of the remote LU, the interface uses the fully-qualified remote LU name.  If you supply a pointer to a buffer, the interface always returns the locally-known alias of the remote 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. 
 
 

locally_known_lu_name

A pointer to a 65-byte char buffer to receive the null-terminated locally-known alias of the remote LU. 
 

uninterpretted_lu_name

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

initiate_type

A pointer to a UINT32 location to receive a value indicating the type of session initiation that the local LU is to use in an initiate request for this remote LU.  It can have one of the following values:
 
 
 
 

•SNALU62_C_INITIATE_ONLY

Indicates that session-initiation requests to this remote LU should indicate that the remote LU deny the request if the request cannot be serviced. 
 

•SNALU62_C_INITIATE_OR_QUEUE

Indicates that session-initiation requests to this remote LU should indicate that the remote LU queue the request if the request cannot be serviced. 
 
 
 
 

parallel_session_support

A pointer to a UINT8 location to receive a boolean value indicating whether the local LU supports parallel sessions with this remote LU.  A value of TRUE (1) indicates that the local LU supports parallel sessions with this remote LU.  If a session is active between the remote and local LU, this parameter returns an indication of the actual support for parallel sessions; otherwise, it returns an indication of the support currently defined at the local LU. 
 
 
 

cnos_support

A pointer to a UINT8 location to receive a boolean value indicating whether the local LU supports the exchange of CNOS requests and replies with this remote LU.  A value of TRUE (1) indicates that the local LU supports CNOS exchanges with this remote LU.  If a session is active between the remote and local LU, this parameter returns an indication of the actual support for CNOS requests; otherwise, it returns an indication of the support currently defined at the local LU. 
 
 

security_acceptance_local_lu

A pointer to a UINT32 location to receive a value indicating the level of conversation-level security information that the local LU accepts on allocation requests it receives from this remote LU.  It can have one of the following values:
 
 
 
 

•SNALU62_C_SEC_ACC_NONE

Indicates that the interface does not accept conversation-level security information on incoming allocation requests from this remote LU. 
 

•SNALU62_C_SEC_ACC_CONVERSATION

Indicates that the interface accepts conversation-level security information on incoming allocation requests from this remote LU. This information must consist of at least a user ID and a password and may optionally include a profile. 
 

•SNALU62_C_SEC_ACC_ALREADY_VERI

Indicates that the interface accepts conversation-level security information on incoming allocation requests from this remote LU. This information must consist of at least a user ID and a password and may optionally include a profile. In addition, the interface accepts requests with the already-verified indicator set, but rejects requests with the persistent-verification indicator set. 
 

•SNALU62_C_SEC_ACC_PERSIST_VERI

Indicates that the interface accepts conversation-level security information on incoming allocation requests from this remote LU. This information must consist of at least a user ID and a password and may optionally include a profile. In addition, the interface accepts requests with the persistent-verification indicator set, but rejects requests with the already-verified indicator set. 
 

•SNALU62_C_SEC_ACC_AV_AND_PV

Indicates that the interface accepts conversation-level security information on incoming allocation requests from this remote LU. This information must consist of at least a user ID and a password and may optionally include a profile. In addition, the interface accepts requests with either the persistent-verification indicator set or the already-verified indicator set. 
 
 
 
 

security_acceptance_remote_lu

A pointer to a UINT32 location to receive a value indicating the level of conversation-level security information that the remote LU accepts on allocation requests it receives from the local LU, when one or more sessions are active between the local and remote LUs.  It can have one of the following values:
 
 
 
 

•SNALU62_C_SEC_ACC_NONE

Indicates that the remote LU does not accept conversation-level security information on incoming allocation requests from this local LU. 
 

•SNALU62_C_SEC_ACC_CONVERSATION

Indicates that the remote LU accepts conversation-level security information on incoming allocation requests from this local LU. This information must consist of at least a user ID and a password and may optionally include a profile. 
 

•SNALU62_C_SEC_ACC_ALREADY_VERI

Indicates that the remote LU accepts conversation-level security information on incoming allocation requests from this local LU. This information must consist of at least a user ID and a password and may optionally include a profile. In addition, the remote LU accepts requests with the already-verified indicator set, but rejects requests with the persistent-verification indicator set. 
 

•SNALU62_C_SEC_ACC_PERSIST_VERI

Indicates that the remote LU accepts conversation-level security information on incoming allocation requests from this local LU. This information must consist of at least a user ID and a password and may optionally include a profile. In addition, the remote LU accepts requests with the persistent-verification indicator set, but rejects requests with the already-verified indicator set. 
 

•SNALU62_C_SEC_ACC_AV_AND_PV

Indicates that the remote LU accepts conversation-level security information on incoming allocation requests from this local LU. This information must consist of at least a user ID and a password and may optionally include a profile. In addition, the remote LU accepts requests with either the persistent-verification indicator set or the already-verified indicator set. 
 
 
 
 

mode_names

A pointer to a STRING_LIST structure to receive the list of mode names currently defined for use with this remote 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. 
 

 
 
 

 

DESCRIPTION

 
Use this verb to retrieve the current values of parameters that control the operation of the local LU in conjunction with the specified remote LU.

This verb returns operating parameters that the snalu62_define_remote_lu and snalu62_define_mode 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_remote_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.