Documentation site | CICS collection on Galaxy | CICS collection on Automation Hub
This repository provides a number of samples that show how to use the CICS collection for real-life use cases:
-
Retrieving operational data from running CICS regions
The
reporting
sample gives a good overview of how to get started with the tasks provided by the CICS collection.This sample shows how to retrieve data from running CICS regions and format it for use in dashboarding or ad hoc analysis.
Because this sample only uses the HTTP-based CMCI REST API, it can easily be run from a workstation rather than needing any setup on z/OS.
-
Deploying a program to a CICS region
The
deploy_program
sample shows how you can copy a load module from a build data set to a library used by CICS, and then NEWCOPY the program in CICS.This sample uses the z/OS core collection in concert with the CICS collection, within the one playbook.
-
Customising when a CMCI module should fail
The
override_failure
sample shows how to override the default error when searching for a program that doesn't exist in CICS.The tasks provided by the CICS collection have automatic awareness of failure criteria, such as HTTP errors or actions being applied but zero resources matching the criteria. However, sometimes you want to override that behaviour and carry on despite a failure, as this sample shows.
-
The
resource_lifecycle_and_csd
sample shows how to perform full CICS resource lifecycle with the CMCI modules, creating and installing a definition from CSD. -
Custom CA for HTTPS connections
The
set_ca
sample shows how to use the CMCI modules with a custom CA bundle, typically useful when you have an internal CA. -
The
refresh_tags
sample shows how to instruct a CICS region to refresh its tags by re-reading the tags file on USS. This is achieved by using thecmci_action
module. This sample also documents how to determine the appropriate parameters for thecmci_action
module for the action you're trying to run. -
The
provisioning
sample shows how use the modules in the CICS collection to provision a CICS region from scratch.
These CICS samples are just some of the samples available for the Red Hat Ansible Certified Content for IBM Z. You can find samples covering other aspects at the root of the repository.