STD.File.DeSpray( logicalname, destinationIP , destinationpath , [ timeout ] , [ espserverIPport ] , [ maxConnections ] , [ allowoverwrite ],[ destinationPlane ])
dfuwuid := STD.File.fDeSpray( logicalname, destinationIP , destinationpath , [ timeout ] , [ espserverIPport ] , [ maxConnections ] , [ allowoverwrite ],[ destinationPlane ])
| logicalname | A null-terminated string containing the logical name of the file. |
| destinationIP | A null-terminated string containing the destination IP address of the file. Deprecated, you should use destinationPlane instead. |
| destinationpath | A null-terminated string containing the path and name of the file. |
| 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. This should almost always be omitted, which then defaults to the value contained in the lib_system.ws_fs_server attribute. When not omitted, it should be 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. |
| maxConnections | Optional. An integer specifying the maximum number of connections. If omitted, the default is -1, which indicates the system chooses a suitable default based on the size of the cluster. |
| 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. |
| destinationPlane | Optional. The destination storage plane. Note: destinationPlane should not be used at the same time as destinationIP. In a containerized deployment, destinationPlane is required if you have more than one Landing Zone. |
| dfuwuid | The attribute name to receive the null-terminated string containing the DFU workunit ID (DFUWUID) generated for the job. |
| Return: | fDeSpray returns a null-terminated string containing the DFU workunit ID (DFUWUID). |
The DeSpray function takes a logical file and desprays it (combines all parts on each supercomputer node into a single physical file) to the landing zone.
Example:
STD.File.DeSpray('OUT::MyFile',
'10.150.50.14',
'c:\\OutputData\\MyFile.txt',
-1,
'http://10.150.50.12:8010/FileSpray');