snalu62_get_type(3) — Subroutines

NAME

snalu62_get_type − Returns a value indicating the type of the specified conversation.

LIBRARY

/usr/shlib/libsnatprm.so

SYNOPSIS

#include <sna/snatprmdf.h>

STATUS_RTN snalu62_get_type(
       RES_ID resource,
       STATUS_VEC status_vec,
       UINT32 ∗type
       );

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.

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

DESCRIPTION

A transaction program that can support either basic conversations or mapped conversations calls this verb to determine which category of verbs (and verb parameters), basic or mapped, half-duplex or full-duplex, it should use for this conversation.

A transaction program that supports more than one conversation type should call snalu62_get_type as the first verb after a call to snalu62_receive_allocate or snalu62_attach_listen. The value returned for the type parameter indicates what type of conversation was started.

RESTRICTIONS

None

RETURN VALUES

SNALU62_S_OKnormal successful completion

SNALU62_S_CONVCANC
conversation canceled

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_UNSUC
verb did not execute successfully

ERRORS