Explanation
Processing on the Catalog Information data set has completed. op on a pre V1R11 system will be CAPTURE. It is the operation that was being performed on data set dsn. The copy pool name cpname, rc and rsn are the results of the operation.
- CAPTURE
- catalog information capture to the catalog information data set dsn for copy pool cpname.
- SCAN
- find a data set entry within catalog information data dsn for copy pool cpname during an FRRECOV request.
- AUDIT-CP
- confirm that catalog information data set dsn corresponds to copy pool cpname.
- GETINFO
- retrieve copy pool information from catalog information data set dsn.
- LIST
- list all data set entries contained in catalog information data set dsn for copy pool cpname.
- FREEVOL
- move catalog information data set dsn to another ML1 volume. The copy pool name cpname is not available for this operation.
- DELETE
- delete catalog information data set dsn for copy pool cpname.
- CLEANUP
- perform error recovery cleanup as a result of an ABEND while catalog information data set dsn was being processed for copy pool cpname.
If the operation, catalog information data set name, or copy pool name is not available at the time this message is issued, the message indicates “***” in the undetermined field.
The operation has failed with a return code of rc and reason code rsn.
- 4
- Operation completed with a warning. PREFERRED was specified for
the catalog capture and a partial catalog capture has occurred. A partial catalog capture can occur if the catalog
information data set is full. The following reason codes explain the
warning:
- 0
- During an FRRECOV operation of a data set, the data set entry was not found in the catalog information data set.
- 5
- There was an error closing the catalog information data set. For OPERATION=CAPTURED, the copy pool definition indicates that catalog information capture is PREFERRED. Partial information might have been captured.
- 12
During an FRBACKUP operation the catalog capture
function ended early because of an error calling the Catalog Search
Interface. A partial catalog information capture might be available.
Because mature or highly utilized catalogs often contain logical errors,
capturing catalog information from a catalog with errors would fail
and cause the catalog search interface to return an error.
- 16
- During an FRBACKUP operation, the catalog capture function ended early because of an error in writing to the catalog information data set. A partial catalog capture may be available.
- 18
- The catalog information was detected to be incomplete. Data returned might be incomplete.
- 20
- Catalog information data set processing is not supported on pre-V1R11 systems. For this return code and reason code, the SMS copy pool setting "CAPTURE CATALOG INFORMATION DATA SETS" is set to "PREFERRED" so DFSMShsm allows the backup to continue without capturing catalog information. If catalog capture is needed, please issue the FRB command from a V1R11 or later system.
- 8
- Operation failed. The following reason codes explain the failure:
- 1
- The catalog information data set was not found.
- 2
- There was an error allocating an existing catalog information data set.
- 3
- There was an error opening the catalog information data set.
- 4
- There was an error reading the catalog information data set.
- 5
- There was an error closing the catalog information data set.
- 6
- There was an error freeing the catalog information data set.
- 7
- There was an error selecting an ML1 volume on which to allocate a new catalog information data set. This has possibly been caused due to there not being enough space on the ML1 volume.
- 8
- There was an error allocating a new catalog information data set. This has possibly been caused due to no ML1 volume being defined.
- 9
- There was an error cataloging the catalog information data set.
- 10
- There was an error uncataloging the catalog information data set.
- 11
- There was an error scratching the catalog information data set.
- 12
- There was a Catalog Search Interface error.
- 13
- There was a locating error.
- 14
- A unique name could not be determined for the catalog information data set.
- 15
- There was an error obtaining the MVT for the catalog information data set.
- 16
- There was an error writing to the catalog information data set.
- 17
- The copy pool name in the catalog information data set does not match the copy pool name being processed.
- 24
- The data set type requested to be recovered from a Fast Replication backup is not supported.
- 52
- A getmain or freemain error was encountered during catalog information data set processing.
System action
The operation ends. DFSMShsm processing continues.
Programmer response
If this operation completes with a nonzero return code, investigate the root cause of the error. Check for other messages that might have been issued during this operation.
For reason codes 5 or 16, the root cause might be limited ML1 space or small primary, or second allocation quantities, or both. Check for occurrences of ABEND X'37' during this function.
For ML1 space problems, you can increase ML1 space.
For small allocation quantities, you can patch FRGCB_CATDS_PRIMARY and FRGCB_CATDS_SECONDARY fields as described in the Tuning DFSMShsm section in the z/OS DFSMShsm Implementation and Customization Guide.
For return code 8 reason 7, there might not be eligible ML1 volumes for selection. Ensure that there are ML1 volumes defined, and there is enough free space for a catalog information data set.
For return code 8 reason 15, the catalog information data set might exist on a volume that is no longer defined to DFSMShsm as an ML1 volume. Ensure that the volume containing the data set is defined to DFSMShsm as an ML1 volume.
For reason
code 12, all catalog errors must be corrected to allow catalog information
capture to succeed. You can use IDCAMS commands LISTCAT ALL CATALOG(catname)
and DIAGNOSE to help determine the errors. See z/OS DFSMS Managing Catalogs and z/OS DFSMS Access Method Services Commands for
more information.
For other errors, search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM® Support Center.
RC4 - RSN20
The catalog information data set was not captured. The FRBACKUP command was issued from a pre-V1R11 system. The SMS copy pool setting, CAPTURE CATALOG INFORMATION DATA SETS, is set to preferred. The backup continues.
Source
DFSMShsm