PTMAP_get_point_ChangeApprovalinfo

This subroutine sends a request to Point Management for information about the point data type including change approval information.

Syntax

iint PTMAP_get_point_info_ChangeApprovalinfo (point_adr,

                                             data_type,
                                             data_length,
                                             elements,
                                             data_size,
                                             display_format,
                                             change_approval_mask,
                                             retstat)
PTMAP_ADDR      *point_adr;
PTM_DATA_TYPE   *data_type;
PTM_DATA_LENGTH *data_length;
PTM_ELEMENTS    *elements;
COR_I4          *data_size;
CHAR            *display_format;
int             *change_approval_mask;
COR_STATUS      *retstat;

Input Arguments

point_adr Pointer to the point.

Output Arguments

data_type Point data type.
data_length The length of the data type.
Elements Number of elements in point.
data_size Total data size.
display_format The configured display format from POINT.DAT.
change_approval_mask Flag indicating what type of change approval is required for the point
  • To test whether the point is configured for unsigned writes:  
If (change_approval_mask & PTM_CHANGEAPPROVAL_UNSIGNEDWRITES)
  • To test whether the point is configured to require a performer authorization:
If (change_approval_mask & PTM_CHANGEAPPROVAL_PERFORM)
  • To test whether the point is configured to require a performer and verifier authorization:
If(ChangeApproval & PTM_CHANGEAPPROVAL_PERFORMVERIFY)
  • To test if unsigned writes is selected for the point :-
If(ChangeApproval & PTM_CHANGEAPPROVAL_UNSIGNEDWRITES ).
Retstat Pointer to status structure. The following errors may be returned. PTMAP_ADR_PTR_NULL PTMAP_PT_ADR_NULL PTMAP_PT_ADR_NOTF PTMAP_SEQ_NUM_MISMATCH PTM_POINT_HASCHANGEAPPROVAL: PTM_NO_PERFORMUSERID: PTM_NO_VERIFYUSERID: PTM_BAD_PERFORMUSRID_PASSWORD: PTM_BAD_VERIFYUSRID_PASSWORD: PTM_NO_PERFORM_PRIV: PTM_NO_VERIFY_PRIV: PTM_INVAL_CHANGEAPPROVAL_LEVEL: PTM_INVAL_CHANGEAPPROVAL_RESOURCESETPOINT: PTM_INVAL_PERFORMUSERID: PTM_INVAL_VERIFYUSERID: PTMAP_CHANGEAPPROVAL_SAME_USERID: PTM_VERIFIER_PASSWORD_EXPIRED: PTM_PERFORMER_PASSWORD_EXPIRED:

Return Value

The contents of retstat.status.