This subroutine waits for a response to a request for a point in a Shopping List. The application may specify whether to wait for all or any responses to the requests for the point in the Shopping List. PTMAP returns control to the application after the response or group of responses for requests in the specified Shopping List have been returned.

Syntax

int PTMAP_wait_sl_point (sl_adr, point_adr,

                         wait_flag, retstat)

PTMAP_ADDR  *sl_adr;

PTMAP_ADDR  *point_adr;

int         wait_flag;

COR_STATUS  *retstat;

Input Arguments

sl_adr	Identifier used to reference this request.
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 Shopping List).

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_SL_ADR_NULL
	PTMAP_SL_ADR_NOTF
	PTMAP_SEQ_NUM_MISMATCH
	The following warning may be returned:
	PTMAP_REQ_NOT_OUT

Return Value

The contents of retstat.status.

More information

Point Management API subroutines.

---