Program RHDCBYE abends with a D003 or D002 abend

Products

• IDMS
• IDMS - Database
• IDMS - ADS

Issue/Introduction

The BYE task can end abnormally with a D003 or D002 abend whenever the task is run to terminate DC, UCFBATCH, UCFTSO or UCFCICS session. The PSW usually points to a low offset in program RHDCBYE (offsets  9A - 9C - A4).

The following messages appear in the IDMS DC log :

 PREVIOUS TASK ABENDED WITH ABEND CODE D003 	
 DC027001 Vn Tnnn D003 PROGRAM CHECK IN RHDCBYE AT OFFSET xxx 	
 PSW WAS xxxxxxxx xxxxxxxx DUMP OF TASK FOLLOWS 

 

Environment

Release: 19.0

Cause

This abend happens when your Central Version runs with

1. STORAGE PROTECT turned ON at SYSTEM level AND
2. program RHDCBYE is defined with PROTECT

Program RHDCBYE should NEVER be defined with PROTECT in SYSGEN. 

Only user programs should be defined with PROTECT. All IDMS supplied system programs, with names that start with RHDC and IDMS should be defined with NOPROTECT. 

You should only PROTECT the ADS runtime system - programs ADSOMAIN and ADSORUN1 and any user coded COBOL and assembler programs.

Resolution

In order to prevent this kind of abends, perform the following  

a)  Issue the following command : DCMT VARY PROGRAM RHDCBYE STORAGE PROTECT OFF

     Note : This modification is active immediately, but only until shutdown. In addition, to modify this permanently,

b)  run SYSGEN to modify the program definition of RHDCBYE:

   SIGNON DICT SYSTEM.   
   MODIFY SYSTEM nnn.
   MODIFY PROGRAM RHDCBYE
          NOPROTECT.
   GENERATE.

Additional Information

See IDMS documentation Storage Protection and PROGRAM Statement