Use FileUpload to create a copy of a workstation file in a Host directory.
FileUpload differs from the FileCopy command in that it assumes the SRC operand is a workstation file and that the DEST operand is a Host file. It also provides for a default for the DEST file name such that quite often DEST is not speciied.
FileUpload may also be entered as FileUpl[oad] or Upl[oad].
Optional Operands
SRC is an already existing workstation file.
Default: last referenced file. The operation is rejected if last referenced file is not a workstation file.
DEST is the Host file to be created (currently only BIM file support is provided). A file of this name must not already exist.
Default: The file will be created in the currently attached Host directory with a name formed by stripping the workstation file extension. The file type will be set based upon the workstation file extension and 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 If DEST is a PROC type VSE file, specifies whether it contains SYSIPT data. Can be "YES" or "NO".
Default: NO.
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.
FileUpload 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
FileUpload sets the TXM variables to the attributes of DEST.
Examples
Create a host copy of workstation file SYREXIO.ASM:
=> upl syrexio.asm