Mitsubishi Electric MELSEC iQ-R C Programming Manual page 165

mdRandWLabelEx
This function writes devices corresponding to labels randomly.
■Format
long mdRandWLabelEx(long lPath, long lNetNo, long lStNo, long* plDev, short* psBuf, long lBufSize, unsigned long long
ullLbCode)
■Argument
Argument Name
lPath Channel
lNetNo Network number
lStNo Station number
plDev Randomly selected device
psBuf Write data storage destination
lBufSize Write data storage destination
size
ullLbCode Label code
The specification method of the randomly selected device (plDev) is as follows:
plDev Description
plDev[0] Number of blocks
plDev[1] Device type
plDev[2] Start device number
plDev[3] Number of write points
plDev[4] Device type
plDev[5] Start device number
plDev[6] Number of write points
 
plDev[3n+1] Device type
plDev[3n+2] Start device number
plDev[3n+3] Number of write points
• One block comprises of three elements such as device type, start device number, and number of write points, the total
number of blocks will be stored in the first element of the randomly-specified device (plDev).
■Description
• This function writes data to a device, which is specified to the randomly selected device (plDev), of a module specified to
the network number (lNetNo) and the station number (lStNo).
• The data to be written is stored to the write data storage destination (psBuf) in word units. A bit device and a word device
are stored per 1 point, and a double-word device is stored in word units.
• Specify so that the total number of write points specified for each block is 10240 points or less. Otherwise, a size error (-5)
occurs.
• Note that the extension comment information will be deleted when the data is written to the block to which an extension
comment is assigned (extension file register).
• Also, note that sub 2 or sub 3 program will be deleted when data is written to a block (extension file register) overlapping
with the program setting area for sub 2 or sub 3.
• When '0' is specified to the label code (ullLbCode), the device is written without checking the label code.
Description
Specify the path of the channel.
Specify the network number of target module.
Page 9 Argument specification
Specify the station number of target module.
Page 9 Argument specification
Specify the number of blocks, device type, start device number, and device points of
devices to be written.
Specify the storage destination (address) of write data.
Reserve a continuous area for the write data storage destination.
Unused (Even if a value is specified, the operation is not affected.)
Specify the label code acquired with the mdGetLabelInfo function.
IN/OUT
IN
IN
IN
IN
IN
IN
IN
Block 1
Block 2

Block n
3 DETAILS OF FUNCTION
3.2 MELSEC Data Link Functions
3
163