Name

snalu62_display_remote_lu − Displays a remote LU’s parameters. 
 
 
 

FORMAT

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

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.
 
 

fully_qualified_remote_lu_name
 
A pointer to a null-terminated ASCII string specifying the fully-qualified network name of the remote LU being displayed.
 
 

locally_known_lu_name
 
A pointer to a 65-byte char buffer to receive the 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 the initiate request.  It can have one of the following values:
 

•SNALU62_C_INITIATE_ONLY

Indicates that session-initiation requests should indicate that no queuing be done if the request cannot be serviced. 

•SNALU62_C_INITIATE_OR_QUEUE

Indicates that session-initiation requests should indicate that queuing be done 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.
 
 

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.
 
 

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. 
 

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