Changes made in z/OSMF Version 2 Release 1, SA32-1066-03

This document contains information that was previously presented in IBM z/OS Management Facility Programming, SA32-1066-02, which supported IBM® z/OS® Management Facility Version 2 Release 1. This document contains new or revised information for APAR PI32148 and the corequisite APARs.

New information

New functionality is available for z/OSMF V2R1 when you install APAR PI32148 and the corequisite APARs. For instructions on installing this service on your system, check the ++HOLD actions for the associated program temporary fix (PTF).

New Representational State Transfer (REST) services are added to enable communication and data transfer between systems within your enterprise. The new services allow a caller to:

Retrieve data from one system, a list of systems, or all the systems in a group
Update data for one system, a list of systems, or all the systems in a group
Delete data from one system, a list of systems, or all the systems in a group
Authenticate with a secondary z/OSMF instance.

For more information, see Multisystem routing services.

New REST services are added to allow a client application to interact with the z/OSMF Software Management task. The new services allow a caller to:

List the software instances that are defined to z/OSMF
Retrieve the properties of a software instance
Add a new software instance.

For more information, see Software management services.

New REST services are added for working with the groups, sysplexes, and systems that are defined to z/OSMF. The new services allow a caller to:

List the systems that are defined to z/OSMF
List the groups that are defined to z/OSMF
List the systems included in a group
List the sysplexes that are defined to z/OSMF
List the systems included in a sysplex.

For more information, see Topology services.

New REST services are added for creating and managing a workflow on a z/OS system. The new services allow a caller to:

Create a workflow
Get the properties of a workflow
List the workflows for a system or sysplex
Start a workflow
Cancel a workflow
Delete a workflow
Retrieve a workflow definition.

For more information, see z/OSMF workflow services.

A workflow step can be designed to call another workflow for execution. Here, the target workflow is referred to as a called workflow. Conceptually, a called workflow is simply another step in the workflow that calls it. For more information, see Calling steps.

Enhancements are made to the Workflows task schema that is supplied with z/OSMF. This file provides the XML syntax and rules for creating a workflow definition. The Workflows task schema is described in Workflow XML reference.