RDISP={SHR | OLD | DNEW | MOD | NEW | NEWR | NEWA},{KEEP | CATL | DELETE},{KEEP | CATL | DELETE}

This parameter defines the disposition of the data set on the remote platform server system. This parameter is only supported on transfer requests to other z/OS systems. The parameter is divided into three parameters.

The following table lists the data set status options:

SHR Requests shared access to the data set.
OLD Requests exclusive access to the data set.
DNEW Deletes the file if it already exists, then re-creates the file; creates the file if the file does not exist.
MOD Appends data to the end of the data set.
NEW Creates data set. If the data set already exists, returns error.
NEWR Creates data set. If the data set already exists, replaces the data set.
NEWA Creates data set. If the data set already exists, appends data to the end of the data set.

The following table lists the normal deposition options:

KEEP Keeps the data set after the transfer is completed successfully. If a data set is created, do not catalog the data set.
Note: Use this option with great care.
CATL If a data set is created, catalogs the data set. If a data set is not created, keeps the data set.
DELETE Deletes the data set after the transfer is completed successfully.

The following table lists the error deposition options:

KEEP Keeps the data set after the transfer is completed successfully. If a data set is created, do not catalog the data set.
Note: Use this option with great acre.
CATLG If a data set is created, catalogs the data set. If a data set is not created, keeps the data set.
DELETE Deletes the data set after the transfer is completed unsuccessfully.

The RDISP parameter works like the mainframe RDISP parameter.

The EFFECT parameter might override the RDISP and LDISP parameters. Whichever parameter defined last in the batch job takes precedence.

Note: In some conditions, the error disposition of DELETE cannot be processed. The data set deletion is performed in the Dynamic deallocation routine. If the data set is not allocated, the delete operation cannot be performed. For example, if a request fails because the data set is not available, the dynamic allocation fails; therefore, the data set cannot be deleted because it is not allocated. Another good example is if the request fails with a network error because the remote system is not available; obviously, the data set cannot be deleted, because communication with the remote system is not established.