IC63270: HATS SUBFILE PREVIEW IS BLANK, SETTINGS WINDOW DOES NOT APPEAR A FTER PRESSING SETTING BUTTON, AND NULL POINTER EXCEPTION IN .LOG

Rational Host Access Transformation Services, Version 7.5.0.2
Rational Host Access Transformation Services, Version 7.5.1.1
Rational Host Access Transformation Services, Version 7.5.1.2
Rational Host Access Transformation Services, version 7.5.1.3
Rational Host Access Transformation Services Fix Pack 4 (7.5.1.4) for 7.5.1
Rational Host Access Transformation Services Fix Pack 5 (7.5.1.5) for 7.5.1
Rational Host Access Transformation Services Fix Pack 6 (7.5.1.6) for 7.5.1

APAR status

• Closed as program error.

Error description

• Customer is using HATS 7.5, though they say they also saw this
  symptom in HATS 7.1 but didn't report it until now.
  HATS Project is a 5250 with 27x132 display size.
  Customer goes into the Subfiles default rendering item and
  when they get to the Rendering Options screen where they should
  be able to choose the Subfile component, it is highlighted,
  but the Component Preview is blank.  Pressing the component
  settings button should give a settings popup window, but instead
  nothing happens.  In looking further, the .metadata/.log
  file in the customer's workspace has a null pointer exception
  logged beginning with this information:
  !ENTRY org.eclipse.ui 4 0 2009-09-18 16:35:46.218
  !MESSAGE Unhandled event loop exception
  !STACK 0
  java.lang.NullPointerException
   at
  com.ibm.hats.transform.components.SubfileHeaderComponentV6.check
  HeaderByColor(Unknown Source)
   at
  com.ibm.hats.transform.components.SubfileHeaderComponentV6.recog
  nize(Unknown Source)
   at
  com.ibm.hats.transform.components.SubfileComponentV6.recognize(U
  nknown Source)
   at
  com.ibm.hats.transform.components.Component.recognize(Unknown
  Source)
   at
  com.ibm.hats.studio.composites.SubfileSettingsCompositeV6.setRec
  ognizedRegions(Unknown Source)
  .
  .
  .
  etc.
  

Local fix

• Customer can work around the issue somewhat by selecting a
  subset of the screen area, although this is not the way they
  want to define their rendering item.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of HATS applications directed to       *
  *                 5250 (IBM i) hosts that                      *
  *                 use subfiles and that have been customized.  *
  ****************************************************************
  * PROBLEM DESCRIPTION: Blank subfile preview in HATS           *
  *                      toolkit, and                            *
  *                      java.lang.NullPointerException in       *
  *                      .metadata/.log file in programmer's     *
  *                      workspace.                              *
  *                      At runtime, the subfile will not        *
  *                      be rendered.                            *
  *                                                              *
  *                      These problems will occur when all of   *
  *                      the following conditions are true:      *
  *                                                              *
  *                      1) Subfile actions are recognized       *
  *                      with the default subfile settings.      *
  *                                                              *
  *                      2) "Must be specified color" or         *
  *                      "High intensity" option is enabled in   *
  *                      subfile Action tab to exclude           *
  *                      actions that were recognized in step    *
  *                      1 above.                                *
  *                                                              *
  *                      3) "Action not required" option is      *
  *                      enabled in subfile Action tab           *
  *                                                              *
  *                      4) "High intensity" or "Specified       *
  *                      color" option was enabled in subfile    *
  *                      Header tab.                             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  HATS code referred to a null pointer variable when the
  conditions in the Problem Description were true.
  

Problem conclusion

• HATS code, SubfileHeaderComponenetV6.java, was changed to
  verify that the variable was not null before referencing it.
  

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:

Modules/Macros

• HSRENDER
  

Fix information

• Fixed component name

  RATL HATS MULTI

• Fixed component ID

  5724U6700

Applicable component levels

• R750 PSY

     UP