Installing and configuring the PAX edition

The requirements for installing IBM® Open Enterprise SDK for Python 3.9 are listed below.
Hardware requirements
  • z15®™
  • z14®/z14 model ZR1
  • z13®/z13s®
  • zEnterprise® EC12/BC12
Software requirements
  • z/OS® UNIX System Services enabled on any of following operating system:
    • z/OS V2R3
    • z/OS V2R4, or later
  • You must enable the Integrated Cryptographic Services Facility (ICSF) on 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. By default, Python looks for /bin/xlc in UNIX System Services to compile C modules, and for both /bin/xlc and /bin/xlc++ to compile C++ modules. The Python interpreter by default uses /bin/xlc to link these modules.

Configuration

IBM Open Enterprise Python for z/OS 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 or more of disk space configured. To use an alternative file system, you can set the TMPDIR environment variable to a directory that has sufficient space.

Install the PAX archive file

  • 250 MB is required to download the PAX archive file.
  • Minimum 660 MB is required to extract and install Python.
  • Create a directory <mydir> to hold the extracted PAX files.
  • Unpax the downloaded file with the following command: 
    $ cd <mydir>
$ pax -p p -r -f <path to downloaded paxfile>

Environment variables for PAX archive 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=<path to install dir>/bin:$PATH
export LIBPATH=<path to install dir>/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, please see setting CCMODE step in Customization and environment configuration.