STD.File.Copy STD.File.Copy File.Copy Copy ( logicalname, destinationGroup , destinationLogicalname, [ ,scrDali ] [ ,timeout ] [ ,espserverIPport ] [ ,maxConnections ] [ ,allowoverwrite ] [ ,replicate ] [ ,asSuperfile ] ); dfuwuid := STD.File.fCopy STD.File.fCopy File.fCopy fCopy ( logicalname, destinationGroup , destinationLogicalname, [ ,scrDali ] [ ,timeout ] [ ,espserverIPport ] [ ,maxConnections ] [ ,allowoverwrite ] [ ,replicate ] [ ,asSuperfile ] ); logicalname A null-terminated string containing the logical name of the file. destinationGroup A null-terminated string containing the destination cluster for the file. destinationLogicalname A null-terminated string containing the new logical name of the file. srcDali Optional. A null-terminated string containing the IP and Port of the Dali containing the file to copy. If omitted, the default is an intra-Dali copy. timeout Optional. An integer value indicating the timeout setting. If omitted, the default is -1. If set to zero (0), execution control returns immediately to the ECL workunit without waiting for the DFU workunit to complete. espserverIPport Optional. A null-terminated string containing the protocol, IP, port, and directory, or the DNS equivalent, of the ESP server program. This is usually the same IP and port as ECL Watch, with “/FileSpray” appended. If omitted, the default is the value contained in the lib_system.ws_fs_server attribute. maxConnections Optional. An integer specifying the maximum number of connections. If omitted, the default is one (1). allowoverwrite Optional. A boolean TRUE or FALSE flag indicating whether to allow the new file to overwrite an existing file of the same name. If omitted, the default is FALSE. replicate Optional. A boolean TRUE or FALSE flag indicating whether to automatically replicate the new file. If omitted, the default is FALSE. asSuperfile Optional. A boolean TRUE or FALSE flag indicating whether to treat the file as a superfile. If omitted, the default is FALSE. If TRUE and the file to copy is a superfile, then the operation creates a superfile on the target, creating subfiles as needed while overwriting only those already existing subfiles whose content has changed. If FALSE and the file to copy is a superfile, then the operation consolidates all the superfile content into a single logical file on the target, not a superfile. dfuwuid The attribute name to recieve the null-terminated string containing the DFU workunit ID (DFUWUID) generated for the job. Return: fCopy returns a null-terminated string containing the DFU workunit ID (DFUWUID). The Copy function takes a logical file and copies it to another logical file. This may be done within the same cluster, or to another cluster, or to a cluster in a completely separate Dali. Example: STD.File.Copy('OUT::MyFile','400way','OUT::MyNewFile');