NAME

snalu62_confirm − Sends a confirmation request to the remote transaction program and waits for a reply. The interface flushes the currently buffered send data. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_confirm(
       RES_ID resource,
       STATUS_VEC status_vec,
       ASYNC_INFO ∗wait_object,
       UINT8 ∗rts_recv,
       UINT8 ∗exp_data_recv
       );
 
 

Valid Conversation States

 
HDX: Send

FDX: Not supported
 
 
 

SUPPLIED PARAMETERS

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. 
 
 

wait_object

A pointer to an ASYNC_INFO structure specifying whether the interface should process this verb in a blocking or non-blocking manner. 
 
 

RETURNED PARAMETERS

status_vec

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

rts_recv

A pointer to a UINT8 location to receive a boolean value indicating whether the remote transaction program has requested permission to send data.  A value of TRUE (1) indicates the remote program is requesting to send data.  A value of FALSE (0) indicates the remote program has not requested to send data. 
 
 

exp_data_recv

A pointer to a UINT8 location to receive a boolean value indicating whether an expedited data notification has been received.  A value of TRUE (1) indicates an expedited data notification has been received.  A value of FALSE (0) indicates no expedited data notification has been received. 
 
 

DESCRIPTION

 
This verb and the snalu62_confirmed verb allow cooperating transaction programs to verify that a unit of communication has taken place before proceeding with the next unit.  The LU flushes its send buffer as a function of this verb. 
 
 

RESTRICTIONS

 
This verb is only available in half-duplex conversations.
 

RETURN VALUES

SNALU62_S_OKnormal successful completion

SNALU62_S_ALLERR
conversation could not be allocated

SNALU62_S_BACKOUT
backed out

SNALU62_S_CONVCANC
conversation canceled

SNALU62_S_DEABPR
deallocate ABEND program

SNALU62_S_DEABSVC
deallocate ABEND services

SNALU62_S_DEABTIM
deallocate ABEND timer

SNALU62_S_FMHNOT
user control data (FMH) not supported

SNALU62_S_MAPEFAI
map execution failure

SNALU62_S_MAPNFOU
map name not found

SNALU62_S_MAPNSUP
mapping not supported

SNALU62_S_OPINCOMP
non-blocking operation not completed

SNALU62_S_OPNOTACC
non-blocking operation not accepted

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRERPU
program error purging

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_RESFNO
resource failure no retry

SNALU62_S_RESFRET
resource failure retry

SNALU62_S_STAERR
LU6.2 verb function-name invalid with conversation in current state

SNALU62_S_SVCERPU
service error purging

SNALU62_S_UNSUC
verb did not execute successfully
 
 
 

ERRORS

 
None

RELATED INFORMATION

 
Functions: snalu62_confirmed

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.