PK17096: ABEND 0C4 IN DFHMCY WHEN USING THE 3270 BRIDGE DUE TO AN INVALID INDEX REGISTER WITH A 240X240 MAP.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• DFHAP0001 An abend (code 0C4/AKEA) has occurred at offset
  X'0000197C' in module DFHMCY.  This may occur with large
  maps, in this case 240x250 and the field position is beyond
  what can be handled by either 12 or 14 bit.  The failure
  occurs with the 3270 WEB Bridge, DFHBRMS does the SEND MAP on
  behalf of the application, and DFHBRTB is called and
  DFHBRTB_TBSEND_MAP routine goes to DFHMCY which program
  checks.  The failure in DFHMCY is on an IC instruction at
  offset x'1978' due to the index register REG14 containing an
  invalid index which goes beyond the BMS3270AD table.  In this
  case, the bad R14 had 03FFFE05 and R15 was 00000020.  REG2
  contains FFFF8160 which was originally in R14 prior to the
  SRDL and SRL at label MCEA12.  This APAR is being taken
  because DFHMCY cannot handle the screen address since it
  exceeds what can be held in either a 12 or 14 bit SBA.  In
  this case it was a map with a SIZE=(240,240) and the failing
  field POS=(139,1).
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: 0C4 abend in DFHMCY when sending a      *
  *                      large map using the 3270 Web Bridge.    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The CICS Web 3270 Bridge is being used with a terminal
  definition specifying a large pagesize, in this case 240,240. A
  transaction is started from a browser using DFHWBTTA as the
  terminal program. DFHBRMS calls DFHBRTB to update the bridge
  buffer.
  DFHBRTB issues a call to DFHMCY for a field at position 139,1.
  This resolves to field position 33120 or x'8160' which is in
  excess of the maximum x'3FFF' that DFHMCY can cope with. This in
  turn leads to a 0C4 abend.
  Additional keywords: ABEND0C4 ABENDS0C4 S0C4
  

Problem conclusion

• DFHBRMS has been changed to not call DFHBRTB when the pagesize
  for the Web Bridge terminal can result in a field position
  greater than 16383 or x'3FFF'. This will enable the CICS Web
  Bridge to tolerate SEND MAP commands using old style templates
  for these large format BMS maps.
  The CICS Transaction Server for z/OS v3r1 Internet Guide
  (SC34-6450-02) will be altered in chapter 15:
  CICS Web support and 3270 display applications.
  The following will be added after the paragraph beginning:
  DFHWBTTA, DFHWBTTB and DFHWBTTC generate HTML ....
  HTML generated for terminals having a pagesize which
  results in a field position greater than 4095 (x'FFF') may
  not function correctly, particularly when using DFHWBTTC.
  The exception to this is when using old style templates.
  Code has been supplied to tolerate BMS sends of such templates
  when using DFHWBTTA or DFHWBTTB but not DFHWBTTC.
  (Old style templates are those generated by DFHWBTLG from
  CICS/TS V1.2 or CICS/TS V1.3 before PTF UQ53534).
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK12402

Modules/Macros

•    DESBREX  DFHBRMS
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK12402

     UP06/03/10 P F603

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.