DFSMSdss: Lock or suspend user catalog data sets before performing a logical restore operation

Description

Beginning with V2R1, you must lock or suspend an existing user catalog data set that will be overwritten by a logical restore operation.

If the data set is not locked or suspended, DFSMSdss fails the logical restore operation with the following message:

ADR439E (001)-TDVSM(04), A PREALLOCATED DATA SET WAS FOUND 
FOR DATA SET UCAT.～ BUT WAS UNUSABLE, 144

Note: To use the BCSRECOVER parameter, you require READ access to the RACF FACILITY class profile IGG.CATLOCK. Otherwise, you will receive the following error message:

ADR497E (001)-CATLG(05), A CATALOG ERROR OCCURRED WHILE ALTERING ACCESS 
TO USER CATALOG UCAT.～. RETURN CODE IS 186, REASON CODE IS FT-002

Table 1 provides more details about this migration action. Use this information to plan your changes to the system.

Table 1. Information about this migration action
Element or feature:	DFSMSdss.
When change was introduced:	z/OS V2R1.
Applies to migration from:	z/OS V1R13.
Timing:	After the first IPL of z/OS V2R2.
Is the migration action required?	Yes, when an existing user catalog data set will be overwritten by a logical restore operation.
Target system hardware requirements:	None.
Target system software requirements:	None.
Other system (coexistence or fallback) requirements:	None.
Restrictions:	None.
System impacts:	None.
Related IBM® Health Checker for z/OS® check:	None.

Steps to take

Follow these steps:

Look for batch jobs that are designed to recover a catalog data set using the ADRDSSU utility.
If it does not perform an IDCAMS ALTER LOCK of the catalog data set prior to issuing the RESTORE command, modify the batch job to do one of the following:
- Enter a RESTORE command with the BCSRECOVER(LOCK | SUSPEND) parameter, which instructs DFSMSdss to lock or suspend the catalog
- Enter an IDCAMS ALTER command with the SUSPEND or LOCK parameter prior to entering the DFSMSdss RESTORE command
- Enter a MODIFY CATALOG with the RECOVER(LOCK | SUSPEND) parameter prior to entering the RESTORE command.
  For example:
```
F CATALOG,RECOVER,LOCK(ucat)
F CATALOG,RECOVER,SUSPEND(ucat)
```

Reference information

For more information about command syntax, see the following references:

For information about the RESTORE command, see z/OS DFSMSdss Storage Administration.
For more information about the ALTER command, see z/OS DFSMS Access Method Services Commands.
For information about the MODIFY CATALOG command, see z/OS DFSMS Managing Catalogs.