NAME

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

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_test(
       RES_ID resource,
       STATUS_VEC status_vec,
       UINT32 test
       );
 
 
 
 
 

Valid Conversation States

 
For snalu62_test(test=SNALU62_C_POSTED):

  HDX: Receive
 
  FDX: Not supported

For snalu62_test(test=SNALU62_C_RTS_RECV):

  HDX: Send and Receive
 
 
  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. 
 
 

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. 
 
 
 
 

RETURNED PARAMETER

status_vec

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

DESCRIPTION

 
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. 
 

test = SNALU62_C_POSTED Processing

If posting was active for the conversation and the interface posted the conversation, the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software returns one of the following primary return codes to indicate the type of data received:
 
 
 

•SNALU62_S_OK_DATA -- indicates that data is available for the conversation. 
 

•SNALU62_S_OK_NOT_DATA -- indicates that information other than data, such as a CONFIRM or SEND indication, is available for the conversation. 
 

If posting is active for the conversation but the interface has not yet posted the conversation, the interface returns SNALU62_S_UNSUC.  If the program has not enabled posting (through the use of the snalu62_post_on_receipt verb) or posting has been reset or cancelled, the interface returns SNALU62_S_NOPOST. 
 

test = SNALU62_C_RTS_RECV Processing

If the interface has received a REQUEST_TO_SEND indication for this conversation, the interface returns SNALU62_S_OK.  To enter the Receive state, the local program must issue an snalu62_receive_and_wait or snalu62_prepare_to_receive verb.  If no REQUEST_TO_SEND indication has been received, the interface returns SNALU62_S_UNSUC. 
 
 

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_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 for any of the specified conversations

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
 
 
 

ERRORS

 
None

RELATED INFORMATION

 
Functions: snalu62_post_on_receipt

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.