NAME

snalu62_wait − Waits for posting to occur on any of the specified conversations. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_wait(
       RES_LIST ∗resource_list,
       STATUS_VEC status_vec,
       RES_ID ∗resource_posted
       );
 
 

Valid Conversation States

 
HDX: Receive

FDX: Not supported
 
 
 

SUPPLIED PARAMETER

resource_list

A pointer to a RES_LIST structure specifying a list of conversations that the interface should monitor for posting.  Specify the conversations using the RES_ID structures assigned to the conversations by the interface. The IDs were returned by the snalu62_allocate, snalu62_attach_listen or snalu62_receive_allocate verb.  The list can include a mixture of basic and mapped conversations and can include conversations that do not have posting active. 
 
 

The IDs specified in this parameter must all reference conversations supported by the same LU6.2 Server. 

RETURNED PARAMETERS

status_vec

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

resource_posted

A pointer to a RES_ID structure to receive the resource ID of the posted conversation. 
 
 

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 wait for information to become available. 

If posting was active for a 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 the program has not enabled posting on any of the conversations (through the use of the snalu62_post_on_receipt verb) or posting has been reset or cancelled for all the conversations, the interface returns SNALU62_S_NOPOST. 
 
 

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.