Prefix Resolution Update running in IMS compatibility mode ends with RC=4 but with no warning messages.

Products

• Database Analyzer (IMS Tools)
• Mainframe Configuration Manager for IMS for z/OS
• IMS TOOLS - MISC
• Compress Data Compression (IMS Tools)
• Database Analyzer for IMS for z/OS
• Database Copier for IMS for z/OS
• Database Organizer for IMS for z/OS
• Mainframe Extended Terminal Manager (IMS Tools)
• High Performance Recovery for IMS for z/OS
• Database Organizer (IMS Tools)
• Mainframe Program Restart Manager for IMS for z/OS
• Secondary Index Builder for IMS for z/OS
• Secondary Index for IMS for z/OS
• DATABASE MANAGEMENT SOLUTIONS FOR IMS FOR Z/OS

Issue/Introduction

Prefix Resolution Update running in IMS compatibility mode resolves the logical relations and updates the databases fine but the job ends with RC=4.
No message indicates why the return code is shown as '4' instead of '0'.

 

Resolution

It is just the same return code the IBM IMS Prefix Res Utility is showing in case of Logical Parent Orphans being detected.

This is the most common case for logical parents with no logical children.

PRU use the same RC for compatibility reasons.

This can be overridden by using an execution option :

To allow the PRU execution showing RC=0 in case of Logical Parent Orphans,

just use IMSRCCOMPATIBLE=NO

NOTE:

IMSRCCOMPATIBLE=YES is the default only for prefix resolution in IMS compatibility mode!

The IMSRCCOMPATIBLE statement specifies the final Prefix Resolution return code to MVS.

This control statement has the following format: IMSRCCOMPATIBLE=YES|NO

YES

Specifies that Prefix Resolution adjusts the final return code to be compatible with DFSURG10. This is the default when invoked as DFSURG10.

The return code adjustments are as follows:

4

Indicates that an orphan logical parent was found.

8

Indicates that an orphan logical child was found.

12

Indicates that an orphan logical child and an orphan logical parent were found.

16

Indicates a return code of 12 that is rolled up.

NO

Specifies that the final Prefix Resolution return code is as described in Return Codes. This is the default when invoked as other than DFSURG10.