Endevor API termination after a LIST ELEMENT function may experience a S0C4 abend
search cancel

Endevor API termination after a LIST ELEMENT function may experience a S0C4 abend

book

Article ID: 398841

calendar_today

Updated On:

Products

Endevor

Issue/Introduction

A program (user program, CSV utility or one of the Web Services started tasks) processes an API LIST ELEMENT function

In this situation, a S0C4 abend may arise during shutdown of the API

The abend arises within module BC1PAL10

Cause

The root cause of this abend is a storage overlay during the processing of the API. The overlayed storage causes the abend during API shutdown

The overlay happens when the API LIST ELEMENT function finds errors in source management for some of the processed elements and the API issues a couple of API0000C messages to inform about these errors

API0000C  SOURCE MANAGEMENT ERROR DETECTED FOR ELEMENT TRTFC401
API0000C    FROM ENDEVOR LOCATION: PRD/2/CORPTRST/TRS0500/DOC40

The code that formats these messages mistakenly alters the rightmost byte of a base register which causes the overlay in fields close to the one that holds the message text. One of the overlaid fields is a pointer that causes the S0C4 during API shutdown, when the logic tries to deallocate datasets 

Resolution

Apply the fix that corresponds to your Endevor release

  • LU17817 for Endevor 19.0
  • LU17818 for Endevor 18.1 

The abend may also be prevented by clearing any source management errors that might arise during the processing of the API request