NAME

snalu62_prepare_to_receive − Changes the conversation state from Send to Receive to prepare for receiving data from the remote transaction program.  It also flushes any data in the local send buffer. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_prepare_to_receive(
       RES_ID resource,
       STATUS_VEC status_vec,
       UINT32 type,
       UINT32 locks,
       ASYNC_INFO ∗wait_object
       );
 
 

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. 
 
 

type

A UINT32 value specifying the type of prepare-to-receive that the interface should execute.  Specify one of the following values:
 
 
 
 

•SNALU62_C_SYNC_LEVEL (the default)

Specifies that the interface should execute the prepare-to-receive function based on the synchronization level of the conversation. 
 

•SNALU62_C_FLUSH

Specifies that the interface should precede the prepare-to-receive operation by a call to the snalu62_flush verb. 
 

•SNALU62_C_CONFIRM

Specifies that the interface should precede the prepare-to-receive operation by a call to the snalu62_confirm verb. 
 
 
 
 

locks

A UINT32 value specifying when the interface should return control to the program. Specify one of the following values:
 
 
 
 

•SNALU62_C_SHORT (the default)

Specifies that the interface should return control to the program when the program receives a confirmed reply. 
 

•SNALU62_C_LONG

Specifies that the interface should return control to the program when the program receives information following a confirmed reply. 
 
 

This parameter is only valid when type is SNALU62_C_CONFIRM or when type is SNALU62_C_SYNC_LEVEL and the conversation synchronization level is SNALU62_C_SL_CONFIRM. 
 
 
 

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 PARAMETER

status_vec

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

DESCRIPTION

 
All transaction programs must remain synchronized with their remote partner. This verb instructs the interface to flush the local transaction program’s send buffers and to transmit a SEND notification to the remote transaction program. This places the local transaction program in the Receive state and the remote program in the Send state.
 
 

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_receive and snalu62_receive_immediate

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.