OSI/FTAM Programming Reference Manual

APS Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
F-4
APS_EVENT_RECEIVE_
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 association is in nowait
mode, complete this operation by calling MFM_AWAITIOX_ on page E-2.
When you have received an event, call APS_STATUS_ to determine which event. For
further information about the use of this procedure, see in the OSI/FTAM Programming
Guide.
status returned value
INT
indicates the outcome of the call. For a list of possible ZAPS-VAL-STATUS-xxx
values, see Table B-1 on page B-2. If you are in wait mode, the value ZAPS-VAL-
STATUS-EVENT tells you that you have received an event. In nowait mode, the
value ZAPS-VAL-STATUS-EVENT is returned later, when you call
MFM_AWAITIOX_.
cepi input
INT:value
is the connection endpoint identifier (CEPI) for this association.
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.
tag input
INT(32):value
is for use in nowait mode only. Specify a unique value to identify this instance of
the procedure call. When the operation is complete, the MFM_AWAITIOX_
status := APS_EVENT_RECEIVE_ ( cepi ! I
,[ time-limit ] ! I
,[ tag ] ) ! I
,[ block-size ] ); ! I
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.