PTMAP_get_point | CIMPLICITY 11 Documentation

This subroutine gets the response to a request for a specific point. If more than a single request is outstanding for a point, this function should be called once for each request. If no response is available for the specified request, this function returns COR_WARNING.

Syntax

int PTMAP_get_point (point_adr, sl_adr, req_adr,
                     rsp_type, rsp_stat, rsp_ptr,
                     retstat)
PTMAP_ADDR  *point_adr;
PTMAP_ADDR  *sl_adr;
PTMAP_ADDR  *req_adr;
int         *rsp_type;
COR_STATUS  *rsp_stat;
PTM_RSP     **rsp_ptr;
COR_STATUS  *retstat;

Input Arguments


point_adr	Pointer to the point.

Output Arguments


sl_adr	Pointer to the Shopping List associated with this request.
req_adr	Pointer to the request for which the response was generated..
rsp_type	Request type (such as, PTM_ONCHANGE or PTM_SNAPSHOT).
rsp_stat	Status of the response: COR_SUCCESS, COR_WARNING, or COR_FAILURE.
rsp_ptr	Pointer to a response structure.
Retstat	Pointer to status structure. The following errors may be returned (see Appendix A for an explanation of this code):
	PTMAP_ADR_PTR_NULL
	PTMAP_PT_ADR_NULL
	PTMAP_PT_ADR_NOTF
	PTMAP_SEQ_NUM_MISMATCH
	The following warnings may be returned:
	PTMAP_NO_RSP_RCV
	PTMAP_RCV_QUE_ERR

Return Value

The contents of retstat.status .