S/MF
StackMF Knowledge Base • z/OS
CICS & VSAM Architecture 8 min read 2026-09-27

Handling IMS DL/I Status Code 'GE': Navigating Unmatched Key Ranges and Boolean SSAs

A
Reviewed by Anshu
Chief Technology Architect & Mainframe Systems SME
Verified Production Runbook
Google AI Overview & Featured Snippet Quick Answer

Quick Diagnostic Summary: What Causes Handling IMS DL/I Status Code 'GE': Navigating Unmatched Key Ranges and Boolean SSAs?

IMS DL/I status code 'GE' indicates the requested segment was not found (equivalent to SQLCODE +100). Learn how to handle 'GE' gracefully, optimize qualified Segment Search Arguments (SSAs), and navigate hierarchical paths.

1 Incident Symptoms: What Triggers Handling IMS DL/I Status Code 'GE': Navigating Unmatched Key Ranges and Boolean SSAs?

A COBOL IMS transaction looking up an account number abends with U4038 because the developer treats status code 'GE' as an unhandled system failure rather than a standard 'record not found' business condition.

2 Technical Root Cause & Architecture Mechanics

When issuing DL/I calls (GU, GHU, GN):

  • A blank status code (' ') indicates success.
  • Status Code 'GE' indicates DL/I searched the database according to the supplied Segment Search Argument (SSA) but found no segment meeting the qualification criteria.
  • In parent-child relationships, 'GE' is also returned when reading past the last child segment under a parent.

3 Step-by-Step Diagnostic & Code Resolution

# 1. Construct Qualified SSA in Working-Storage

cobol
01  ACCOUNT-SSA.
           05  FILLER           PIC X(08) VALUE 'ROOTSEG '.
           05  FILLER           PIC X(01) VALUE '('.
           05  FIELD-NAME       PIC X(08) VALUE 'ACCTNO  '.
           05  OPERATOR         PIC X(02) VALUE '= '.
           05  KEY-VALUE        PIC X(10) VALUE 'ACC90214  '.
           05  FILLER           PIC X(01) VALUE ')'.

# 2. Handle 'GE' Gracefully in COBOL Logic

cobol
CALL 'CBLTDLI' USING GU
                            CUST-PCB
                            CUST-IO-AREA
                            ACCOUNT-SSA.

       EVALUATE PCB-STATUS-CODE
           WHEN '  '
               PERFORM 2000-PROCESS-ACCOUNT
           WHEN 'GE'
      * Record does not exist - business condition
               MOVE 'Account Not Found' TO WS-ERROR-MSG
               PERFORM 3000-NOT-FOUND-ROUTINE
           WHEN OTHER
      * True technical failure
               PERFORM 9999-HANDLE-IMS-ABEND
       END-EVALUATE.

Diagnostic Reference Matrix

Attribute Specification
Target Subsystem IBM z/OS 2.4 - 3.1 • CICS & VSAM Architecture
Error Signature IMS DB, DL/I, Status Code GE
Resolution SLA < 15 Minutes via Verified StackMF Runbook
Technical Reviewer Anshu, Chief Technology Architect • StackMF Architecture Pod

Architectural Prevention & Performance Tuning Checklist

? Frequently Asked Questions

What is the root cause of Handling IMS DL/I Status Code 'GE': Navigating Unmatched Key Ranges and Boolean SSAs? ↓
When issuing DL/I calls (GU, GHU, GN):.
How do you resolve Handling IMS DL/I Status Code 'GE': Navigating Unmatched Key Ranges and Boolean SSAs in production? ↓
IMS DL/I status code 'GE' indicates the requested segment was not found (equivalent to SQLCODE +100). Learn how to handle 'GE' gracefully, optimize qualified Segment Search Arguments (SSAs), and navigate hierarchical paths.
How can teams prevent Handling IMS DL/I Status Code 'GE': Navigating Unmatched Key Ranges and Boolean SSAs in enterprise pipelines? ↓
Never terminate programs abruptly when status code is 'GE'.

Recommended Technical Runbooks

Authoritative Reference Documentation

Official IBM manuals, Redbooks, and vendor technical advisories:

Related Topics: IMS DBDL/IStatus Code GESSASegment Not FoundCOBOL
Diagnostic Runbook Notice & Nominative Fair Use Disclaimer

This diagnostic runbook is published by StackMF Technologies LLP for educational and architectural reference only. All code snippets, JCL, and procedures are provided "AS IS" without warranty of any kind. Always test changes thoroughly in non-production sysplex environments prior to production rollout.

IBM, z/OS, CICS, Db2, IMS, RACF, and IDz are registered trademarks of International Business Machines Corporation. Broadcom, CA-7, and Endevor are trademarks of Broadcom Inc. All other trademarks belong to their respective owners and are referenced under the Nominative Fair Use Doctrine (US Lanham Act 15 U.S.C. ยง 1125 / Section 30 of the Indian Trade Marks Act, 1999) solely for technology compatibility and diagnostic identification. StackMF Technologies LLP is an independent consulting entity not affiliated with or endorsed by these vendors. View Full Legal & IP Policy →

Enterprise Advisory

Struggling with Critical Mainframe Incidents or Vendor Renewal Pressure?

StackMF deploys certified Senior Mainframe Engineers fluent in both z/OS legacy internals (COBOL, DB2, CICS, VSAM, CA-7, Endevor) and modern cloud stacks (React, Kafka, AWS, Git). Onboard dedicated pods in 48 hours or cut Broadcom licensing by 60%.