PK50762: STARTING CICS WITH PGRET AND SKRPXX RESULTS IN DFHSI1556I MESSAG E

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When specifying the SYSIN parameters:
  SKRPA1=''
   PGRET=P/
  the message DFHSI1556I is issued indicating 'SKRPxx DISABLED DUE
  TO EXTENSION OF "PGRET"'.  The CICS region will not startup.  A
  DFHPA0001 ---/AKEA abend also occurs in DFHAPDM followed by a
  KERNDUMP.  In the dump, the 0C4 abend is occurring due to the
  psw being 078D0000 C0404040.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS fails to start after issuing       *
  *                      message DFHPA0001 for an AKEA abend     *
  *                      in DFHPADM. This message may have been  *
  *                      preceded by message DFHSI1556I.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The SKRPA1='' and PGRET=/P parameter, in that order,
  were added to the SYSIN stream.
  During CICS startup message DFHSI1556I was issued
  stating;
  'DFHSI1556I - SKRPA2  DISABLED DUE TO EXTENSION
  OF "PGRET" VALUE'
  This message was follows by message DFHPA0001
  indicating an AKEA Abend has occurred in DFHPADM. A
  KERNDUMP was taken and CICS failed to start.
  In the dump, the 0C4 abend had occurred due to an
  inaccessible address (x'C0404040) being introduced into
  the PSW. This address was loaded into the PSW from a
  corrupt Register Save Area. The corruption was traced to
  the processing of a PGRET SIT override parameter.
  This entails the updating of the SITSKRTB which is part
  of the instore SIT table.
  The SITSKRTB is a table containing the values set for SIT
  parameters SKRPA1-3 and SKRPF1-24. Each 16 byte entry
  contains the values supplied in the SIT macro, or
  previous SIT overrides, concatenated with the PGRET
  value. If a SKRPA/PF value is added or set to BLANKS by a
  SYSIN override then the resulting entry will only contain
  the PGRET prefix.
  When processing the new PGRET each entry of the SITSKRTB
  is checked to determine if it contains a value. Those which
  are completely blank are bypassed. It is assumed that
  non-blank entries contain a PGRET and SKRPA/PF
  concatenation. The update calls for values to be
  separated, so that the PGRET part can be updated. To
  complete the update both the new PGRET and SKRPA/PF
  values are placed back into the SITSKRTB entry. If
  however there is NO SKRPA/PF data, having previously been
  set to spaces, the separation process generates an
  incorrect length of X'FFFFFFF' for this data. The
  resulting move of the non-existent SKRPA/PF data causes
  an overwrite of storage used, in this case, to hold saved
  Register values. When one of these overwritten values
  is used as a return address an 0C4 abend occurs. This
  prevents the startup of CICS.
  
  Additional keywords: MSGDFHSI1556I SI1556I abend0C4 abendS0C4
                       S0C4 SKRxxxx
  

Problem conclusion

• The processing of the PGRET update, in DFHPASY, has
  been amended. The absence of SKRPA/PF data will be
  detected and only the PGRET value will be updated.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK36975

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

  UK29473

Modules/Macros

•    DFHPASY
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK29473

     UP07/09/27 P F709

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.