Skip to content

Latest commit

 

History

History
87 lines (61 loc) · 3.48 KB

README.md

File metadata and controls

87 lines (61 loc) · 3.48 KB

IBM z/OS CICS collection

The IBM z/OS CICS collection, also represented as ibm_zos_cics in this document, is part of the broader offering Red Hat® Ansible Certified Content for IBM Z. The IBM z/OS CICS collection supports tasks such as operating cics resources, operating cics csd, initialize cics catalog, process cics catalog.

The IBM z/OS CICS collection works closely with offerings such as the IBM z/OS core collection to deliver a solution that will enable you to automate tasks on z/OS.

Red Hat Ansible Certified Content for IBM Z

Red Hat® Ansible Certified Content for IBM Z provides the ability to connect IBM Z® to clients' wider enterprise automation strategy through the Ansible Automation Platform ecosystem. This enables development and operations automation on Z through a seamless, unified workflow orchestration with configuration management, provisioning, and application deployment in one easy-to-use platform.

The IBM z/OS CICS collection, as part of the broader offering Red Hat® Ansible Certified Content for IBM Z, is available on Galaxy as community supported.

For guides and reference, please visit the documentation site.

Features

The IBM CICS collection includes modules, sample playbooks, and ansible-doc to automate tasks on CICS.

Copyright

© Copyright IBM Corporation 2020

License

This collection is licensed under Apache License, Version 2.0.

If you're planning on using PyCharm, to deal with how Ansible Collections must be structured, you'll need to clone this repository to a specific path, and open {project_root} as your project in PyCharm: {project_root}/ansible_collections/ibm/ibm_zos_cics. E.g. I have this repository cloned to Users/stewf/cics-ansible/ansible_collections/ibm/ibm_zos_cics

Add ansible_pytest_collections plugin to PYTHONPATH for your python interpreter:

In PyCharm you can do this by: Preferences > Interpreters > Cog menu > Show all > Select your interpreter > Show paths for the selected interpreter (at the bottom) > Plus > add the path to the ansible_test pytest` plugin. For me this was in my venv:

{project_root}/ansible_collections/ibm/ibm_zos_cics/env/lib/python3.8/site-packages/ansible_test/_data/pytest/plugins

Make all pytest run configurations use ansible_pytest_collections:

  • Run Config Menu > Edit Configurations... > Templates > Python tests > pytest > Environment variables little button
  • Set ANSIBLE_COLLECTIONS_PATHS to whatever {project_root} is for you. I couldn't get this to resolve from a symbol unfortunately, so I have mine set to /Users/stewf/repos/cics-ansible
  • Set PYTEST_PLUGINS to ansible_pytest_collections

# Create a new venv called env
python3 -m venv env

# Activate env
source env/bin/activate

# Install requirements
pip install -r requirements.txt`

# Run unit tests
pytest tests/unit

Integration tests
You have to clone into {...}/ansible_collections/ibm/ibm_zos_cics to be able to run the test using ansible-test
See this issue: https://github.com/ansible/ansible/issues/60215

ansible-test integration cics_cmci --python=3.8