1.2.9.7 The COPY statement

The COPY statement copies either a single parameter or the complete setting from one device to another

copy-statement.gif

The syntax of the COPY statement looks much like the SET statement: Following the COPY keyword, you specify the destination and the source to be copied, separated by = character. Both, the destination definition and the value to be sent, may either be quoted string or local variables of this driver.

Quotes strings specify the device names or parameter IDs literally, when specifying variable names, the contents of the variable at execution time is used. Please note that it not possible to copy a complete device setup to a singel variable and vice versa. If the source is specified as a plain device name, the destination must be plain device name as well.

When copying single parameters, a new message is sent to the destination ID with the actual value of the source parameter. No type checking or conversion is done, the value is copied as it is.

When copying a complete device setup, all settings of the source device are collected to an unnamed / temporary device preset. This preset is applied to the destination device. Hence, all parameters the source device stores in presets are copied to the destination.