SRestart subcommand—Restart a stream data transfer
Purpose
Use the SRestart subcommand to restart an interrupted stream mode data transfer.
Format
Parameters
- Get
- Resume a subcommand.
- foreign_file
- Specifies the name of the file to be retrieved from the remote host.
- local_file
- Specifies the name of the local file created as a result of the
Get subcommand.
Enter the same names for foreign_file and local_file as you used in the interrupted subcommand.
You can override the usage of the current local working directory in the local file name by specifying local_file as a complete data set name enclosed in single quotation marks (’). If local_file is not specified, the local_file name is the same as the foreign_file name.
- PUt
- Resume a put subcommand.
- local_file
- Specifies the name of the file on your local host being sent to the remote host.
- foreign_file
- Specifies the name that the delivered file is given on the remote
host. If the foreign_file name is not specified,
the foreign_file name is the same as the local_file name.
Enter the same names for foreign_file and local_file as you used in the interrupted put subcommand.
You can override the usage of the current local working directory in the local file name by specifying local_file as a complete data set name enclosed in single quotation marks (’). If local_file is not specified, the local_file name is the same as the foreign_file name.
Usage
- Do not use SRestart to resume an interrupted file transfer unless you can create the start options again, FTP.DATA statements, SIte, and LOCSIte options in effect at the time of the failed file transfer. Unpredictable results can occur if the file transfer environment cannot be created again. If you cannot create the file transfer environment again, issue Get or PUt to transfer the file again.
- Not all file transfers can be resumed in STREam mode. Observe
these restrictions during the original file transfer as well as the
SRestart transfer.
- Mode must be STREam.
- Filetype must be SEQ.
- Unixfiletype must be FILE.
- Structure must be FILE.
- SUnique option must be disabled.
- Data type must be ASCII, EBCDIC, or Image.
- SITE and LOCSITE ENcoding must be SBCS (SRestart does not support DBCS or MBCS ENcoding).
- The session cannot be protected with an active security mechanism (such as TLS or Kerberos).
- For SRestart PUt, LOCSITE SBSENDEOL=CRLF must be set. If the original transfer used a setting other than CRLF, the transfer cannot be restarted. Using a setting other than CRLF will cause the SRestart to fail. Setting SBSENDEOL to CRLF when the original transfer used a different setting will corrupt the remote file.
- For SRestart Get, SITE SBSENDEOL=CRLF must be set. If the original transfer used a setting other than CRLF, the transfer cannot be restarted. Using a setting other than CRLF will cause the SRestart to fail. Setting SBSENDEOL to CRLF when the original transfer used a different setting will corrupt the local file.
- The local file must reside in the z/OS® UNIX file system as a regular file.
- For SRestart PUt, a server that is z/OS Communications Server V1R2 or later rejects the restart if the foreign_file value is not a z/OS UNIX file system regular file.
- For SRestart PUt, if the server cannot calculate an appropriate point to restart the file transfer, SRestart will fail.
- For SRestart Get, if the client cannot calculate an appropriate point to restart the file transfer, SRestart will fail.
- If SRestart fails, use Get or PUt and restart the file transfer.
Context
- See SUnique subcommand—Changes the storage method for information about changing the storage method on the remote host.
- See STRucture subcommand—Set the file structure for more information.
- See LOCSIte subcommand—Specify site information to the local host for a description of the SBSENDEOL and ENcoding parameters.