RENAMEUNCONDITIONAL


>>-+----------------------------------------------------------+-><
   '-+-RENAMEUnconditional-+--+-(pfx)-----------------------+-'   
     '-RENUNC--------------'  |    .-,-----------.          |     
                              |    V             |          |     
                              +-(----(--on,nn--)-+--)-------+     
                              |          .-,-----------.    |     
                              |          V             |    |     
                              '-((pfx),----(--on,nn--)-+--)-'

RENAMEUNCONDITIONAL specifies that the data set must be copied with the new name, regardless of whether the data set exists on DASD with the old name. If the data set exists on the target volume with the new name and the REPLACEUNCONDITIONAL keyword is not specified, an error message is issued, and the data set is not copied.

pfx: Specifies the prefix used to replace the first-level qualifier of the data set name. It is optional, but if specified, must be the first parameter in the list of subkeywords. The prefix is used only if the (on,nn) parameters are not specified or the old name filters do not match the data set name.
on: Specifies the old name to be used as a filtering criterion to check if it matches the data set name.
nn: Specifies the new name to be used to derive the new data set name when the data set name matches the corresponding old name filtering criterion.

The syntax rules for pfx (prefix), on (old name), and nn (new name) are the same as in the RENAME keyword in a restore operation.

Note:

If the RENAMEU keyword is specified in conjunction with the REPLACE keyword, only one of the keywords take effect for any particular data set. The RENAMEU keyword takes precedence over the REPLACE keyword. If a source data set name matches the RENAMEU criteria, then rename processing will be performed and replace processing will not be performed. If a preallocated target data set exists with the new name as chosen by the rename criteria, then the copy fails even if the REPLACE keyword was specified. If you want to replace a preallocated target with the new name, specify the REPLACEUNCONDITIONAL keyword. If a source data set name does not match the rename criteria and a preallocated target data set with the source name exists, the preallocated target data set is replaced.
If CICSVRBACKUP is also specified, DFSMSdss uses the CICSVR-generated new name instead of the new name that you specified. See CICSVRBACKUP for more information.
You can have up to 255 entries using RENAMEUNCONDITIONAL. You cannot go beyond this limit by trying to use FILTERDD. FILTERDD can not be used with RENAMEUNCONDITIONAL.
RENAMEUNCONDITIONAL is not supported for VSAM Alternate Index (AIX) data sets during a physical data set restore.

For more information about renaming, see RENAME.