toLocalTmpFile

You use toLocalTmpFile to specify a temporary target file for file transfer from "remote" to "remote" (see “Types of file transfer” (transferFile)).

The temporary file is simply a buffer under the local ID. The file is assigned to a file object with the specified ID. This file object is displayed in the parent context of the current ttransferFile element and must not already exist there.

The file is given an internal name. The suffix of the file is determined from the suffix of the associated fromRemoteFile. If this does not have a suffix then the generated temporary file also has no suffix. This file is stored in user memory. If the memory space for the user is restricted (Disk Quota) then the limit may be exceeded when temporary files are created. The transferFile activity is cancelled with the error code ft_err_LOCERR_MEM.

The file object inherits the data, MaxRecSize, recordFormat, ccsname and autoDataSpec specifications in the associated fromRemoteFile activity. These are then re-used when the ffromLocalTmpFile activity is called (see section “fromLocalTmpFile”).

The temporary file is deleted automatically as soon as the context in which the file object was defined is exited.

See also section “file”.

Restrictions

1. You can only access the generated temporary file with use="tmpID" from a fromLocalT-mpFile.

2. The transferFile fromRemoteFile activity must be concluded before you use transferFile toRemoteFile to access the temporary file. You should therefore perform these activities sequentially or, if appropriate, embed them in a <sequence>.

Format

<toLocalTmpFile id="tmpID"/>

Attributes

Name	Value	Meaning
id	string	ID of the temporary file in transferFile elements associated with the parent context. You can only access this ID with use="tmpID" from a fromLocalTmpFile.

Example

See example in section “fromLocalTmpFile”.