This sample playbook demonstrates how to initialize a z/OS DASD volume and create, copy over, and submit JCL to a data set on the newly initialized volume using modules included in the Red Hat Ansible Certified Content for IBM Z core collection.
These playbook use:
collection:
ibm.ibm_zos_core
modules:
zos_volume_init
zos_data_set
zos_copy
zos_job_submit
zos_job_output
It is a good practice to review the playbook contents before executing them. It will help you understand the requirements in terms of space, location, names, authority, and the artifacts that will be created and cleaned up.
Important
The release of ibm_zos_core
collection version 1.10.0 introduced case-sensitive
changes to modules, specifically that module choices must be lower case. See the porting
guide in the release notes
(here)
to understand the full scope of these changes.
These changes are not compatible with earlier versions of the ibm_zos_core
collection,
and since the earlier versions do not reach their end of life until April 2025,
the sample playbook compatible with the older versions will remain available.
To support both the latest and prior versions of the collection:
- The
main
branch will reflect playbooks compatible withibm_zos_core
version 1.10.0 or later.- Find this playbook on the
main
branch: here.
- Find this playbook on the
- The
ibm_zos_core-v1.9.x-samples
branch will reflect playbooks compatible withibm_zos_core
version 1.9.x or earlier.- Find this playbook on the
ibm_zos_core-v1.9.x-samples
branch: here.
- Find this playbook on the
The ibm_zos_core-v1.9.x-samples
branch will remain available until April 2025 but will not receive updates.
This playbook requires:
- Configure the included inventory.yml with the
information from the managed z/OS host.
- Review inventory documentation
- Configure the included host_vars zos_host.yml
with the information from your z/OS system.
- Review host_vars documentation and any additional noted variables in the configuration.
ansible-playbook -i inventories init_dasd_vol_and_run_sample_jcl.yml
All changes are maintained chronologically by date found in the changelog.
© Copyright IBM Corporation 2023
Licensed under Apache License, Version 2.0.
Please refer to the support section for more details.