PH70766: UnsupportedOperationException when System.out.write() called in an OSGi JVM server with STDOUT directed to a DD card or job log

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When STDOUT (or STDERR) of an OSGi JVM server is redirected to a
  DD card or the job log, CICS code replaces the output stream
  with one we control in order to send the output through to JES.
  This logic was updated in the base code of CICS 6.3 to reduce
  its complexity but this causes
  "java.lang.UnsupportedOperationException: Call the print/println
  methods instead" when System.out.write() is called.
  
  Additional Symptoms and Keywords:
  KIXREVDAM Upgrade2CICS63
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: UnsupportedOperationException from      *
  *                      System.out.write() in an OSGi JVM       *
  *                      server when STDOUT is directed to a     *
  *                      DD card or job log.                     *
  ****************************************************************
  When a System.out.write() call occurs from a program running
  in an OSGi JVM server an UnsupportedOperationException:
  "java.lang.UnsupportedOperationException: Call the print/println
  methods instead"
  occurs if the STDOUT (or STDERR) is directed to a DD card or
  the job log.
  

Problem conclusion

• CICS has been updated so that the System.out.write() no longer
  results in an UnsupportedOperationException.
  
  A new informational message will be issued to the JVM server's
  STDOUT if System.out.write() is used whilst redirecting a DD
  card or job log:
  "CICS has detected that your application or logging code is
  using System.out.write() while JES/DD redirection is active.
  This combination causes unnecessary encoding overhead and
  reduces performance. Prefer System.out.print()/println() and
  prefer logs routed to zFS for best efficiencies."
  

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:

  UO07674

Modules/Macros

• DFJ@H427
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R600 PSY UO07674

     UP26/05/02 I 1000

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.