DFS3710A UNABLE TO OBTAIN AUTHORIZATION IN UTILITY FOR DATA BASE=dbname AREA=areaname. REASON CODE=nn

Explanation

The nn value in the message indicates the reason for the authorization failure in the DEDB utility. The following list indicates the explanation and action for each nn code:

For nn=01

The requested state and the current authorization state are incompatible.

System action: The Fast Path utility being used is not invoked for this area.

Programmer response: One of the following actions should be taken:

• Close the area in other subsystems holding the database authorization by entering a /STOP or /DBR command.
• Wait until other IMS subsystems close the area, and rerun the job.

For nn=06

Either there is no available ADS, or the area is marked as needing recovery in the DBRC RECON data sets. The Database Image Copy utility, DFSUDMP0, is unable to obtain authorization for a recovery-needed area.

System action: The utility is not invoked for this area.

Programmer response: Run the Database Recovery utility, DFSURDB0, before running the Database Image Copy utility to get a correct memory dump.

For nn=07

The ACCESS parameter of the online subsystem is unacceptable for running the DEDB Online utility.

System action: Processing is terminated for area.

Programmer response: Verify the ACCESS parameter of the online subsystem. Ask the master terminal operator to change the database ACCESS parameter by using the /START command. Change it to a level which is compatible with the current DEDB Online utility.

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 actions should be taken:

• If an environment with intersystem 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; then restart the area by using the /START command.
• 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=10

The area has been previously authorized to the subsystem.

System action: The offline utility is not invoked for this area.

Programmer response: Duplicate job names might have been used for the same area. Wait until another IMS subsystem closes the area, and resubmit the job.

For nn=15

The Database Recovery utility is run against a DEDB area when all other subsystems are not marked abnormally terminated for the Database Recovery utility.

System action: The Database Recovery utility is not invoked for this area. The Database Recovery utility terminates.

Programmer response: Make sure that there is no subsystem that has already authorized this area and that has not abnormally terminated. If a subsystem has authorized the area, wait until that subsystem unauthorizes the area, and then rerun the Database Recovery utility.

For nn=16

The area is not marked as recovery-needed in the DBRC RECON data sets. The DEDB Initialization utility is unavailable to obtain authorization for a recovery-not-needed area.

System action: The DEDB Initialization utility terminates.

Programmer response: Make sure that the area is valid for initialization. If the area should be initialized, then force the area to a recovery-needed status using a CHANGE.DBDS command, redefine the area using a VSAM access method service command, specify the utility area control statements again except for the ones already initialized, and rerun the utility.

For nn=20

The named database or area is not registered with DBRC and FORCER option is specified in the DBRC RECON record.

System action: The Fast Path utility being used is not invoked for this area.

Programmer response: Register the named area and area data sets with DBRC using INIT.DBDS and INIT.ADS commands, and resubmit the job.

For nn=22

The area is currently authorized to another subsystem.

System action: Authorization for the requested activity is denied.

System programmer response: Issue a /DBR command for the area for all IMS subsystems.

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 QUIESCE command, 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 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.