Use IBM z/OSMF to automate IBM MQ
The IBM z/OS Management Facility (z/OSMF) provides system management functions in a task-oriented, web browser-based user interface with integrated user assistance, so that we can more easily manage the day-to-day operations and administration of our mainframe z/OS systems.
By streamlining some traditional tasks and automating others, z/OSMF can help to simplify some areas of z/OS system management.
Resources can be provisioned or de-provisioned, at a click of a button, from a user provided portal. z/OSMF provides REST APIs to help with this task.
The sample marketplace portal supplied with z/OSMF can also be used to provision and de-provision resources. Alternatively, more experienced users can use the z/OSMF Web User Interface (WUI).
This section assumes that you understand z/OSMF, but if we are unfamiliar with z/OSMF we should read Getting started with z/OSMF. Alternatively, we can access this section from the z/OSMF WUI online help.
We should familiarize yourself with z/OS Cloud configuration, that is:
- Cloud Provisioning - Resource Management and Software Services
- Configuration- Configuration Assistant, and Performance - Workload Management, and
- Performance - Workload Management
Details of these, together with a Getting Started Tutorial - Cloud, are in the What's New in this Release section. z/OSMF Version 2.2 introduces role based activities and tasks, so it is important that you understand concepts like:
- domains
- administrators
- approvers
- tenants
- templates
- instances
- workflows
and so on. Refer to Cloud Provisioning in the z/OSMF Programming Guide, or in the z/OSMF WUI help.
Sample IBM MQ z/OSMF workflows and associated files are provided, and can be installed as part of the IBM MQ for z/OS UNIX System Services Components feature. The installation process for this feature, and the directory and file structure, are described in the IBM MQ for z/OS Program Directory. Program Directories can be downloaded from the IBM Publications Center (see IBM MQ for z/OS Program Directory PDF files).
The sample workflows are written in XML and demonstrate how to automate the provisioning (creation) or de-provisioning (destruction) of IBM MQ queue managers, channel initiators, and local queues, and how to perform actions against the provisioned IBM MQ resources. Steps within the workflows submit jobs (JCL), run REXX execs, process Shell scripts, or issue REST API calls.
The samples are designed to illustrate the types of function that can be achieved using z/OSMF. It is anticipated that z/OSMF workflows will generally be used to provision resources and actions like put or get message will, in essence, be performed using IBM MQ applications.
We can run the sample workflows as supplied, provided the workflow variable properties have been set (as discussed in the following sections), or we can customize them as required. We might prefer to write your own workflows to perform additional function. Before running the sample workflows see:Sample workflow applications are provided to:
- Automate the provisioning or de-provisioning of IBM MQ queue managers and perform actions against the provisioned queue managers
- Automate the provisioning or de-provisioning of IBM MQ local queues and perform actions against the provisioned queues.
- Prerequisites for z/OSMF
The prerequisites you require to run IBM z/OS Management Facility (z/OSMF) with IBM MQ- Security settings
The security settings required to run z/OSMF.- Limitations
Limitations when using z/OSMF with IBM MQ.- Automate the provisioning of IBM MQ objects
Samples are supplied to automate the provisioning of queue managers and local queues.- Running workflows
A description of the files referenced by the sample The z/OSMF workflows, and how you run a workflow.Parent topic: Configure queue managers on z/OS
Related concepts