IBM Support

PH60060: [PYTHON] SANITIZE UNPRINTABLE CHARACTERS IN TEXT MODE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • This APAR includes a change that when reading output from
    Python will replace any characters with a space that
    are outside the UTF-8 code point. These characters do not
    correspond to UTF-8 requirements and are sanitized so that the
    resulting log can be printed. This will resolve any
    UnicodeDecodeError that would previously had occurred during job
    processing in Python.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of IBM Z Open Automation Utilities     *
    *                 (ZOAU) version 1.2.x                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: In the ZOAU Python language pack,       *
    *                      calling ZOAU APIs may result in output  *
    *                      that contains unprintable characters.   *
    *                      These can result from job output,       *
    *                      datasets, command responses, or log     *
    *                      output. These characters will cause a   *
    *                      UnicodeDecodeError to be raised in the  *
    *                      Python script during conversion to a    *
    *                      string.                                 *
    *                                                              *
    *                      This APAR detects these unprintable     *
    *                      characters and converts them to spaces  *
    *                      so an exception is no longer raised.    *
    ****************************************************************
    * RECOMMENDATION: APPLY APAR/PTF. Follow instructions in PTF   *
    *                  HOLDs.                                      *
    ****************************************************************
    This is a maintenance release with a single bug fix.
    It is a full replacement for all prior versions of ZOAU 1.2.x.
    

Problem conclusion

  • *****
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH60060

  • Reported component name

    Z OPEN AUTO UTL

  • Reported component ID

    5724T0753

  • Reported release

    120

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2024-02-27

  • Closed date

    2024-03-19

  • Last modified date

    2024-04-01

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

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

    UI96141

Modules/Macros

  • BGYPX001 BGYPX002 BGYPX003 BGYPX004 BGYPX005 BGYPX006 BGYPX007
    BGYPX008 BGYPX009 BGYPX010 BGYPX011 BGYPX012 BGYPX013 BGYPX014
    BGYSHZOA
    

Fix information

  • Fixed component name

    Z OPEN AUTO UTL

  • Fixed component ID

    5724T0753

Applicable component levels

  • R120 PSY UI96141

       UP24/03/21 P F403

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":"BU048","label":"IBM Software"},"Product":{"code":"SSKFYE","label":"IBM Z Open Automation Utilities"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"120","Line of Business":{"code":"LOB70","label":"Z TPS"}}]

Document Information

Modified date:
04 April 2024