Name

snalu62_define_local_lu − Defines a local LU and initializes or changes parameters that control the operation of the local LU. 
 
 
 

FORMAT

STATUS_RTN snalu62_define_local_lu(
     STATUS_VEC status_vec,
     char ∗fully_qualified_lu_name,
     char ∗local_lu_alias,
     UINT32 lu_session_limit,
     SECUR_INFO ∗security,
     MAP_INFO ∗map_name,
     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 being defined. If the local LU name is already defined, this verb changes the other parameter values.
 
 

local_lu_alias
 
A pointer to a null-terminated ASCII string specifying the locally-known alias of the local LU being defined.
 
 

lu_session_limit
 
A UINT32 value specifying the LU-LU session limit for the total number of sessions for the local LU.  A value of zero indicates that no limit is defined. If this parameter has a non-zero value, specify a value greater than or equal to 44 to accommodate the SNA-defined mode names. 
 
 

security
 
A pointer to a SECUR_INFO structure specifying the conversation-level security verification information that the local LU uses to validate access specified on incoming allocation requests on an LU-wide basis. 
 
 

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

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 boolean UINT8 value specifying whether activation of any LU-LU sessions (including CNOS sessions) should be prevented before an snalu62_attach_listen verb is called. 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 UINT32 value specifying the maximum synchronization level allowed for all conversations using this local LU.  Specify one of the following values:
 

•SNALU62_C_SL_NONE (the default)

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

•SNALU62_C_SL_CONFIRM

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

•SNALU62_C_SL_SYNCPT

Specifies that all conversations using this LU have the option of using both confirmation verbs and sync-point processing.  The interface provides you with the capability to write transaction programs that process raw sync point information. The interface does not support the following functions:

•Conversations with a synchronization level of SYNCPT which cannot process synchronization data and perform the necessary two-phase commit processing themselves

•Backout and sync point procedures

gateway
 
A pointer to a GWY_INFO structure specifying the gateway with which this 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 LU defined in the gateway. 
 
 

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 prior to the local LU’s participation in any network activity, such as initializing session limits.
 

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.

 
Once you define an LU, you cannot change the LU’s alias, session activation parameter, or synchronization level.
 

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