Requirements

A control node is any machine with Ansible installed. From the control node, you can run commands and playbooks from a laptop, desktop, or server. However, you cannot run IBM z/OS core collection on a Windows system.

A managed node is often referred to as a target node, or host, and it is managed by Ansible. Ansible need not be installed on a managed node, but SSH must be enabled.

The nodes listed below require these specific versions of software:

Control node

Managed node

Note

Currently, the only supported shell is the z/OS® shell; this is because shells such as bash handle the reading and writing of untagged files differently. bash added enhanced ASCII support in 4.3 and thus differs from 4.2; we encourage users avoid using ansible_shell_executable to change the default shell as does Ansible documentation. Should the bash shell be the only shell available, you will need to control how new and existing files are tagged and encoded, this can be controlled by setting both “_ENCODE_FILE_NEW” and “_ENCODE_FILE_EXISTING”; for example,

  • _ENCODE_FILE_NEW: “IBM-1047”

  • _ENCODE_FILE_EXISTING: “IBM-1047”

Please review the README.ZOS guide included with the ported bash shell for further configurations.

Python on z/OS

If the Ansible target is z/OS, you must install IBM Open Enterprise Python for z/OS which is ported for the z/OS platform and required by IBM z/OS core Collection.

Installation

  • Visit the IBM Open Enterprise Python for z/OS product page for FMID, program directory, fix list, latest PTF, installation and configuration instructions.

  • For reference, the Program IDs are:

    • 5655-PYT for the base product

    • 5655-PYS for service and support

  • Optionally download IBM Open Enterprise Python for z/OS, here

  • For the Python supported version, refer to the release notes.

Note

Currently, IBM Open Enterprise Python for z/OS is the supported and recommended Python distribution for use on z/OS with Ansible and ZOAU. If Rocket Python is the only available python on the target, review the recommended environment variables for Rocket Python.

ZOAU

IBM Z Open Automation Utilities provide support for executing automation tasks on z/OS. With ZOAU, you can run traditional MVS commands, such as IEBCOPY, IDCAMS, and IKJEFT01, as well as perform a number of data set operations in the scripting language of your choice.

Installation

  • Visit the ZOAU product page for the FMID, program directory, fix list, latest PTF, installation and configuration instructions.

  • For reference, the Program IDs are:

    • 5698-PA1 for the base product

    • 5698-PAS for service and support

  • For ZOAU supported version, refer to the release notes.