DFS4261I UNABLE TO ADD TO rcvlist entrytype entryname: reason

Explanation

The entryname specified in the /RECOVER ADD command could not be added to the specified recovery list. If a recovery list was not specified in the /RECOVER ADD command, To rcvlist is not included in the message text.

If a duplicate entry was detected, the duplicate is ignored. The message destination is the z/OS® system console and the IMS master terminal (if this is a DB/DC IMS). This message is also sent to the issuer of the command.

In the message text:
rcvlist
The specified recovery list.
entrytype
If a member of a group is not part of the ACBGEN for the IMS processing the /RECOVER ADD command or is not defined in the RECON, entrytype is not included in the message.
entrytype is one of the following:
  • DBDS
  • AREA
  • DATABASE
  • GROUP (if DBDSGRP, CAGRP, DATAGROUP, or RECOVGRP was specified in the /RECOVER command)
entryname
A keyword specified on the /RECOVER ADD command and is one of the following: DB, DBDS, DBGRP, DBDSGRP, or CAGRP.
reason
The reason can be one of the following:
ALREADY ON RECOVERY LIST
The entry listed is already on the recovery list specified by rcvlist.
ALREADY STARTED
The recovery list specified by rcvlist already started recovery processing.
COMMAND TOO LONG
The number of elements specified on the /RECOVER ADD command is larger than that allowed by the recovery product for a single /RECOVER ADD command. Split the /RECOVER ADD command into multiple commands.
DATABASE IS OLR CAPABLE
The object specified by entryname is OLR capable and the /RECOVER ADD command was issued to a release of IMS that does not support recoveries with OLR capable databases. Rerun the recovery on a level of IMS that supports OLR capable databases.
DATABASE HAS NO DATA SETS
The database does not have any database data sets defined to it.
DATABASE IS DEFINED AS GSAM
The database recovery service cannot recover GSAM database types.
DLI/SAS REGION UNDETECTED
The /RECOVER ADD command attempted to add a full function DBDS to the recovery list on a system that does not have a DL/I SAS region.
FAST PATH NOT INSTALLED
The /RECOVER ADD command attempted to add a Fast Path AREA to the recovery list on a system that does not have FP installed.
INDEX OR ILE DATA SET
The DBDS has not been added to the recovery list because it is either a Primary index or ILDS data set and cannot be recovered. These data sets are recovered by the Index/ILDS Rebuild utility.
NOT DEFINED IN RECON
The entry specified by entryname is not defined for RECON.
NOT FOUND IN ACBGEN
The entry specified by entryname is not defined to the IMS issuing the message. It is possible that the entry is not defined in IMS Stage 1.
NOTHING ADDED
Nothing was added to the recovery list.
UNKNOWN REASON FROM DBRC
DBRC encountered an unexpected condition and returned an unknown reason code to the Database Recovery Manager.
INVALID SMSOPTS PARAMETER
An unsupported or incorrect SMSOPTS parameter is detected. Message DFS4289 follows this message. For more information, see DFS4289.

System action

The database data sets that make up the entryname are not added to the recovery list. The databases, areas, or both are not recovered by the database recovery service.

System programmer response

Examine the /RECOVER ADD command and compare it with the corresponding ACBGEN or RECON entries. Reissue the command with the correct entry names.

If reason is UNKNOWN REASON FROM DBRC, call IBM® Software Support for assistance.

Module

DFSRWCA0