This subroutine waits for a response from Point Management for a specified point. The application may specify whether to wait for the next response or for all outstanding responses for the point. PTMAP returns control to the application after the response or group of responses for the point have been received.
Syntax
int PTMAP_wait_point (point_adr, wait_flag, retstat)
PTMAP_ADDR *point_adr;
int wait_flag;
COR_STATUS *retstat;
Input Arguments
point_adr |
A Point ID created by a call to PTMAP_add_point. |
wait_flag |
Either PTM_NEXT (wait for the next response) or PTM_ALL (wait until responses have been made for all outstanding requests for that point). |
Output Arguments
retstat |
Pointer to status structure. The following errors may be returned (see Appendix A for an explanation of this code): |
|
PTMAP_ADDR_PTR_NULL |
|
PTMAP_PT_ADR_NULL |
|
PTMAP_PT_ADR_NOTF |
|
PTMAP_SEQ_NUM_MISMATCH |
|
The following warning may be returned: |
|
PTMAP_REQ_NOT_OUT |
Return Value
The contents of retstat.status.
Point Management API subroutines. |