OSI/AS Programming Manual

APS_EVENT_RECEIVE_
APS Procedure Calls
056783 Tandem Computers Incorporated 3–71
APS_EVENT_RECEIVE_ This procedure allows you to receive an event. In other words, it notifies you when an
indication or confirm primitive becomes available to you. If the connection is in
nowait mode, complete this operation by calling the MFM_AWAITIOX_ procedure,
described in Appendix B.
When you have received an event, call APS_STATUS_ to find out which event it is.
For further information about the use of this procedure, see “Receiving an Event” in
Section 2.
status := APS_EVENT_RECEIVE_ ( cepi ! I
,[ time-limit ] ! I
,[ tag ] ! I
,[ block-size ] ); ! I
status returned value
INT
indicates the outcome of the call. For the possible values of ZAPS-VAL-STATUS-
xxx, see “Status Codes” in Appendix B. If you are in wait mode, the value ZAPS-
VAL-STATUS-EVENT tells you that you have received an event. In nowait mode,
this value is returned later, when you call MFM_AWAITIOX_.
cepi input
INT:value
is the connection endpoint identifier (CEPI) for this connection.
time-limit input
INT(32):value
indicates how long you are willing to wait for an event to occur. The following
values are valid for this parameter:
0D Check for an event without waiting.
1D Wait indefinitely for an event. This is the default value.
Note If you use the value -1D in wait mode, the procedure does not complete until you receive an event. If you
simply want to check for an event but carry on processing if no event is available, specify the value 0D.