Rockwell Automation 1771-DMC_DMC1_DMC4_DXPS Control Coprocessor User Manual - Manual (Page 204)

API Library of Routines
Appendix B
DTL_RMW_W_IDX
B-73
Initiates an operation that reads a data element of the PLC-5 programmable
controller, modifies some of the bits based on mask values, then writes the
data element back. This function can read and modify any elements of the
file using only one data definition.
Important: To use this function call, you must have the versions of the
ABLIB.L and CORPRO.H files that accompany Series A Revision D
(1.20) or later of the Program Development Software. Contact Allen-
Bradley Global Technical Support Services at (216) 646-6800 if you need
these updates.
C Syntax
#include <copro.h>
unsigned DTL_RMW_W_IDX (name_id, and_mask, or_mask, iostat, index)
unsigned name_id;
unsigned and_mask;
unsigned or_mask;
unsigned *iostat;
unsigned index;
Parameters
name_id
DTL_C_DEFINE returns this handle when the data file to be read and
modified is defined.
and_mask
Use and_mask to specify the bits that you want to preserve in the data.
A “1” bit in the AND mask preserves the corresponding bit in the data;
a “0” bit forces the corresponding bit to zero.
or_mask
Use or_mask to specify the bits that you want to set in the data.
A “1” bit in the OR mask forces the corresponding bit in the data;
a “0” bit forces the corresponding bit unchanged. The OR mask is
applied after the AND mask.
iostat
Returns a final completion status. Possible completion status values are:
Value Meaning
0 DTL_SUCCESS = operation completed successfully
27 DTL_E_NOATMPT = I/O operation not attempted; see status variable for reason
41 DTL_E_CNVT = dataĆconversion error
xxx ¬ PCCC_E_xxx = operation refused by the PLCĆ5 programmable controller
¬ See Table B.A for PCCC errors.
DTL_RMW_W_IDX