Mitsubishi Electric MELSEC iQ-R Series Manual page 89

■ Description
• This function reads labels of a CPU module specified to the network number (lNetNo), the start I/O number (lIoNo), the
station number (lStNo), and the CPU number (sCPU).
• Reserve the area for the label name array (plDevLst) in the call source.
• Reserve the area for (lLbCnt  3 + 1) for the size of area of the device name array (plDevLst).
• If any of the labels of which the label information cannot be acquired exists in the label name specified to the label name
array (pLbLst), this function returns any of the following errors. For the device type, start device number and number of read
points of the label, '0' is stored.
Error number Occurrence condition
-82(FFB2H) A non-existent label was specified.
Devices assigned to labels do not support random read/write.
The specification method for devices assigned to labels is incorrect. (Devices are index-modified or indirectly specified.)
-84(FFB4H) The specification method for devices assigned to labels is incorrect. (Devices are bit-specified or digit-specified.)
• The error response is returned in order of detection.
If two labels (Label1: non-existent label name, Label2: incorrect device specification method by digit specification) are
specified, only the first detected Label1 error (-82) is returned.
• Even if the mdrGetLabelInfo function returns the error (-82 or -84), the value is stored in the device name array (plDevLst)
for the label that acquired device information successfully.
• The specification method of the label name to specify to the label name array (pLbLst) is as follows:
: Possible, : Impossible
Label type
Label of the simple data type
Element specification of the array
label
Whole specification of the
structure label
Member of the structure label
Array member of the structure
label
Bit specification of label
Digit specification of label
Label of timer type, retentive timer
type, and counter type
Precautions
• In CW Workbench, Unicode character strings cannot be entered and source codes including Unicode character strings
cannot be compiled. Create a file with Unicode (UTF-16) character strings entered in an application (such as Notepad) of
Windows.
• When a device is specified such as the bit specification of word device or the digit specification of label, the device
information cannot be acquired.
• When a label to which a device is not assigned is specified, DevGV is stored in the device type.
• DevGV can be specified only with the functions supporting label access (mdrRandRLabel/mdrRandWLabel).
• For accessible CPU modules, refer to the following manual.
MELSEC iQ-R C Intelligent Function Module User's Manual (Application)
Specificatio Specification method
n possibility
 Specify the label name.

Specify in the following format.
• One-dimensional array: Label name [ m ]
• Two-dimensional array: Label name [ m, n ]
• Three-dimensional array: Label name [ m, n, l ]
 

Specify in the following format.
Label name.Element name. to Element name
 Specify in the following format.
Label name.Element name [ m ]
 
 

Specify in the following format.
• Contact: Label name.S
• Coil: Label name.C
• Current value: Label name.N
Specification example
Label1
• One-dimensional array: Label1 [ 10 ]
• Two-dimensional array: Label2 [ 10, 20 ]
• Three-dimensional array: Label3 [ 10, 20, 30 ]

Str1.Elem1. to Elem3
Str1.Elem[ 10 ]


• Contact: Label1.S
• Coil: Label2.C
• Current value: Label3.N
3 DETAILS OF FUNCTION
3.2 MELSEC iQ-R Series Data Link Functions
3
87