NAME

snalu62_attach_listen − Waits for any inbound allocation request from a remote transaction program.  The inbound request can be for any local transaction program. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_attach_listen(
       RES_ID ∗resource,
       TP_ID ∗tp_id,
       UINT32 shared_res_id [2],
       STATUS_VEC status_vec,
       char ∗local_lu_name,
       char ∗remote_lu_alias,
       char ∗mode_name,
       SES_ID session_id,
       TP_NAME ∗tpn,
       UINT32 ∗type,
       UINT32 ∗sync_level,
       SECUR_INFO ∗security,
       BUFFER ∗luwid,
       BUFFER ∗conversation_correlator,
       PIP_DATA ∗pip,
       SRV_INFO ∗server_info
       );
 
 

Valid Conversation States

 
HDX: Reset

FDX: Reset
 
 

SUPPLIED PARAMETERS

local_lu_name

A pointer to a null-terminated ASCII string specifying either the fully-qualified network name or the locally-defined alias of the local LU. 
 
 

server_info

A pointer to a SRV_INFO structure specifying the LU6.2 Server to use.  Specify 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. 
 

Because the shared_res_id value is internal to the LU6.2 Server, you must specify the same LU6.2 Server information here that you specify for the snalu62_pass_resource verb. 

RETURNED PARAMETERS

resource

A pointer to a RES_ID structure to receive the resource ID assigned to the conversation by the interface. Supply this ID on all subsequent verb calls for this conversation. 
 

The interface allocates the memory referenced by the RES_ID structure.  If you use the snalu62_pass_resource capability to pass this conversation onto another program, the transaction program must deallocate this memory by using the snalu62_free_mem verb.  If the conversation stays local to the program using the snalu62_attach_listen verb, the snalu62_deallocate verb deallocates the memory associated with the RES_ID structure. 
 

tp_id

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

shared_res_id

A pointer to a 2-member UINT32 array to receive the internal resource ID maintained by the LU6.2 Server for the conversation returned by this verb.  The transaction program can pass the conversation to another program by passing this array to the program.  That program can then specify this information when it calls the snalu62_pass_resource verb to receive the passed conversation. 
 

status_vec

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

remote_lu_alias

A pointer to a 65-byte char buffer to receive a null-terminated ASCII string indicating the locally-defined name of the remote LU from which the interface received the allocation request. 
 
 

mode_name

A pointer to a 9-byte char buffer to receive a null-terminated ASCII string indicating the mode name used to establish the session to the remote LU from which the interface received the allocation request. 
 

session_id

A pointer to a SES_ID structure to receive the session identifier of the LU-LU session over which the interface received the allocation request. 
 
 

tpn

A pointer to a TP_NAME structure to receive the transaction program name specified in the allocation request.  The translate field of the TP_NAME structure indicates whether the interface translated the transaction program name specified on the allocate request. 
 

The interface allocates the memory referenced by the TP_NAME structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

type

A pointer to a UINT32 location to receive a value indicating the type of conversation allocated.  It can be one of the following values:
 
 
 
 

•SNALU62_C_BASIC
 

•SNALU62_C_MAPPED
 

•SNALU62_C_FDX_BASIC
 

•SNALU62_C_FDX_MAPPED
 
 
 
 

sync_level

A pointer to a UINT32 location to receive a value indicating the synchronization level specified in the allocate request.  It can be one of the following values:
 
 
 
 

•SNALU62_C_SL_NONE (the default)

Indicates that the conversation cannot use any confirmation verbs or sync-point processing. 
 

•SNALU62_C_SL_CONFIRM

Indicates that the conversation can use only confirmation verbs. 
 

•SNALU62_C_SL_SYNCPT

Indicates that the conversation can use both confirmation verbs and sync-point processing. 
 
 
 
 

security

A pointer to a SECUR_INFO structure to receive the conversation-level security verification information specified on the allocate request that the local LU uses to validate access to the local program and its resources. 
 
 

Unlike the snalu62_get_tp_properties verb, this verb returns the password information.  The interface allocates the memory referenced by the SECUR_INFO structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

luwid

A pointer to a BUFFER structure to receive the logical unit of work (LUW) identifier that the interface should use for the conversation.  If the sync_level parameter returns a value of SNALU62_C_SL_SYNCPT, this parameter indicates the protected LUW identifier. Otherwise, this parameter indicates the unprotected LUW identifier. 
 

The interface allocates the memory referenced by the BUFFER structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

conversation_correlator

A pointer to a BUFFER structure to receive the conversation correlator that the interface should use for the conversation. 
 

The interface allocates the memory referenced by the BUFFER structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

pip

A pointer to a PIP_DATA structure to receive the PIP data received from the remote transaction. 
 

The interface allocates the memory referenced by the PIP_DATA structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

DESCRIPTION

 
Use this unarchitected verb to receive inbound allocation requests when the requested transaction program cannot be not known in advance. The requested transactions program may or may not be defined with the snalu62_define_tp verb. This verb can receive an allocation request for ANY local transaction program whereas the snalu62_receive_allocate verb should be used when the inbound allocation request is always for a known transaction program. 
 
 
 

RESTRICTIONS

 
A conversation can only be transitioned once during a conversation and it must be transitioned prior to any other verb call being made for this conversation.

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

This verb is available only if the local LU has been defined with the session_activation parameter set to TRUE. 
 

RETURN VALUES

SNALU62_S_OKnormal successful completion

SNALU62_S_CONVCANC
conversation cancelled

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_allocate

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.