IBM Support

PH39160: Issue DFHSJ0601 if com.ibm.cics.server.Container.put(java.lang.String stringData) is used

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • Issue DFHSJ0601 if the deprecated JCICS API
    com.ibm.cics.server.Container.put(java.lang.String stringData)
    is used in a JVMSERVER.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Issue DFHSJ0601 if                      *
    *                      com.ibm.cics.server.Container.put(java. *
    *                      lang.String stringData) is used.        *
    ****************************************************************
    The JCICS method
    com.ibm.cics.server.Container.put(java.lang.String stringData)
    has been deprecated since 2012. As such this method, and the
    other deprecated JCICS methods, may be removed in future
    releases of CICS.
    
    This APAR adds a new message, DFHSJ0601, which will be issued
    once per JVMSERVER instance if the
    put(java.lang.String stringData) method is called by an
    application.
    

Problem conclusion

  • New message DFHSJ0601 will be issued once if the deprecated
    com.ibm.cics.server.Container.put(java.lang.String stringData)
    method is used.
    
    The full list of deprecated JCICS methods can be found in the
    'Changes to the JCICS API' topic in IBM Documentation and the
    'Deprecated' Javadoc page.
    
    The IBM Documentation will be updated to add new message
    DFHSJ0601.
    
    date time applid JVMSERVER jvmserver tranid program_name JCICS
    method 'Container.put(String)' has been called by method_name.
    This form of the put method is deprecated and should be changed
    to 'Container.putString(String)'. This message will not be
    issued again for this JVM server.
    
    Message Explanation
    The JCICS method 'Container.put(String)' is deprecated and will
    be removed in a future release of CICS
    
    System Action
    This message will not be issued again for this JVM server.
    
    User Response
    You should review all of your Java applications and change them
    to use 'Container.putString(String)' rather than the deprecated
    (and soon to be removed from CICS) 'Container.put(String)'
    method. The Java compiler will issue deprecation warning
    messages of its own if you attempt to recompile the application
    without making the necessary change. You may rely on this
    behavior to help identify the source of the problem.
    
    Module
    com.ibm.cics.server.Container
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH39160

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2021-07-21

  • Closed date

    2021-11-25

  • Last modified date

    2021-12-01

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

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

    UI78257 UI78258 UI78259 UI78260

Modules/Macros

  • DFHMESJC DFHMESJE DFHMESJK DFJ@H356 DFJ@H468
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R100 PSY UI78259

       UP21/11/30 P F111  

  • R10D PSY UI78260

       UP21/11/30 P F111  

  • R200 PSY UI78258

       UP21/11/30 P F111  

  • R300 PSY UI78257

       UP21/11/30 P F111  

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.

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

Document Information

Modified date:
02 December 2021