IBM Support

PH49108: JCICS RetrievedDataHolder.getValue().getData() returns null

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A task uses the JCICS Task.retrieve(BitSet, RetrievedDataHolder)
    method to get the data passed when the task was started.
    
    However the RetrievedDataHolder.getValue().getData() call to get
    the data returns null.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: JCICS RetrievedData.getData() returns   *
    *                      null.                                   *
    ****************************************************************
    A task is started using the START command with data supplied.
    The task runs a Java program within a JVMSERVER.  The program
    uses the task's JCICS Task instance to call Task.retrieve()
    passing a BitSet with RetrieveBits.DATA set and an instance of
    RetrievedDataHolder.
    
    Next the RetrievedDataHolder's getValue() method is called to
    get the RetrievedData object.
    
    However when the RetrievedData object's getData() method is
    called null may be returned rather than a byte array containing
    the start data.
    
    This causes the Java program to fail unexpectedly.  This may
    include a java.lang.NullPointerException.
    

Problem conclusion

  • The JCICS Task retrieve() method has been updated to return the
    start data if the internal EXEC CICS RETRIEVE completes
    successfully.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH49108

  • Reported component name

    CICS TS Z/OS V6

  • Reported component ID

    5655YA100

  • Reported release

    400

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2022-08-30

  • Closed date

    2023-02-06

  • Last modified date

    2023-03-01

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

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

    UI90404

Modules/Macros

  • DFJ@H609 DFJDTCOE
    

Fix information

  • Fixed component name

    CICS TS Z/OS V6

  • Fixed component ID

    5655YA100

Applicable component levels

  • R400 PSY UI90404

       UP23/03/01 P F302

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"6.1","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
01 March 2023