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:
IBM z/OS core collections are dependent on specific versions of ZOAU. For information about the required version of ZOAU, review the release notes.
The z/OS® shell
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
bash added enhanced ASCII support in 4.3 and thus differs
from 4.2; we encourage users avoid using
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,
Please review the README.ZOS guide included with the ported
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.
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.
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.
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.