PI16872: RUNTIME EXCEPTION WHEN GENERATING LIBRARY MODULE WITH OVERLOADEDFUNCTIONS

Rational Business Developer 9.1
Rational Business Developer Fix Pack 2 (8.5.1.2) for 8.5.1
Rational Business Developer 9.1.1
Rational Business Developer Fix Pack 1 (9.0.1.1) for 9.0.1
Rational Business Developer Fix Pack 1 (9.1.1.1) for 9.1.1
Rational Business Developer Fix Pack 2 (9.0.1.2) for 9.0.1

APAR status

• Closed as program error.

Error description

• If a library has multiple functions with the same name, but a
  different number of arguments, previously compiled programs need
  to be regenerated, otherwise a 9980 error occurs indicating that
  the function does not exist.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Libraries that were generated without function overloads,    *
  * and then overloads added after programs have been generated  *
  * and compiled.                                                *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * If an EGL program invokes an EGL library function is         *
  * generated and compiled, the cobolGen generation logic would  *
  * not add any of the necessary information that is required if *
  * the function was overloaded (same function name with         *
  * different arguments) in the library, as it is not required.  *
  * However, if that library function is at a later time         *
  * overloaded, by adding a new function with the same name and  *
  * different arguments, the library would be generated          *
  * expecting more information on exactly which of the           *
  * overloaded functions to use. However, the original caller    *
  * programs do not have this information and this in turn would *
  * cause 9980 errors indicating that the function does not      *
  * exist, for programs that used to work.                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• An immediate circumvention for this is to recompile all caller
  programs as they would detect that the library function is
  overloaded and would then provide the additional information
  that is required. However, this is not acceptable in many cases.
  Recompiling may affect many programs. This fix prevents the need
  to recompile any of the programs that call the library function.
  With this fix, only the library needs to be regenerated and
  compiled, as long as the function signatures are different in
  some minimal way.
  

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:

Fix information

• Fixed component name

  RATL BUS DEV

• Fixed component ID

  5724S5000

Applicable component levels

• R851 PSY

     UP

• R901 PSY

     UP

• R910 PSY

     UP