Name

snalu62_test − Tests the specified conversation for a condition.  The return code indicates the result of the test. 
 
 
 

FORMAT

STATUS_RTN snalu62_test(
     RES_ID resource,
     STATUS_VEC status_vec,
     UINT32 test
     );
 
 
 
 

Valid Conversation States

 
For snalu62_test(test=SNALU62_C_POSTED):

 
##Receive

 
For snalu62_test(test=SNALU62_C_RTS_RECV):

 
##Send
 
and 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. 
 
 

test
 
A UINT32 value specifying the condition that the interface should test. Specify one of the following values:
 

•SNALU62_C_POSTED (the default)

Specifies that the interface should test whether the conversation has been posted. 

•SNALU62_C_RTS_RECV

Specifies that the interface should test whether the conversation partner has sent a request-to-send. 
 
 
 
 
 

Description

 
Use the test parameter of this verb in conjunction with the snalu62_post_on_receipt verb. The use of snalu62_post_on_receipt and this verb allows a program to continue its processing while waiting for information to become available.  To do this, the program calls snalu62_post_on_receipt for one or more conversations and then calls this verb for each conversation to determine when information is available to be received. 
 

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_DEALNOR
deallocate normal

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_NOPOST
posting is not active; that is, only one conversation can be tested at a time with this call

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRERNTR
program error no truncate

SNALU62_S_PRERPU
program error purging

SNALU62_S_PRERTR
program error truncate

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_SVCENTR
service error no truncate

SNALU62_S_SVCERPU
service error purging

SNALU62_S_SVCERTR
service error truncate

SNALU62_S_UNSUC
verb did not execute successfully