Name

snalu62_post_on_receipt − Causes the interface to post the specified conversation when information is available for the program to receive. To wait for posting to occur, make a call to snalu62_wait after calling this verb.  Alternatively, call snalu62_test after this verb to test if posting has occurred. 
 
 
 

FORMAT

STATUS_RTN snalu62_post_on_receipt(
     RES_ID resource,
     STATUS_VEC status_vec,
     UINT32 fill,
     UINT32 length
     );
 
 
 

Valid Conversation States

 
Receive
 
 

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. 
 
 

fill
 
A UINT32 value specifying when posting should occur.  Specify one of the following values:
 

•SNALU62_C_BUFFER

When data is received whose length is at least equal to that specified on the length parameter, post the conversation. 

•SNALU62_C_LL (the default)

When a complete logical record or the remainder of a previously truncated logical record or when part of a logical record is available whose length is at least equal to that specified on the length parameter, post the conversation. 
 
 

 
This parameter is only valid for basic conversations. The interface ignores it for mapped conversations.
 
 
 

length
 
A UINT32 value specifying the maximum length data record that the program can receive. The interpretation of this parameter is based on the value specified on the fill parameter. 
 
 
 

Description

 
Use this verb in conjunction with snalu62_test or snalu62_wait. The use of this verb and snalu62_wait allows a program to post synchronous receiving from multiple conversations. To do this, the program calls this verb for each of the conversations, and then calls snalu62_wait (for each conversation) to wait until information is available.  The use of this verb and snalu62_test allows a program to continue its processing and test the conversations to determine when information is available to be received. 
 

Return Values

SNALU62_S_OK
normal successful completion

SNALU62_S_CONVCANC
conversation canceled

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

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

SNALU62_S_UNSUC
verb did not execute successfully