Omron SYSMAC FH Series

WWW.NNC.IR
Macro Reference
681
8
Appendices
Vision System FH/FZ5 Series
User’s Manual (Z340)
SaveUnitData
Saves a processing unit.
Format
SaveUnitData <sceneNo>, <unitNo>, <unitCount>, <fileName>
Parameter
Return value
None.
Description
Saves processing unit data in the file with the file name specified in the <fileName> parameter from
processing units whose processing unit numbers are specified in the <unitNo> parameter, with the number of
processing units specified in the <unitCount> parameter, of the scene number specified in the <sceneNo>
parameter.
When -1 is specified in the <sceneNo> parameter, the scene number of the current scene is specified in the
scene number of the scene to be saved.
If -1 is specified in the <unitCount> parameter, all processing unit data included in the processing unit data file
is saved.
In the <fileName> parameter, use an absolute path to specify the file name of the file to be saved.
Specify the file extension ".unt" in the file name specified in the <fileName> parameter.
If the file specified in the <fileName> parameter already exists, it is overwritten.
If an incorrect data type is specified for a parameter, a "Type mismatch" error will occur.
If a non-existent number, numerical value, or combination of data types or values is specified for a parameter,
an "Illegal function call" error will occur.
If a character string longer than 255 characters is specified for a character string parameter, a "String too
long" error will occur.
If the format is written incorrectly, such as writing the macro function name incorrectly, omitting a comma, or
omitting a half-width space, a "Syntax error" error will occur.
Usage Cautions
• Execute this macro function when the BUSY signal or other measurement in progress signal is ON and
measurement is prohibited. (Reference: XState Transitions and Execution Timing (p.227))
Parameter
name
Data type Description
<sceneNo> Integer type Scene number to save the scene (-1 to 127)
<unitNo> Integer type
Processing unit number to begin to save (0 to (the number of registered processing units
in the current scene minus one))
<unitCount> Integer type
Number of pieces of the processing unit to save (-1, 1 to (the number of registered
processing units in the current scene) - (the processing unit number to begin to save))
<fileName>
Character
string type
File name of the processing unit to save (*unt)