PI53258: SUPPORT THE NEW ONSUBCODE2 BUILT-IN FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• -
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Enterprise PL/I users who want to use the    *
  *                 new ONSUBCODE2 built-in function.            *
  *                                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: The Enterprise PL/I runtime is updated  *
  *                      for the ONSUBCODE2 built-in support.    *
  *                                                              *
  ****************************************************************
  * RECOMMENDATION: Apply the provided PTF.                      *
  *                                                              *
  ****************************************************************
  This APAR provides the library support for the new ONSUBCODE2
  built-in function for Enterprise PL/I.
  

Problem conclusion

Temporary fix

Comments

• The ONSUBCODE2 built-in function support is added to the PL/I
  runtime library.
  
  The Enterprise PL/I Language Reference manual, SC14-7285-04,
  will also be updated as follows:
  
  In chapter "Built-in functions, pseudovariables, and
              subroutines"
    section "Categories of built-in functions"
    subsection "Condition-handling built-in functions"
  
    In table Condition-handling built-in functions:
    - Add to the table new built-in function ONSUBCODE2 with the
      following description:
      Returns an integer value that contains the VSAM diagnostic
      information about certain I/O errors
    - And in the existing description for the built-in function
      ONSUBCODE, add the following:
      For JSON built-in function when ERROR condition is raised,
      it gives the index of the invalid character.
  
    Add the new built-in function ONSUBCODE2 with the following
    description:
    - ONSUBCODE2 returns a FIXED BINARY(31,0) value that gives
      more VSAM diagnostic information about certain I/O errors
      that occurred. This corresponds to the SUBCODE2 values
      in decimal as documented for the associated messages.
  
      The SUBCODE2 consists of 8 hexadecimal digits (xxxxyyyy)
      which gives the following information:
      . xxxx = Register 15
      . yyyy = Reason code
      The meaning of the return and reason codes is documented in
      the VSAM Macro Instructions Manual.
  
    And in ONSUBCODE built-in functions description, change the
    paragraph to the following:
    - ONSUBCODE returns a FIXED BINARY(31,0) value that gives
      more information of the followings:
      - If an I/O error occurred, this corresponds to the
        SUBCODE1 values as documented for the associated
        messages. These values are defined in the Language
        Environment Messages and Codes manual.
      - If a JSON or unicode CONVERSION condition is raised, it
        returns the index of the invalid character.
  
  
  PUBS CLOSING CODE: DEVCHNG
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI33975 UI33976

Modules/Macros

•    HLE77A0J HLE7790J IBMPEOS2 IBMPE390 IBMPLIB0
  IBMPLVD  IBMQEOS2
  

Fix information

• Fixed component name

  LE VA PL/I

• Fixed component ID

  568819806

Applicable component levels

• R7A0 PSY UI33975

     UP15/12/24 P F512

• R790 PSY UI33976

     UP15/12/24 P F512

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.