Parameters

HOST var-name

An ISPF variable that contains the name of the host file that is to be transferred. The name can be a path name for a z/OS® UNIX regular file.

WS var-name

An ISPF variable that contains the name of the workstation file that is to be transferred.

TO (host or ws)

An ISPF variable that tells where the file will be created upon the completion of the transfer.

if TO HOST is specified:
- in binary mode—data sets with fixed-length records are padded with null characters if needed to fill the final record of the data set. Data sets with variable-length records are not padded.
- in text mode—for Windows systems, a Carriage-Return/Line-Feed combination indicates the end of a line. An end-of-file character that is the last character in the file is not transmitted to the host. End-of-file characters at other locations in the file are transmitted to the host along with the data following the end-of-file character.
  For AIX® and HP-UX, a Line-Feed character is considered the end of a line.
  
  If a line is longer than the record length of the data set the line is split into as many records as are needed to hold the line.
  
  For data sets with fixed-length records lines are padded with blanks to reach the record length.
if TO WS is specified:
- in binary mode—all data from each record in the host data set is concatenated to form the workstation file.
- in text mode—blanks after the last nonblank character are trimmed form each record. Records consisting entirely of blanks are sent as a line with a single blank character. Zero-length records from a data set with variable-length records are not transferred to the workstation, and can cause an error condition to occur.

If a data set containing end-of-line characters is transferred to the workstation and back to the host, the end-of-line characters are removed and the line is split at the location of the end-of-line characters. For Windows systems, an end-of-file character at the end of the data set is also removed when the data set is transferred to the workstation and back to the host.

volume

An ISPF volume number for the location of the 'TO' file. Used only when working with uncataloged data sets.

BINARY

Specifies that no ASCII/EBCDIC character translation should take place.

TEXT

Specifies that ASCII/EBCDIC translation should take place.

buffer

Specifies a buffer containing the name of the service and its parameters in the same form as they would appear in an ISPEXEC call for a command procedure.

STATS

Specifies that ISPF statistics will be generated or maintained by incrementing the mod level and setting the last changed time to the time when the member is uploaded. This is the default.

NOSTATS

Specifies that ISPF statistics will not be generated or maintained when the member is uploaded.

buf-len

Specifies a fullword fixed binary integer containing the length of "buffer".

CHKDATE

YES: On download, check the date and time of the source file and the target file. If they are different, perform the file transfer and update the date and time of the target file to match those of the source file. If they are the same, do not perform the file transfer, and set the return code to 2.
If the source file you are downloading from the host to the PC does not have an entry in the date and time statistics, the current date is set on the host file at the time of the file transfer.
NO: Transfer the files regardless of dates and times.

SETDATE

YES: On upload, set the date and time of the host file to be the same as the workstation file.
SCLM: On upload, set the date and time of the host file to be the same as the workstation file. In addition to this, set the SCLM bit on.
NO: On upload, use the system data and time for the host files.

MAKEPATH

YES: On transfer to the workstation, create the necessary subdirectories to store the file transferred. This parameter is ignored on a transfer to the host.
NO: On transfer to the workstation, do not create any subdirectories to store the file transferred. This parameter is ignored on a transfer to the host. NO is the default for this parameter.