PH11104: PRIVATE PROGRAM HUNG WITH A 'PROGRAM_NOT_LOADABLE' STATE.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CICS TS 5.4
  1. A PRIVATE PROGRAM does a LINK to a public program(progA)
  which does not exist.
     A PRIVATE PPT is created with status 'NOT LOADABLE'.
     This status is correct as the PROGRAM progA does not exist in
     any load libs at this time.
  2. A SET PROGRAM(progA) DISCARD is issued but the PRIVATE PPT is
     NOT deleted.
  3. PROGRAM(progA) is created in the load libs.
  4. Attempt to EC LINK to PROGRAM(progA) immediately fails with
     NOTLOADABLE' PGMIDERR and abendAEIP.
     This occurs as the earlier PRIVATE PPT is being re-used but
     still contains status 'NOT LOADABLE' . This PRIVATE PPT can
     only deleted by restarting CICS.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: An attempt to EC LINK to a program,     *
  *                      added to the system load libraries      *
  *                      after a previous failed load attempt,   *
  *                      fails with PGMIDERR.                    *
  ****************************************************************
  A program is running in CICS and has a private application
  context.
  An attempt to load a program that does not exist in any of the
  system load libraries results in a Private PPTE being created
  by CICS autoinstall with a load status of NOT_LOADABLE.
  If the load module is then added to the load libraries and the
  application is disabled and re-enabled, the PPTE created on the
  first load attempt will still be referenced when an EC LINK is
  made to the program. The NOT_LOADABLE status results in the load
  failing without any attempt to load the
  program.
  
  Keywords: AEIP
  

Problem conclusion

• Code has been added so that when disabling an application that
  has at least one Program Entry Point, a check is made for any
  PPTEs that have the NOT_LOADABLE flag, these will be converted
  to NOT_LOADED. If the application is re-installed a future
  EC LINK to the program will result in an attempt to load this
  program.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI64389 UI64390 UI64391

Modules/Macros

• DFHABAB  DFHAMPIL DFHAPCR  DFHAPEX  DFHAPLI1 DFHAPLI2 DFHAPLI3
  DFHAPLJ1 DFHAPLJ3 DFHAPLX1 DFHAPLX3 DFHAPPG  DFHAPRT  DFHBAAR2
  DFHBRIC  DFHBRMS  DFHBRSP  DFHBRTC  DFHD2EX1 DFHDLI   DFHDUDU
  DFHECEC  DFHECEI  DFHECRL  DFHEEI   DFHEIBAM DFHEIG   DFHEIIC
  DFHEIP   DFHEPAS  DFHEPC   DFHEPEV  DFHEPRL  DFHERM   DFHEXDUF
  DFHEXTRI DFHFCFR  DFHICXM  DFHMLJS  DFHMNAC  DFHMNMN  DFHMPMO
  DFHMQTRU DFHPCPG  DFHPCXDF DFHPGAI  DFHPGAQ  DFHPGCH  DFHPGDD
  DFHPGDM  DFHPGDUF DFHPGEX  DFHPGHM  DFHPGIS  DFHPGLD  DFHPGLE
  DFHPGLK  DFHPGLP  DFHPGLU  DFHPGPG  DFHPGRE  DFHPGRL  DFHPGRP
  DFHPGST  DFHPGUE  DFHPGXE  DFHPGXM  DFHSJTH  DFHSMGF  DFHSMMG
  DFHSNTU  DFHSUEX  DFHTKDUF DFHTRC64 DFHTREX  DFHUEH   DFHWBAP
  DFHWBCL  DFHXCBAM DFHXCCH  DFHXCDMP DFHXCEIP DFHXCGUR DFHXCNVG
  DFHXCPRH DFHXCSCR DFHXCTRI DFHXCV64 DFHXSAD  DFHXSPW  DFHXSRC
  DFHXSTS  DFHZAND  DFJ@H356 DFJ@H360 DFJ@H468
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI64389

     UP19/07/25 P F907

• R10D PSY UI64390

     UP19/07/25 P F907

• R200 PSY UI64391

     UP19/07/26 P F907

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.