RENAMEUNCONDITIONAL


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

Start of change RENAMEUNCONDITIONAL specifies that the data set should be restored with the new name, whether or not the data set exists on DASD with the old name. If the data set exists on the volume with the new name, it is not restored. RENAMEUNCONDITIONAL is not supported for VSAM Alternate Index (AIX) data sets during a physical data set restore. This keyword only applies to movable data sets; therefore, unmovable data sets will not be renamed. If the old name filter matches and there is an error in the new name filter, the data set is not restored. End of change

Note:

RENAME and RENAMEUNCONDITIONAL are mutually exclusive; you cannot specify these keywords together. RENAMEUNCONDITIONAL is not supported for physical restore of VSAM data sets, and, if specified, the data sets will not be restored.
RENAMEUNCONDITIONAL specifies that the data set must be restored 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 REPLACEUNCONDITIONAL is not specified, an error message is issued and the data set is not restored.
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 is performed and replace processing is not performed. If a preallocated target data set exists with the new name as chosen by the rename criteria, then the restore 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.

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 if the data set name matches the corresponding old name filtering criterion.

For more information about the use of the RENAME keyword, see Special considerations for RESTORE .

For syntax rules, see the discussion of pfx, on, and nn under RENAME.