Mitsubishi Electric MELSEC iQ-R Series Manual page 49

CITL_SetCollectData
This function sets data to be sampled in data sampling in each sequence scan.
■ Format
short CITL_SetCollectData (long* plSetData, unsigned short usSetHeaderInfo, unsigned short usRecordNum, unsigned long*
pulRecordSize)
■ Argument
Argument Name
plSetData Storage destination for data set in the
data sampling in each sequence scan
setting
usSetHeaderInfo Header information setting
usRecordNum Number of retainable records
pulRecordSize Record size storage destination
• Set so that the total number of points specified for each block is 32768 points or less.
Otherwise, a size error occurs.
• Specify a value of '1' or more for the number of sampling points. When '0' is specified for the number of sampling points or
the number of blocks, an error is returned.
• When a value other than NULL is specified for the storage destination for data set in the data sampling in each sequence
scan setting (plSetData), the temporary area will be reserved according to the specified settings. If the area is already
reserved, the reserved area will be released.
When NULL is specified for the storage destination for data set in the data sampling in each sequence scan setting
(plSetData), settings will be cleared and the temporary area will be released.
• Specify a device which can be accessed with a MELSEC iQ-R series data link function for the device type.
• The specification method of the storage destination for data set in the data sampling in each sequence scan setting
(plSetData) is as follows:
Storage position Description
plSetData[0] Number of blocks
plSetData[1] Device type
plSetData[2] Start device number
plSetData[3] Number of sampling points
plSetData[4] Device type
plSetData[5] Start device number
plSetData[6] Number of sampling points
 
plSetData[3(n-1)+1] Device type
plSetData[3(n-1)+2] Start device number
plSetData[3(n-1)+3] Number of sampling points
• The specification method of the header information setting (usSetHeaderInfo) is as follows:
Definition names can be combined by the OR operator.
Definition name Description
REMOVE_INDEX An index is not output.
REMOVE_DATE A date and time is not output.
REMOVE_DATA_MISS Data missing information is not output.
• Specify a value of '1' or more for the number of retainable records (usRecordNum).
When '0' is specified, an error is returned.
Description
Specify the number of blocks, device type, start device number, and number
of sampling points of a device to be sampled.
Specify header information not to output at the time of data sampling.
(If 0 is specified, all header information is output.)
Specify the size of the temporary area (number of retainable records) to store
devices to be sampled.
Specify the storage destination of the record size calculated by the storage
destination for data set in the data sampling in each sequence scan setting
(plSetData) and the header information setting (usSetHeaderInfo).
(When NULL is specified, the record size is not stored.)
3.1 C Intelligent Function Module Dedicated Functions
IN/OUT
IN
IN
IN
OUT
Block

Block 1
Block 2

Block n
3 DETAILS OF FUNCTION
3
47