CIMPLICITYPTMAP_get_req
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 .
