DBOE301E unable to establish IMS environment in a native mode Database Organizer Reload job

Products

• Database Organizer for IMS for z/OS
• Database Organizer (IMS Tools)
• DATABASE MANAGEMENT SOLUTIONS FOR IMS FOR Z/OS

Issue/Introduction

Why does a Database Organizer Reload fails with a return code 12 when running in native mode, but the same job runs successfully in Non-Native mode?

Environment

Running Database Organizer Reload in compatibility mode or Native mode.

The JCL or PROC being used to run this step was created using the TOOLKIT.SAMPLIB(JCLDBO) member as a model.

The following error messages are displayed:

IDI2104E UNABLE TO INTERFACE WITH IMS. 
DBOE301E UNABLE TO ESTABLISH IMS ENVIRONMENT NEEDED FOR DBRC AND/OR SEGMENT EDIT ROUTINES. 
IDI7601I FUNCTION RETURN CODE = 0012 (MODULE DBOIULU, SUFFIX(G), OFFSET 0276). 

 

Resolution

In compatibility mode an IMS DD statement is always required whether DBRC will be used or not. If it is missing the reload abends with message:

IEC130I IMS DD STATEMENT MISSING

In Native Mode an IMS DD statement pointing to the DBDLIB must be added if DBRC=Y is used. RECON DDs should also be added.
If DBRC is NOT used in native mode, either an IMS DD statement or a DBDLIB DD statement is allowed.