DFS3709A UNABLE TO OBTAIN AUTHORIZATION FOR DATA BASE dbname AREA areaname. REASON CODE=nn

Explanation

The IMS online subsystem failed to acquire the database usage authorization through DBRC during the DEDB area open time. The following list indicates the explanation and action for each reason code (nn):

Codes
Explanation
For nn=01
The requested authorization and current authorization are incompatible. If you are trying to use data sharing, some possible causes of this error are:
  • The DBRC database SHARELVL might be invalid.
  • The database access intent among subsystems is conflicting.
  • IRLM are incorrectly connected to one another and to IMS.

System action: The named area is stopped for the online subsystem, and the status code 'FH' is returned to the application programs.

Programmer response: One of the following responses should be made:
  1. Close the area in the other subsystems holding the incompatible database authorization by entering a /STOP or /DBR command, and restart the area by entering a /START command in this subsystem.
  2. Wait until the other subsystems close the area, and restart the area by entering a /START command in this subsystem.
For nn=02
The database is not registered in the RECON data set.
For nn=03
The DEDB or area status prohibits further authorization in the DBRC RECON data set because of a global /DBR, /STOP command or because of an internal database or area stop command.

System action: The named area is stopped for the online subsystem, and the status code 'FH' is returned to the application programs.

Programmer response: The following responses should be made:
  1. Analyze the reason for the status that prohibits further authorization, and take the required action if necessary.
  2. Reset the authorization status for the database or area by using the DBRC command, CHANGE.DB, or DBDS, and restart the area by entering a /START command in this subsystem.
For nn=05
The area is marked as needing an image copy in the DBRC RECON data set.

System action: The named area is stopped for the online subsystem, and the status code 'FH' is returned to the application programs.

Programmer response: Run the Database Image Copy utility, DFSUDMP0, for the named area, and restart the area by using the /START command after the utility has run successfully.

For nn=06
The area is marked as needing recovery in the DBRC RECON data set, or there are no area data sets in AVAIL status for the area.

System action: The named area is stopped for the online subsystem, and the status code 'FH' is returned to the application programs.

Programmer response: Run the Database Recovery utility, DFSURDB0, for the named area, and restart the area by using the /START command after the utility has run successfully.

For nn=08
The requesting online subsystem is not authorized to share the named area with other subsystems.

System action: The named area is stopped for the online subsystem, and the status code 'FH' is returned to the application programs.

Programmer response: One of the following responses should be taken:
  1. If an environment with inter-system data sharing and two IRLMs is required, change the SHARELVL from 2 to 3 by using the DBRC CHANGE.DB command for the named database and restart the area by using the /START command.
  2. If an environment with intrasystem data sharing and a single IRLM is required, run the online subsystem under the host processor authorized for the named area.
For nn=09
The DBRC RECON data set indicates that the named area has been previously authorized in one or more online subsystems. Because the exit verification indicates that the subsystems are inactive, the named area cannot be authorized.

System action: The named area is stopped for the online subsystem, and the status code 'FH' is returned to the application programs.

Programmer response: Wait until another online subsystem ends restart processing and closes the area, and then restart the area by using the /START command in the subsystem.

If the area was involved in data sharing with more than one IRLM, the IRLMs must be reconnected.

For nn=10
The area was previously authorized to the subsystem.

System action: The named area is stopped for the online subsystem, and the status code 'FH' is returned to the application programs.

Programmer response: Close the area holding the incompatible database authorization by entering a /STOP or /DBR command; then restart the area by entering a /START command.

For nn=11
An invalid parameter was found in the database usage compatibility evaluation process. Probably, the database/area record in the DBRC RECON data set is corrupted.

System action: The named area is stopped for the online subsystem, and the status code 'FH' is returned to the application programs.

Programmer response: This condition is unlikely. Correct the problem associated with DBRC, and contact IBM® Software Support for further assistance.

For nn=18
The DBRC RECON data set indicates that the named area has "Alter Count" set.
The named area cannot be authorized either a DEDB Alter for the area is currently in progress or the master IMS which the previous DEDB Alter utility for the named area ran under has been abnormally terminated and has not yet been restarted.

System action: The named area is stopped for the online system, and the status code "FH" is returned to the application.

Programmer response: If the DEDB Alter utility is currently in progress, wait until the utility finishes and retry. If the DEDB Alter utility is not currently in progress, restart the master IMS so that the RECON status will be cleaned when processing restarts, or use the following DBRC commands:
  • CHANGE.DB with NOALTER to reset "Alter" status.
  • CHANGE.DBDS with NODBQUI to reset "Quiesce" status.
For nn=20
The named database or area is not registered with DBRC, and the FORCER option is specified in the DBRC RECON data set record.

System action: The named area is stopped for the online subsystem, and the status code 'FH' is returned to the application programs.

Programmer response: Register the named area and area data sets with DBRC using the INIT.DBDS and INIT.ADS commands, and restart the named area by using the /START command in this subsystem.

For nn=22
The database or area is currently authorized to another subsystem.

System action: Authorization for the requested activity is denied.

Programmer response: You must issue a /DBR command for the database or area for all IMS subsystems at that site before trying the action again.

For nn=41
The area is quiesced or in the process of being quiesced.

System action: Authorization for the requested activity is denied.

Programmer response: Wait for the quiesce to end and rerun the job which failed authorization. The status of the area can be determined by issuing the /DISPLAY AREA QSC, the QUERY AREA command, or LIST.DBDS DBD(dbname) AREA(areaname) and examining the output.

For nn=42
The area is not quiesce held and image copy is attempting authorization.

System action: Authorization for the requested activity is denied.

Programmer response: Wait for the quiesce to end and rerun the job which failed authorization. The status of the area can be determined by issuing the /DISPLAY AREA QSC command, the QUERY AREA command, or LIST.DBDS DBD(dbname) AREA(areaname) and examining the output.

If the image copy failed, wait for the quiesce to end or until the QUIESCE HELD flag is set on. You can set the QUIESCE HELD flag on using the UPD START(QUIESCE) OPTION(HOLD) command processing when quiesce has occurred.

For nn=43
The DBRC RECON data set indicates that the named area has a randomizer name that is different from the ACBLIB randomizer name that was passed in the ACBSHR=N environment. The named area cannot be authorized because the randomizer names are different.

System action: The named area is stopped for the online system, and the status code "FH" is returned to the application.

Programmer response: Update the ACB library to reflect the DEDB ACB member change by using local online change, member online change, or global online change.