DFS1987I REASON CODE = rc message_text

Explanation

An error occurred running one of the following utilities:
  • ACB Generation and Catalog Populate utility (DFS3UACB)
  • HALDB Partition Data Set Initialization utility (DFSUPNT0)

For an explanation of the error and possible solutions to the error, find the return code of the error message in the following list.

REASON = 01 SYSPRINT DD STATEMENT REQUIRED FOR STAND ALONE EXECUTION
Explanation: The IMS program controller module DFSRRC00 did not start the utility because the utility JCL does not include a SYSPRINT DD statement. A SYSPRINT data set is required.

System action: Processing halts and return code is set to 8.

User response: Check and correct the error condition indicated by the message and reason code.

Module: DFSUPNT0, DFS3UACB.

REASON = 02 SYSPRINT DD DUMMY NOT ALLOWED FOR STAND ALONE EXECUTION
Explanation: The IMS program controller module DFSRRC00 did not start the utility because a SYSPRINT DD DUMMY is specified in the utility JCL instead of a SYSPRINT data set. A SYSPRINT data set is required.

System action: Processing halts and return code is set to 8.

User response: Check and correct the error condition indicated by the message and reason code.

Module: DFSUPNT0, DFS3UACB.

REASON = 03 AN ERROR OCCURRED OPENING THE SYSPRINT DATASET
Explanation: The utility encountered an error opening the SYSPRINT data set.

System action: Processing halts and return code is set to 8.

User response: Check the system messages in the job log to determine the cause of the error and correct it.

Module: DFSUPNT0, DFS3UACB.

REASON = 04 A GETMAIN ERROR OCCURRED
Explanation: The utility encountered an error while obtaining storage.

System action: Processing halts and return code is set to 16.

User response: Increase the region size for the job or decrease the number of SYSIN statements.

Module: DFSUPNT0, DFS3UACB.

REASON = 05 ERROR LOADING MODULE &modulename
Explanation: The utility encountered an error while loading the module &modulename.

System action: Processing halts and return code is set to 12.

User response: Place the specified module in the LOADLIB concatenation for this job step.

Module: DFSUPNT0, DFS3UACB.

REASON = 06 DBRC INITIALIZATION FAILED FOR PHASE 1
Explanation: The utility encountered an error during phase 1 initialization of DBRC.

System action: Processing halts and return code is set to 8.

User response: Examine the job log for additional messages to determine and correct the cause of the error.

Module: DFSUPNT0, DFS3UACB.

REASON = 07 DBRC INITIALIZATION FAILED FOR PHASE 2
Explanation: DFSUPNT0 encountered an error during phase 2 initialization of DBRC.

System action: Processing halts and return code is set to the internal DBRC error code.

User response: Contact IBM® Software Support.

Module: DFSUPNT0.

REASON = 08 AN ERROR OCCURRED OPENING THE DFSOVRDS DATASET
Explanation: DFSUPNT0 encountered an error opening the data set specified by the DFSOVRDS DD statement.

System action: Processing halts and return code is set to 8.

User response: Examine the job log for additional information about the error and correct it.

Module: DFSUPNT0.

REASON = 09 AN ERROR OCCURRED OPENING THE DFSRESLB DATASET
Explanation: DFSUPNT0 encountered an error opening the data set specified by the DFSRESLB DD statement.

System action: Processing halts and return code is set to 8.

User response: Examine the job log for additional information about the error and correct it.

Module: DFSUPNT0.

REASON = 10 IMS INTERNAL ERROR - DYNAMIC PSB IS CORRUPTED
Explanation: DFSUPNT1 or DFSUPNT2 encountered and invalid PCB control block in the parameter list passed by IMS. The error is returned to DFSUPNT0.

System action: Processing halts and return code is set to 16.

User response: Contact IBM Software Support.

Module: DFSUPNT1, DFSUPNT2.

REASON = 11 DL/I PINT CALL RETURNED UNEXPECTED STATUS CODE = &statuscode
Explanation: DFSUPNT0, DFSUPNT1, or DFSUPNT2 encountered an invalid status code (&statuscode) returned from IMS for the internal DL/I PINT call.

System action: Processing halts and return code is set to 8.

User response: Examine the job log for additional information about the error and correct it. If the problem cannot be determined, contact IBM Software Support.

Module: DFSUPNT0, DFSUPNT1, DFSUPNT2.

REASON = 12 ESTAE HAS DETECTED AN ABEND RESULTING FROM ATTACH OF DFSRRC00
Explanation: The ESTAE routine was driven for the utility due to an abend of the attached IMS system.

System action: Processing halts and return code is set to 32.

User response: Examine the job log for additional information about the error and correct it. If the problem cannot be determined, contact IBM Software Support.

Module: DFSUPNT0, DFS3UACB.

REASON = 13 A SYSIN DD CARD IS REQUIRED TO EXECUTE DFSUPNT0 STAND ALONE
Explanation: DFSUPNT0 was not started by the IMS program controller module DFSRRC00. A SYSIN data set is required, but no SYSIN DD statement was found in the JCL.

System action: Processing halts and return code is set to 8.

User response: Check and correct the error condition indicated by the message and reason code.

Module: DFSUPNT0.

REASON = 14 SYSIN DD DUMMY NOT ALLOWED FOR STAND ALONE EXECUTION
Explanation: DFSUPNT0 was not started by the IMS program controller module DFSRRC00. A SYSIN data set is required, but a SYSIN DD DUMMY statement was found in the JCL.

System action: Processing halts and return code is set to 8.

User response: Check and correct the error condition indicated by the message and reason code.

Module: DFSUPNT0.

REASON = 15 NO SYSIN STATEMENTS FOUND
Explanation: DFSUPNT0 was not started by the IMS program controller module DFSRRC00. The SYSIN data set is empty.

System action: Processing halts and return code is set to 8.

User response: Check and correct the error condition indicated by the message and reason code.

Module: DFSUPNT0.

REASON = 16 AN ERROR OCCURRED OPENING THE SYSIN DATASET
Explanation: DFSUPNT0 encountered an error opening the SYSIN data set.

System action: Processing halts and return code is set to 16.

User response: Check the job log for additional messages and correct the error condition.

Module: DFSUPNT0.

REASON = 19 THE DFSOVRDS DD CARD HAS AN INVALID INPUT
Explanation: You can only use DD DUMMY or a character string that contains INITALL in the DFSOVRDS DD card. Any other input is invalid.

System action: Processing halts and return code is set to 8.

User response: Enter a valid input string for the DFSOVRDS DD card.

Module: DFSUPNT0.

REASON = 20 PARTITION SELECTION FAILED
Explanation: Before initializing the partition, DFSPSEL was called to mark the partition as empty. This call was unsuccessful. The partition initialization could not be completed.

System action: Processing halts and return code is set to 16.

User response: Examine the job log for additional information about the error and correct it.

Module: DFSUPNT0.

REASON = nn UNEXPECTED ERROR - INITIALIZATION INTERNAL LOGIC ERROR
Explanation: The utility encountered an unexpected logic error.

System action: Processing halts and return code is set to 99. The reason code has meaning only to IMS support personnel.

User response: Contact IBM Software Support.

Module: DFSUPNT0, DFS3UACB.

Module

DFS3UACB, DFSUPNT0, DFSUPNT1, DFSUPNT2