Precautions for Correct Use
Execution of this instruction is continued until processing is completed even if the value of Execute changes to
FALSE or the execution time exceeds the task period. The value of Done changes to TRUE when processing
is completed. Use this to confirm normal completion of processing.
Refer to Using this Section of the NJ/NX-series Instructions Reference Manual (Cat. No. W502) for a timing
chart for Execute, Done, Busy, and Error.
This instruction cannot be used on an event task. A compiling error will occur.
When the DB Connection Service was started in Test Mode, this instruction is completed normally without
connecting to the DB actually.
Refer to 1-2-1 DB Connection Service Specifications for the number of DB Map Variables for which you can
create a mapping. However, even if the number of DB Map Variables has not reached the upper limit, an
instruction error (Data Capacity Exceeded) will occur when any of the following conditions is met.
When the total number of members of structures used as data type of DB Map Variables in all DB
Connections exceeds 10,000 members
An error occurs for this instruction in the following cases. Error will be TRUE.
When the instruction was executed when the DB Connection Service was not running
When the instruction was executed while the initialization processing of the DB Connection Service
was in progress
When the instruction was executed while the DB Connection Service was stopped due to an error
When the instruction was executed after the DB Connection Service was shut down or while the DB
Connection Service was being shut down
When the value of the DBConnection input variable is invalid or the specified DB Connection is
already closed
When the TableName input variable is a text string consisting of NULL characters (16#00) only
When a space character is included in the text string specified for the TableName input variable.
When the data type of the variable specified in the MapVar input variable is not a structure
When a derivative data type is included as a member of the structure variable specified in the MapVar
input variable
When the DB Map Variable specified in the MapVar input variable is a structure array though INSERT
or UPDATE is specified for the SQL Type
When a value that is not defined as an enumerator was specified in the SQLType input variable
When the executed SQL statement resulted in an error in the DB
When the DB Connection Service cannot communicate with the DB due to a network failure or other
causes
When the maximum number of DB Map Variables for which a mapping can be created is exceeded
When more than 32 DB Connection Instructions were executed at the same time
Sample Programming
Refer to the sample programming that is provided for the DB_Update instruction.
NJ/NX-series Database Connection CPU Units User's Manual (W527)
Appendix A
A
A-13