PK45288: ADD TWO NEW MESSAGES TO THE LE RUN-TIME TO SUPPORT THE NEW ENTERPRISE PL/I CODEPAGE CONVERSION BUILT-IN FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Add two new messages to the LE run-time to support the new
  Enterprise PL/I codepage conversion built-in function
  'memconvert'."
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Enterprise PL/I users that would like to     *
  *                 convert character strings from one CCSID to  *
  *                 another CCSID.                               *
  *                                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR adds two new messages to the  *
  *                      PL/I run-time library to support the    *
  *                      new 'memconvert' Enterprise PL/I        *
  *                      built-in function.                      *
  *                                                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The new Enterprise PL/I built-in function to convert character
  strings from one CCSID to another requires two new PL/I run-time
  messages.
  

Problem conclusion

• Two new PL/I run-time messages are added to support the new
  Enterprise PL/I built-in function to convert character strings
  from one CCSID to another.
  
  ---------------------
  CO-REQUISITE UPDATES
  ---------------------
  
  The support for calling Unicode conversion services with the
  new 'memconvert' PL/I built-in function requires that a
  co-requisite update is made to the Enterprise PL/I V3R6 compiler
  and the Language Environment Run-time.
  
  The PTFs for the following Enterprise PL/I compiler update
  must be applied before the 'memconvert' built-in function can
  be used:
     APAR PK43760
  
  The PTFs for the following Language Environment Run-time update
  must be applied before the 'memconvert' built-in function can
  be used:
     APAR PK39078
  
  ---------------------
  DOCUMENTATION UPDATES
  ---------------------
  
  *** Changes to SC27-1461-06,
  *** Enterprise PL/I for z/OS: Messages and Codes
  
  The following changes will be made under the section
     "Chapter 9. Condition Codes"
     Subsection "Condition Codes 3000 through 3900":
     Add new condition codes 3002 and 3003:
  
  3002    memconvert built-in returned a bad return code.
  3003    No room for shift-in after Unicode conversion.
  
  *** Changes to SA22-7566-07,
  *** z/OS V1R8.0 Language Environment Run-Time Messages
  
  The following changes will be made under the section
     "Chapter 6. PL/I Run-Time Messages"
     Add new messages IBM0602S and IBM0603S:
  
  IBM0602S ONCODE=ONCODE-VALUE  Data conversion from SOURCE-CCSID
           to TARGET-CCSID was unsuccessful.  The return code
           from the Unicode Conversion Service CUNLCNV was
           RETURN-CODE and the reason code was REASON-CODE.
  
  Explanation:  The data conversion for the CCSID pair failed as
  indicated by the return code and the reason code.  The return
  code and the reason code values for conversion services are
  described in SA22-7649, 'z/OS Support for Unicode: Using Unicode
  Services'.
  
  Programmer Response:  Follow the programmer responses indicated
  for specific return and reason codes in 'z/OS Support for
  Unicode: Using Unicode Services'.
  
  System Action:  The application was terminated.
  
  IBM0603S ONCODE=ONCODE-VALUE  There was not enough room for the
           shift-in character after the call to Unicode Conversion
           Services.
  
  Explanation:  The Unicode Conversion Services was called to
  convert characters from a Unicode CCSID to an EBCDIC MBCS CCSID.
  After the conversion was complete there was no room left in the
  target buffer for the closing shift-in character.
  
  Programmer Response:  Retry the conversion after increasing the
  target buffer to accommodate the closing shift-in character.
  
  System Action:  The application is terminated.
  
  PUBS CLOSING CODE: DEVCHNG
  

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:

  UK25902 UK25904 UK25903 UK25905 UK25907 UK25906

Modules/Macros

•    IBMBALCT IBMEDCCT IBMFORCT IBMIBMCT IBMIGZCT
  IBM9LM2A IBM9LM2N IBM9LM2U
  

Fix information

• Fixed component name

  LE PL/I LIBRARY

• Fixed component ID

  568819803

Applicable component levels

• R7J9 PSY UK25903

     UP07/06/24 P F706

• R709 PSY UK25902

     UP07/06/24 P F706

• R72J PSY UK25905

     UP07/06/24 P F706

• R720 PSY UK25904

     UP07/06/24 P F706

• R73J PSY UK25907

     UP07/06/24 P F706

• R730 PSY UK25906

     UP07/06/24 P F706

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.