Gen 8.6 CICS Transaction fails with abend 4038

Products

• Gen
• Gen - Run Time Distributed
• Gen - Host Encyclopedia

Issue/Introduction

A Gen 8.6 CICS transaction failed with abend 4038.

In the CEEMSG log, the following error message identifies a missing Gen DLL runtime module:

CEE3501S The module TIR..... was not found.

Environment

Gen 8.6 CICS application.

Cause

All Gen 8.6 DLL runtime modules must be available to the target CICS region as part of the CICS DFHRPL data set concatenation. 

Resolution

Add the Gen runtime DLL library, CEHBPLD1 to the data set concatenation or copy the relevant modules to a library in the concatenation.
The data set that contains the Gen runtime modules must be a data set of type LIBRARY, a PDSE (reference Gen™ 8.6 > Installing > Install Gen on z/OS > Configuring Runtime IMS and CICS > Install Gen Runtime Load Library Modules)

CEHBSAMP(DEFCICS) job can be used to create any missing Program definitions (reference Gen™ 8.6 > Installing > Install Gen on z/OS > Configuring Runtime IMS and CICS > Define CICS Block Mode Applications)

Depending upon PTF level, may also need the CEHBSAMP(NDEFCICS) job to create other missing DLL Program definitions (reference Gen™ 8.6 > Release Notes > Gen 8.6.4 Consolidation - see "z/OS COBOL Generators and z/OS Runtimes upgrade to COBOL V6.2, C/C++ V2.2, and Db2 V12 (LU01883-LU01889 and LU01908) (CARS 2110)")

Additional Information

Gen™ 8.6 > Encyclopedia > Host Encyclopedia > Host Encyclopedia Construction > DLLs, Compatibility, and Application Migration in HE

IBM z/OS 3.2 docs: CEE3501S The module module-name was not found.