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

API Library of Routines
Appendix B
TAG_DEFINE
B-116
Adds an entry to the control-coprocessor TAG table.
C Syntax
#include
unsigned TAG_DEFINE (name_id,tag_addr,
tag_name,tag_size,access)
unsigned *name_id;
unsigned tag_addr;
unsigned char *tag_name;
unsigned tag_size;
unsigned char access;
Parameters
name_id
Name_id is used to return a handle assigned by the TAG library to the
TAG name.
tag_addr
Pointer to the start of the user’s tagged area.
tag_name
Specifies the name of the user’s TAG. This is a null-terminated
ASCII string of up to 9 characters. The TAG name can contain the
following characters: A-Z, a-z, 0-9, and _. The first character
must be alphabetic.
tag_size
Specifies the number of consecutive bytes starting at the tag_addr to be
included in the tagged area. This number must be
≤
240.
access
Specifies either READ or READ/WRITE access to the tagged area by
other processes. Possible values are:
Value Symbolic Name ¬ Access
0 TG_READ Only the process that created the TAG can modify it;
other processes can only READ the TAG
1 TG_MODIFY Any process can READ or modify the TAG
¬ These symbols are in COPRO.H.
TAG_DEFINE