Name

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

FORMAT

STATUS_RTN snalu62_prepare_to_receive(
     RES_ID resource,
     STATUS_VEC status_vec,
     UINT32 type,
     UINT32 locks,
     ASYNC_INFO ∗wait_object
     );
 
 
 

Valid Conversation States

 
Send
 
 

Arguments

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

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

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

•SNALU62_C_SYNC_LEVEL (the default)

 
Specifies that the interface should perform 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_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. 
 
 
 

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.
 

Return Values

SNALU62_S_OK
normal 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