Java 21 users receiving CEE3728S under z/OS 2.5

Troubleshooting

Problem

On a z/OS 2.5 system, a Java 21 application making use of new C functions introduced in z/OS 3.1 (i.e. fgetxattr(), etc.) might fail with CEE2728S run-time message.

Symptom

The application terminates with CEE3728S - The use of a function, which is not supported by this release of Language Environment was detected.

Cause

A C function introduced in z/OS 3.1 was used, which is not supported in z/OS 2.5 Language Environment.

Environment

A z/OS 2.5 system running Java 21.

Diagnosing The Problem

Determine which function is causing the issue from the LE Traceback and CEE2728S run-time message:

Traceback:
  DSA   Entry       E  Offset  Statement   Load Mod             Program Unit                   Service  Status
  1     CEEHDSP     +00003FD8              CELQLIB              CEEHDSP                        HLE77D0  Call
  2     CEEOSIGG    +00001420              CELQLIB              CEEOSIGG                       HLE77D0  Call
  3     CEEHSGL     +000003C8              CELQLIB              CEEHSGL                        HLE77D0  Call
  4     CEERTFM     +00000054              CELQLIB              CEERTFM                        HLE77D0  Exception
  5     fgetxattr   +0000002A              CELQLIB                                             HLE77D0  Call
  6     atoe_fgetxattr
                    +00000122              libwrappers.so                                               Call
...
CEE3728S The use of a function, which is not supported by this release of Language Environment was detected. From entry 
point atoe_fgetxattr at compile unit offset +00000000xxxxxxxx at entry offset +0000000000000122 at address 00000000xxxxxxxx

Then, confirm that the C function that was introduced in z/OS 3.1, but not available on z/OS 2.5.

Resolving The Problem

Review APAR PH45182: New C Runtime Library APIs and install the available z/OS 2.5 PTF UI95696. This PTF makes the listed z/OS 3.1 functions available on z/OS 2.5, thus resolving CEE3728S.

Related Information

CEE3728S

Document Location

Worldwide

Operating System

z Systems:All operating systems listed

[{"Type":"MASTER","Line of Business":{"code":"LOB56","label":"Z HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG90","label":"z\/OS"},"ARM Category":[{"code":"a8m0z00000009veAAA","label":"z\/OS-\u003ELanguage Environment \/ Cruntime-\u003EC-LanguageRuntime \/ functions"}],"ARM Case Number":"","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"2.5.0"}]

Tips