IMS managed ACBs workflow for z/OSMF

Overview

You can rapidly enable IMS™ management of application control blocks (ACBs) by using the IBM® z/OS® Management Facility (z/OSMF) with this z/OSMF workflow sample.

IMS can manage the runtime ACBs for databases and program views for you. When IMS manages ACBs, IMS no longer requires DBD, PSB, and ACB libraries.

The workflow will enable IMS managed ACBs on an existing IMS with these steps:

• Create the IMS DFSDFxxx proclib members to enable IMS catalog with managed ACBs.
• Update the catalog database if needed.
• Create the IMS catalog directory data sets.

As an optional step, the workflow can also create an image copy of the HALDB catalog database.

Pre-requisites

• An SMP/E installation of IMS is done and the IMS load libraries are available.
• Identify the z/OS system parameters.
• IMS SVC modules are installed on the system.
• The Common Service Layer must be started.
• z/OSMF must be started. Both the angel and server z/OSMF address spaces must be started.
• The IMS catalog has been enabled.

Security requirements

To run the workflow, you need the following authority:

• RACF READ authority on SMP/E-installed IMS libraries.
• RACF UPDATE authority on the high-level qualifiers (HLQs) you are using for the IMS instance libraries.
• Authority to ADD or DELETE APF authorizations.

Package structure

The repository includes the following files:

• setUpManagedACB.xml
  • This workflow XML enables IMS managed ACBs. Do not modify this file.
• workflow_variables.properties
  • This properties file contains values for the variables referenced in the setUpManagedACB.xml workflow. Edit the workflow_variables.properties file to specify the system specific information for the variables in the file.

Installation

• Use FTP to transfer the setUpManagedACB.xml workflow and the workflow_variables.properties file to USS on the z/OS host in binary mode.
• Make these files visible to the z/OSMF application. Do this by changing the access permissions of the files using the chmod command.
  • Example chmod commands:

    chmod 755 setUpManagedACB.xml

  • Or if the file is in a folder with the name of workflows:

    chmod -R 755 workflows

Steps to run the workflow using the z/OSMF web interface

1. Log into the IBM z/OS Management Facility web interface.
2. Select Workflows from the left menu.
3. Select the Actions drop down menu.
4. Select Create Workflow.
5. In the Create Workflow dialog, specify the following information:
   • Workflow definition file
   • Workflow variable input file
   • System
6. Select Next.
7. Select Assign all steps to owner user ID if you are going to run all of the workflow steps with the current user ID.
8. Select Finish.
9. Right-click the first action and select Perform.

For more information about running a workflow see Creating a workflow in the IBM Knowledge Center.

Troubleshooting

• IZUWF0105E Workflow property file file-name is either not found or cannot be accessed
  • Typically, this error occurs when the file does not exist at the given path. If the file does exist, access permission to the file must be set by using the chmod command.
• If there is no Workflows menu option in the z/OSMF web interface configure the IZUPRMxx member in SYS.PARMLIB to specify the WORKLOAD_MGMT in the PLUGINS statement. For more information see creating a IZUPRMxx in the IBM Knowledge Center.

  • Example:

    PLUGINS(INCIDENT_LOG  
    COMMSERVER_CFG
    CAPACITY_PROV 
    SOFTWARE_MGMT 
    ISPF          
    RESOURCE_MON  
    WORKLOAD_MGMT)
    

z/OSMF documentation

Visit the IBM Knowledge Center for more information on IBM z/OS Management Facility.