Skip to content

Latest commit

 

History

History
50 lines (28 loc) · 2.87 KB

README.md

File metadata and controls

50 lines (28 loc) · 2.87 KB
Raw

Samples for the IBM z/OS CICS collection

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:

  1. 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.

  2. 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.

  3. 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.

  4. Resource lifecycle and CSD

    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.

  5. 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.

  6. Refresh tags

    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 the cmci_action module. This sample also documents how to determine the appropriate parameters for the cmci_action module for the action you're trying to run.

  7. Provisioning

    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.