NAME

snalu62_request_to_send − Signals the remote transaction program that the local transaction program wants to send data. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_request_to_send(
       RES_ID resource,
       STATUS_VEC status_vec,
       ASYNC_INFO ∗wait_object
       );
 
 

Valid Conversation States

 
HDX: 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. 
 
 

wait_object

A pointer to an ASYNC_INFO structure specifying whether the interface should process this verb in a blocking or non-blocking manner. 
 
 

RETURNED PARAMETER

status_vec

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

DESCRIPTION

 
This verb causes the remote transaction program to receive a REQUEST_TO_SEND_RECEIVED indication. The program places itself in the Receive state by issuing a RECEIVE_AND_WAIT or PREPARE_TO_RECEIVE verb. The action also transmit a SEND indication to the local program. The local conversation state changes to Send when the local program subsequently receives the SEND indication from the remote program.

The interface returns the SNALU62_S_CONVEND return code when a request-to-send request is outstanding and the partner transaction program issues a normal or ABEND conversation deallocation.  This code signals that the interface has closed the expedited-send queue. Any subsequent snalu62_request_to_send verbs also receive the SNALU62_S_CONVEND return code. 
 
 

RESTRICTIONS

 
This verb is only available in half-duplex conversations.
 

RETURN VALUES

SNALU62_S_OKnormal successful completion

SNALU62_S_CONVCANC
conversation canceled

SNALU62_S_CONVEND
conversation ended

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_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
 
 
 

ERRORS

 
None

RELATED INFORMATION

 
Functions: snalu62_send

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.