Specify whether to keep or delete a new data set, z/OS® UNIX file, or z/OS UNIX named pipe when an FTP file transfer ends prematurely.
- Server
- This setting applies when writing new files, named pipes, or data sets on the server system (for example, with a PUT subcommand).
- Client
- This setting applies when writing new files, named pipes, or data sets on the client system (for example, with a GET subcommand).
Syntax
.-CONDDISP CATLG-------. >>-+----------------------+------------------------------------>< '-CONDDISP--+-CATLG--+-' '-DELETE-'
Parameters
- CATLG
- Specifies that new data sets, z/OS UNIX files, and z/OS UNIX named pipes are kept when an FTP file transfer ends prematurely. For MVS™ data set transfers, the data set is also cataloged. This is the default.
- DELETE
- Specifies that new data sets, z/OS UNIX files, and z/OS UNIX named pipes are deleted when a file transfer ends prematurely.
Examples
Specify that a new data set, z/OS UNIX file,
or named pipe is deleted when a file transfer ends prematurely:
CONDDISP DELETERules:
- DELETE is ignored if the file transfer ended prematurely because FTP was stopped.
- DELETE is ignored if a checkpoint marker is received.
- If you are running a job scheduling program that detects files
as they are cataloged and then schedules a subsequent job for processing,
the job scheduler must take into account that setting CONDDISP=DELETE
causes FTP to delete and uncatalog the data set when the file transfer
fails. For generation data groups, the following situations might
occur:
- FTP intends to create a new GDG(+1) and generates GDG.G00023V00.
- The transfer of this data set fails, and the GDG.G00023V00 data set is deleted and uncataloged.
- A follow-on reference for the current GDG, for example, GDG(0), would cause the data set GDG.G00022V00 to be accessed and old data to be processed.
- If you are transferring a physical sequential data set with the MVSGet or MVSPut subcommand, the data set that is created is disposed according to the CONDDISP configuration if the transfer ends prematurely. However, if you are transferring a PDS or library data set, the data set that is created is deleted regardless of the CONDDISP configuration if the transfer ends prematurely.