PH22330: DFHXS0001 AN ABEND (CODE 9C7/AKEX) HAS OCCURRED AT OFFSET X'FFFF' IN MODULE DFHXSAD.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Migrated TORs to CICS TS 5.5 from CICS TS 5.4 and started
  getting the following errors. These TOR's have a CTG front end
  that connect to the TOR's over IPIC.
  .
  DFHXS0001 CICSREGN An
  abend (code 9C7/AKEX) has occurred at offset X'FFFF' in module
  DFHXSAD.
  DFHME0116 CICSREGN 563
   (Module:DFHMEME) CICS symptom
  string for message DFHXS0001 is
   PIDS/5655Y0400 LVLS/720
  MS/DFHXS0001 RIDS/DFHXSAD PTFS/UI65570
   AB/S09C7 AB/UAKEX
  ADRS/0000FFFF
  .
  DFHIS0002 CICSREGN A severe error (code
  X'0686') has occurred in module DFHISXM.
  DFHME0116 CICSREGN
  575
   (Module:DFHMEME) CICS symptom string for message
  DFHIS0002 is
   PIDS/5655Y0400 LVLS/720 MS/DFHIS0002
  RIDS/DFHISXM PTFS/UI64971
   PRCS/00000686
  .
  The problem was
  caused by a 9 character UserID. In both Releases the 9
  character userid is passed to the ESM and a 9C7 abend occurs.
  In the 5.4 case this is caught by DFHXSSA and turned into an
  exception response. In 5.5 the DFHXSSA ESTAE routine is not
  being driven. This causes control to end up in DFHXSAD with the
  abend being converted to a disaster response and percolated but
  up the stack to DFHISXM.
  .
  The problem occurs because DFHXSSA
  is now storing more registers in the RBEXSAVE area resulting in
  an overlay of the storage following the RBEXSAVE
  area.
  .
  Keyword(s): KIXREVxxx
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message DFHXS0001 with abend code 9C7   *
  *                      is issued by DFHXSAD when trying to     *
  *                      sign on a 9 character userid.           *
  ****************************************************************
  CICS and CICS Transaction Gateway are connected via IPIC.
  The IPCONN specifies USERAUTH(IDENTIFY) which means that the
  client must supply a userid with each request. The client
  sends in an invalid 9 character userid. This userid gets
  passed through DFHUSAD, DFHXSAD and eventually via the CICS
  SVC to DFHXSSA.
  
  On entry to DFHXSSA, an ESTAE should be established. This does
  not happen due to an overlay of field RBSEXIT in the SVRB. The
  overlay was caused by prolog code in DFHXSSA when attempting to
  save registers into field RBEXSAVE.
  
  Processing continues and the RACROUTE REQUEST=VERIFY,
  ENVIR=CREATE call is made to the ESM passing the 9 character
  userid.  The ESM detects the invalid userid an issues abend9C7
  with reason x'14'.  DFHXSSA is expected to handle this abend,
  convert it to a suitable response and reason code and return
  normally. The earlier failure to establish the ESTAE meant that
  the recovery routine in DFHXSAD gets driven instead. This does
  not expect to handle the 9C7 abend so issues message DFHXS0001,
  takes a system dump and returns a disaster response.
  
  Keyword: XS0001 S9C7 abendS9C7
  

Problem conclusion

• The CICS security SVC modules have been changed to ensure that
  their ESTAE is correctly established and any ESM abends are
  caught and converted to appropriate response and reason codes.
  

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:

  UI68615

Modules/Macros

• DFHXSSA  DFHXSSB  DFHXSSC  DFHXSSD  DFHXSSE  DFHXSSH  DFHXSSI
  DFHXSSK
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R200 PSY UI68615

     UP20/03/26 P F003

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.