Rockwell Automation 1771-DMC_DMC1_DMC4_DXPS Control Coprocessor User Manual User Manual

Page 257

Advertising
background image

API Library of Routines

Appendix B

TAG_READ

B-126

Description

Use the TAG_READ function to read data from a tagged memory area.
This function guarantees that the read data area is semaphored during the
read operation.

C Example

unsigned my_fred;

unsigned status;

.

.

.

status = TAG_READ (“Fred”,0,sizeof(my_fred),&my_fred,30);

BASIC Example

The BASIC function code is 66.

DIM status : INTEGER

DIM tag_id : INTEGER

DIM my_data : INTEGER

.

.

.

rem * TAG_READ - read 4 bytes from a tag, starting at offset 0 into

rem * my_data with a timeout of 30 seconds.

RUN AB_BAS (66,status,tag_id,0,4,ADDR(my_data),30)

.

.

.

References

TAG_LINK(); TAG_DEFINE(); TAG_UNDEF();
TAG_GLOBAL_UNDEF(); TAG_WRITE(); TAG_LOCK();
TAG_UNLOCK(); TAG_READ_W(); TAG_WRITE_W();

Advertising