Installing and configuring the SMP/E format

The Program Directory for the product provides detailed specific installation requirements and instructions in Chapter 5 and Chapter 6. For information about the latest APAR fixes, see the Fix list for IBM® Open Enterprise SDK for Python.

The following checklist summarizes the key configuration steps for a successful installation.

Hardware requirements
  • z16™
  • z15®
  • z14®/z14 model ZR1
  • z13®/z13s®
  • zEnterprise® EC12/BC12
Software requirements
  • z/OS® UNIX System Services enabled on any of the following operating systems:
    • z/OS 2.4 or later
  • You must have an OMVS segment to run IBM Open Enterprise SDK for Python.
  • Optional: If you are on z13, you must enable Integrated Cryptographic Services Facility (ICSF) on your systems where IBM Open Enterprise SDK for Python runs. For more information, see ICSF System Programmer's Guide (SC14-7507) and ICSF Administrator's Guide (SC14-7506).
  • Optional: Packages that are installed with pip might include source that is written in other programming languages. It is your responsibility to ensure that compilers are available for other languages. For more information about IBM C/C++ for Open Enterprise Languages on z/OS 2.0, see Using IBM C/C++ compilers with IBM Open Enterprise SDK for Python 3.11 .
  • Optional: If you have z Integrated Information Processor (zIIP) configured on your z/OS system, then Python workloads can be run on zIIPs. The following APARS must be installed, otherwise Python will continue running on general processor.
    • BCP APAR OA63406 with PTF UJ92511 – HBB77C0 for z/OS 2.4
    • BCP APAR OA63406 with PTF UJ92512 – HBB77D0 for z/OS 2.5
    • Open Enterprise SDK for Python APAR PH52983

Configuration

IBM Open Enterprise SDK for Python is an OMVS-based application, which requires certain configuration on the z/OS UNIX System Services file system to ensure proper operation.
  • Validate that /usr/bin/env exists. If not configured, refer to the instructions in Customization and environment configuration.
  • Ensure that /tmp has at least 660 MB of disk space configured. To use an alternative file system, you can set the TMPDIR environment variable to a directory that has sufficient space.
Optional: This step is a requirement for running on the zIIP. You should verify if the Python shared library has been APF authorized by running the following:
extattr <path_to_python_install>/lib/python3.11/lib-dynload/libpyzutil.cpython-311.so
If APF authorization has not been set, as a user with appropriate privileges, run the following command to set APF authorization:
extattr +a <path_to_python_install>/lib/python3.11/lib-dynload/libpyzutil.cpython-311.so

Default installation location for IBM Open Enterprise SDK for Python

The default Python SMP/E installation location on z/OS is /usr/lpp/IBM/cyp/v3r11/pyz.

Environment variables for SMP/E installation

Set the following environment variables before using IBM Open Enterprise SDK for Python.

Configure the PATH and LIBPATH environment variables to include the bin directories for IBM Open Enterprise SDK for Python with the following commands: 

export PATH=/usr/lpp/IBM/cyp/v3r11/pyz/bin:$PATH
export LIBPATH=/usr/lpp/IBM/cyp/v3r11/pyz/lib:$LIBPATH
Set the auto conversion environment variables:
export _BPXK_AUTOCVT='ON'
export _CEE_RUNOPTS='FILETAG(AUTOCVT,AUTOTAG) POSIX(ON)'
Set the file tagging environment variables:
export _TAG_REDIR_ERR=txt
export _TAG_REDIR_IN=txt
export _TAG_REDIR_OUT=txt

When building packages with distutils or pip, you may encounter build errors related to the compiler argument processing. If you observe these errors while attempting to build a package or extension, see Using IBM C/C++ compilers with IBM Open Enterprise SDK for Python 3.11.