Mitsubishi Electric MELSEC iQ-R Series - Page 49

3 DETAILS OF FUNCTION
3.1 C Intelligent Function Module Dedicated Functions
47
3
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
• 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:
• The specification method of the header information setting (usSetHeaderInfo) is as follows:
Definition names can be combined by the OR operator.
• Specify a value of '1' or more for the number of retainable records (usRecordNum).
When '0' is specified, an error is returned.
Argument Name Description IN/OUT
plSetData Storage destination for data set in the
data sampling in each sequence scan
setting
Specify the number of blocks, device type, start device number, and number
of sampling points of a device to be sampled.
IN
usSetHeaderInfo Header information setting Specify header information not to output at the time of data sampling.
(If 0 is specified, all header information is output.)
IN
usRecordNum Number of retainable records Specify the size of the temporary area (number of retainable records) to store
devices to be sampled.
IN
pulRecordSize Record size storage destination 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.)
OUT
Storage position Description Block
plSetData[0] Number of blocks 
plSetData[1] Device type Block 1
plSetData[2] Start device number
plSetData[3] Number of sampling points
plSetData[4] Device type Block 2
plSetData[5] Start device number
plSetData[6] Number of sampling points
 
plSetData[3(n-1)+1] Device type Block n
plSetData[3(n-1)+2] Start device number
plSetData[3(n-1)+3] Number of sampling points
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.