snalu62_get_tp_properties(3) — Subroutines

NAME

snalu62_get_tp_properties − Returns information about the transaction program calling the verb.

LIBRARY

/usr/shlib/libsnatprm.so

SYNOPSIS

#include <sna/snatprmdf.h>

STATUS_RTN snalu62_get_tp_properties(
       RES_ID resource,
       TP_ID tp_id,
       STATUS_VEC status_vec,
       char ∗fully_qualified_local_lu_name,
       char ∗local_lu_alias,
       TP_NAME ∗own_tpn,
       char ∗security_user_id,
       char ∗security_profile,
       BUFFER ∗luwid,
       BUFFER ∗protected_luwid
       );

Valid Conversation States

HDX: All except Reset

FDX: All except Reset

SUPPLIED PARAMETER

resource

A RES_ID structure specifying the resource ID assigned to the conversation by the interface. This ID is returned by the snalu62_allocate, snalu62_attach_listen, or snalu62_receive_allocate verb.

RETURNED PARAMETERS

tp_id

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

status_vec

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

fully_qualified_local_lu_name

A pointer to an 18-byte char buffer to receive a null-terminated ASCII string indicating the fully-qualified network name of the local LU.

local_lu_alias

A pointer to a 65-byte char buffer to receive a null-terminated ASCII string indicating the locally-known alias of the local LU.

own_tpn

A pointer to a TP_NAME structure to receive the local name of the transaction program. The translate field of this structure indicates whether the transaction program name specified on the snalu62_allocate or snalu62_receive_allocate request was translated.

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.

security_user_id

A pointer to an 11-byte char buffer to receive a null-terminated ASCII string indicating the user ID carried on the incoming allocation request that established this conversation.

security_profile

A pointer to an 11-byte char buffer to receive a null-terminated ASCII string indicating the profile carried on the incoming allocation request that established this conversation.

luwid

A pointer to a BUFFER structure to receive the unprotected logical unit of work (LUW) identifier in use by the conversation. For outgoing conversations, you specified the LUW identifier on the snalu62_allocate verb.

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

protected_luwid

A pointer to a BUFFER structure to receive the protected logical unit of work (LUW) identifier in use by the conversation. For outgoing conversations, you specified the LUW identifier on the snalu62_allocate verb.

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

DESCRIPTION

Use the snalu62_get_tp_properties verb to find out the current transaction program name. A transaction program can have an unknown name in the following circumstances:

•The program has multiple snalu62_receive_allocate calls outstanding at a time.

•The program was started by an Attach Manager and did not specify a name on the snalu62_receive_allocate verb.

The interface implemented by the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX product supports multiple transaction program names in a single UNIX process.

For a complete discussion of transaction programs and transaction program names, see Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Programming.

RESTRICTIONS

None

RETURN VALUES

SNALU62_S_OKnormal successful completion

SNALU62_S_CONVCANC
conversation canceled

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_UNSUC
verb did not execute successfully

ERRORS