Omron SYSMAC FH Series User Manual page 741

SetUserSubroutine
Register a user-defined function that has been defined in the external DDL file.
Format
SetUserSubroutine <subroutineIdent>, <dllFileName>, <functionName>
Parameter
Parameter
Data type
name
Character
<subroutineIdent>
string type
Character
<dllFileName>
string type
Character
<functionName>
string type
Return value
None.
Description
Registers the function that is defined in the specified DLL file by the <dllFileName> and has a specified
function name by the <functionName> parameter as the specified identification name by the
<subroutineIdent> parameter. If registered by this macro function, the user-defined functions can be called
using the Call function and specify the identification names.
In the <dllFileName> parameter, specify the file name without the file extension ".dll".
Normally use the SetUserSubroutine statement in the *MCRINIT subroutine and execute the subroutine to
perform this macro function, or execute this macro function before executing the Call function.
User-defined functions can only be registered by executing this the SetUserSubroutine function using the
macro customize function. Execute this command on all processing units, all scene control macros in all
scene, and all communications commands in all communications command macros that call and execute
user-defined functions.
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 in the <subroutineIdent> parameter or the
<functionName> parameter, a "String too long" error will occur.
If a character string of a file name (including the absolute path name) longer than 255 characters is specified
in the <dllFileName> parameter, a "String too long" error will occur.
If a registered user-defined function by this macro function has not been programmed with the supported
interfaces, an error will not occur. In this case, an error will occur at the execution of the user-defined function
processing with this Call function.
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.
Vision System FH/FZ5 Series
User's Manual (Z340)
Identification name to the user-defined function to be registered
DLL file name
User-defined function name to be registered
WWW.NNC.IR
Description
8
739
Macro Reference