Use FileDownload to create a copy of a Host file in a workstation directory.
FileDownload differs from the FileCopy command in that it assumes the SRC operand is a Host file and that the DEST operand is a workstation file. It also provides for a default for the DEST file name such that quite often DEST is not speciied.
FileDownload may also be entered as FileDownl[oad] or Downl[oad].
Optional Operands
SRC is an already existing Host file (currently only BIM file support is provided).
Default: last referenced file. The operation is rejected if last referenced file is not a Host file.
DEST is the workstation file to be created. A file of this name must not already exist.
Default: The file will be created in the currently attached workstation directory with a name formed by appending an extension to the host file name based upon the host file type. Host to extension correspondence is determined by the contents of control file DFNDWNL.CTL.
AUDIT specifes whether the audit trail is to be copied also. Specify "On" or "Y[es]" to copy the audit trail. Specify "Of[f]" or "N[o]" otherwise.
Default: Yes.
STAMP specifes whether stamps are to be copied also. Specify "On" or "Y[es]" to copy the stamps. Specify "Of[f]" or "N[o]" otherwise.
Default: Yes.
ORIGDATE specifies whether the SRC creation and update dates are to be used for the DEST file. Specify "On" or "Y[es]" to maintain original dates. Specify "Of[f]" or "N[o]" otherwise.
Default: No.
DATA This operand is ignored.
FMT specifies the format of the file being copied. This is relevant only when a a BIM file is being copied to the workstation. Specify "Text" if the file is simple text. Specify "Sysin" if the format is 80-character binary data (usually JCL mixed with assembler/compiler output). Otherwise, specify "Binary". (Note that a file that contains text and markup, e.g., a word processing file, would not be considered simple text. Hence, such a file should be specified as "Binary".) Text data will be translated between ASCII and EBCDIC. Sysin and binary data will never be translated.
Default: Text.
A copy of the source file will be created under the destination file name. Both the text and the file attributes are copied. The source file and its file attributes are unaffected by the operation.
If an asterisk (*) is entered as part of DEST, the asterisk is replaced with the SRC file name. This facilitates making a copy of a file to a suffixed or prefixed name without keying the file name twice.
FileDownload sets last referenced file to the DEST file.
When Valid
The user must have LIST access level for the SRC directory and DEF access level for the DEST directory.
Return Codes
OK Successful.
DP DEST file already exists.
NF One of the following:
SRC file not found.
DEST directory not found.
SC Inadequate access level.
Procedure Notes
FileDownload sets the TXM variables to the attributes of DEST.
Examples
Create a workstation copy of BIM-EDIT file SYREXIO:
=> downl syrexio