NAME

snalu62_define_remote_lu − Defines a remote LU and initializes or changes parameters that control the operation of the local LU when in session with the remote LU. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_define_remote_lu(
       STATUS_VEC status_vec,
       char ∗local_lu_name,
       char ∗fully_qualified_remote_lu_name,
       char ∗remote_lu_alias,
       char ∗uninterpretted_lu_name,
       UINT32 initiate_type,
       UINT8 parallel_session_support,
       UINT8 cnos_support,
       BUFFER ∗lu_lu_password,
       UINT32 security_acceptance,
       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 this remote LU is associated. 
 
 

fully_qualified_remote_lu_name

A pointer to a 1- to 17-character null-terminated ASCII string specifying the fully-qualified network name of the remote LU being defined.  If the remote LU name is already defined, this verb changes the other parameter values. 
 

In the case of passive connections using the DECnet SNA Gateway for Synchronous Transport and DECnet SNA Gateway for Channel Transport products, the interface performs the usual syntax check on this parameter.  However, it does not check the value specified in this parameter against what the interface receives in the BIND request. 

remote_lu_alias

A pointer to a 1- to 64-character null-terminated ASCII string specifying the locally-known alias of the remote LU being defined. 
 

Once you define a remote LU, you cannot change its alias. 

uninterpretted_lu_name

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

initiate_type

A UINT32 value specifying the session initiation type that the local LU should use in the initiate request. Specify one of the following values:
 
 
 
 

•SNALU62_C_INITIATE_ONLY

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

•SNALU62_C_INITIATE_OR_QUEUE

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

parallel_session_support

A boolean UINT8 value specifying whether the local LU supports parallel sessions with this remote LU.  A value of TRUE (1) indicates the local LU supports parallel sessions. 
 
 

cnos_support

A boolean UINT8 value specifying whether the local LU supports the exchange of CNOS requests and replies with this remote LU.  A value of TRUE (1) indicates the local LU supports CNOS.  Support for exchanging CNOS requests and replies requires parallel session support. 
 
 

lu_lu_password

A pointer to a BUFFER structure containing a binary string of bytes, up to eight bytes in length.  The BUFFER structure contains the password the local LU uses for session level verification when it activates sessions with this remote LU. This password should be specified in a manner that yields a random value. The value must match the value specified at the remote LU. 
 
 

security_acceptance

A UINT32 value specifying the level of conversation-level security verification information that the local LU accepts on allocation requests it receives from the remote LU.  Specify one of the following values:
 
 
 
 

•SNALU62_C_SEC_ACC_NONE (the default)

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

•SNALU62_C_SEC_ACC_CONVERSATION

Specifies that the interface should accept 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

Specifies that the interface should accept 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 should accept requests with the already-verified indicator set, but should reject requests with the persistent-verification indicator set. 
 

•SNALU62_C_SEC_ACC_PERSIST_VERI

Specifies that the interface should accept 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 should accept requests with the persistent-verification indicator set, but should reject requests with the already-verified indicator set. 
 

•SNALU62_C_SEC_ACC_AV_AND_PV

Specifies that the interface should accept 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 should accept requests with either the persistent-verification indicator set or the already-verified indicator set. 
 
 
 
 

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. 
 
 

RETURNED PARAMETER

status_vec

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

DESCRIPTION

 
Use this verb prior to the local LU participating in any network activity involving the remote LU.

If no locally-known alias of the remote LU is defined at the local LU, local transaction programs may specify the remote LU’s fully-qualified LU name
 
on the remote_lu_name parameter of the snalu62_allocate verb. 
 
 
 

RESTRICTIONS

 
Only a process having superuser privileges or a user listed in the system group in the /etc/group file can call this verb. 

If you are using this verb to manage an LU6.2 Server on a remote node, the remote server must have access to an access validation file that includes your node name. 
 
 
For a description of the LU6.2 Server access validation file, see Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Administrator’s Guide. 
 

Once you define a remote LU, you cannot change the LU’s alias or security acceptance parameter. 
 

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