Mitsubishi Electric MELSEC iQ-R C Series Programming Manual page 197

Description
• This function reads labels of a CPU module specified to the network number (lNetNo) and the station number (lStNo).
• Reserve the area for the device 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 the number of
read points of the label, '0' is stored.
Error code Error occurrence
-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.
-84 (FFB4H) The specification method for devices assigned to labels is incorrect.
• 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 an error of Label1 (the first detected label) (-82) is returned.
• Even if the mdGetLabelInfo 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 for the label name to specify to the device 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 (mdRandRLabelEx/mdRandWLabelEx).
• For accessible CPU modules, refer to the following:
MELSEC iQ-R C Controller Module User's Manual
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.3 MELSEC Data Link Functions
3
195