Configure CA IDMS Using z/OSMF Workflows

After you install CA IDMS on a mainframe system, you can use z/OSMF workflows to configure the product software instance. z/OSMF workflows help automate the deployment and configuration of a product instance. z/OSMF helps system programmers with minimum mainframe experience perform these tasks. Using z/OSMF workflows significantly reduces the time that is required to perform these tasks.
The workflow configuration of a CA IDMS environment follows the same post installation process. z/OSMF provides the flexibility of a menu-driven GUI to input the required variables. The variables are populated into the job stream. Job streams can be modified before submission and can be executed again if the job fails. 
CA IDMS provides three configuration workflows that perform the following tasks:
  • Perform a full base configuration (AGJ190BX)
  • Upgrade an existing configuration to a new release (AGJ190UX)
  • Add-on new product components to an existing configuration (AGJ190AX)
To configure your product using z/OSMF workflows, complete the following tasks:
Address z/OSMF Prerequisites
Ensure that your site has configured z/OSMF as described in the IBM Knowledge Center and addressed the z/OSMF security requirements for CA ACF2, CA Top Secret, or IBM RACF as applicable. Apply all z/OSMF related product maintenance to ensure that the workflows are available for use.
Register the Workflow
To make the product workflows available for execution, you must first register them in z/OSMF as described in the following procedure. This task is typically performed by an experienced systems programmer.
Follow these steps:
  1. Log in to the z/OSMF web interface and select
    Use Desktop Interface
    .
  2. Select the
    Workflows
    tile.
  3. Select
    Create Workflow
    from the
    Actions
    menu.
    The Create Workflow panel appears.
  4. Enter the data set name and member of the workflow that you want to register in the
    Workflow Definition File
    field.
    This information is the CA IDMS SMPE target data set for XML elements (identified by a last node of “.CAGJXML”) and the member of your chosen configuration method. For example, if the SMPE prefix you chose for CA IDMS data sets is CAI.IDMS190 and you want to do an upgrade configuration workflow, enter
    CAI.IDMS190.CAGJXML(AGJ190UX)
    . Do not enclose the data set name in quotes.
  5. Select the
    System
    where the workflow runs.
  6. Select
    Next
    .
  7. Specify a unique
    Workflow name.
  8. Select or enter an
    Owner user ID
    , and select
    Assign all steps to owner user ID
    .
  9. Select
    Finish
    .
The workflow is registered in z/OSMF. The workflow is available for execution to deploy and configure your product.
Execute the Workflow
The following procedure describes how to execute the steps in the workflow to create a configured instance for your product.
Before you execute the workflow steps, you must provide a valid JOB statement that includes your ACCOUNTINFO and MSGCLASS information. Do not use the default MSGCLASS value. For more information about customizing the JOB statement for z/OSMF workflows, see the IBM documentation.
Follow these steps:
  1. Log in to the z/OSMF web interface and select
    Use Desktop Interface
    .
  2. Select the
    Workflows
    tile.
  3. Select your product workflow that you registered from the workflow list.
    The required steps for execution are listed.
  4. Execute the steps in order.
    For general information about how to execute z/OSMF workflow steps, refer to the IBM documentation.
  5. Perform the following steps to execute each step individually:
    1. Double-click the title of the step.
    2. Select the
      Perform
      tab.
    3. Review the step contents and update the input values as required.
    4. Select
      Next
      .
    5. Repeat step c and step d to complete all items until the option
      Finish
      is available.
    6. Select
      Finish
      .
      After you execute each step, the step is marked as
      Complete
      .
The workflow is executed and your product is configured.
Next Step
After you complete configuration of your product with z/OSMF workflows, start and verify the instance. For more information, see Post-Configuration Tasks.