snalu62_get_attributes(3) — Subroutines

NAME

snalu62_get_attributes − Returns information about the specified conversation.

LIBRARY

/usr/shlib/libsnatprm.so

SYNOPSIS

#include <sna/snatprmdf.h>

STATUS_RTN snalu62_get_attributes(
       RES_ID resource,
       STATUS_VEC status_vec,
       char ∗remote_lu_alias,
       char ∗fully_qualified_remote_lu_name,
       char ∗mode_name,
       UINT32 ∗sync_level,
       UINT32 ∗conversation_state,
       BUFFER ∗conversation_correlator,
       SES_ID ∗session_id,
       UINT32 ∗conversation_group_id
       );

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

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-known alias of the LU at which the remote transaction program is located.

fully_qualified_remote_lu_name

A pointer to an 18-byte char buffer to receive a null-terminated ASCII string indicating the fully-qualified name of the LU at which the remote transaction program is located.

mode_name

A pointer to a 9-byte char buffer to receive a null-terminated ASCII string indicating the mode name in use by the session supporting the conversation.

sync_level

A pointer to a UINT32 location to receive a value indicating the synchronization level that the local and remote transaction programs are using for the conversation. 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.

conversation_state

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

•SNALU62_C_HDX_RESET

•SNALU62_C_HDX_SEND

•SNALU62_C_HDX_RECV

•SNALU62_C_HDX_CONFIRM

•SNALU62_C_HDX_CONFIRM_SEND

•SNALU62_C_HDX_CONFIRM_DEALLOC

•SNALU62_C_HDX_DEALLOC

•SNALU62_C_HDX_DEALLOC_PENDING

•SNALU62_C_FDX_RESET

•SNALU62_C_FDX_SEND_RECV

•SNALU62_C_FDX_SEND_ONLY

•SNALU62_C_FDX_RECV_ONLY

conversation_correlator

A pointer to a BUFFER structure to receive the conversation correlator in use for the conversation. The local transaction program or the remote LU creates the conversation correlator for its use during sync-point resynchronization. For sync-point resynchronization, the conversation correlator correlates the logical unit of work (LUW) to the sync-point states associated with the current instance of the local program.

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

session_id

A pointer to a SES_ID location to receive the session identifier information. Use this parameter if the transaction program calls the snalu62_deactivate_session verb.

conversation_group_id

A pointer to a UINT32 location to receive the value indicating the conversation group ID associated with the session being used by the conversation.

DESCRIPTION

The transaction program calls this verb to obtain the attributes of the conversation.

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