IC60796: HATS SEARCHSTRING API ALWAYS FAILS WITH -1 RETURN CODE

Rational Host Access Transformation Services, Version 7.1.0.4
Rational Host Access Transformation Services, Version 7.1.0.5
Rational Host Access Transformation Services, Version 7.1.0.6
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

• The SearchString API in the HostScreen class never finds the
  specified string on the screen and always returns -1.  There are
  three forms of the call and the one that is failing is the
  following:
  SearchString(String text,int direction)
  
  The command fails when you pass it a string that you know is on
  the host screen and a direction value of 1 which means search
  forward.
  

Local fix

• Use one of the SearchString methods that specifies a position.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Developers using the SearchString or         *
  *                 SearchText API which don't specify a start   *
  *                 position for the search.                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: Using the SearchString or SearchText    *
  *                      API always fails returning -1.          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The API was internally setting the start position for the
  search incorrectly.  As a result the search was never done and
  -1 was always returned.
  

Problem conclusion

• An incorrect start position was being used internally in the
  SearchString and SearchText API.  As a result the call fails
  and returns immediately without ever doing the search.
  The SearchString and SearchText API were changed to pass the
  correct starting position.
  

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

• HATSCOMM
  

Fix information

• Fixed component name

  RATL HATS FOR 5

• Fixed component ID

  5724U6800

Applicable component levels

• R710 PSY

     UP

• R750 PSY

     UP