This subroutine gets the response to a specific request. If the call is successful, Point Management returns the following:

Pointers to the Shopping List and point associated with the request;

A status;

A value.

If no response is available for the specified request, this function returns COR_WARNING.

Syntax

int PTMAP_get_req (req_adr, sl_adr, point_adr,

                   rsp_type, rsp_stat, rsp_ptr,

                   retstat)

PTMAP_ADDR  *req_adr;

PTMAP_ADDR  *sl_adr;

PTMAP_ADDR  *point_adr;

int         *rsp_type;

COR_STATUS  *rsp_stat;

PTM_RSP     **rsp_ptr;

COR_STATUS  *retstat;

Input Arguments

req_adr

Pointer to the request.

Output Arguments

sl_adr	Pointer to the Shopping List associated with this request.
Point_adr	Pointer to point associated with this request.
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_REQ_ADR_NULL
	PTMAP_REQ_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.

More information

Point Management API subroutines.

---