Update
NetMaster
Run-time Code with a z/OSMF Workflow

Use a z/OSMF workflow to update the run-time code of
NetMaster
products.
Required roles: systems programmer
If you configured one or more NetMaster products with the CC2DZWC1 workflow, you can use a second workflow, CC2DZWU1, to update the generated run-time code with code from the most current SMP/E environment. Specifically, the workflow executes the following steps:
  1. Creates .NEW data sets and populates them with the latest SMP/E code.
  2. Deletes .OLD data sets (if present from a prior run).
  3. Renames the current named run-time datasets to .OLD
  4. Renames .NEW datasets to current run-time named datasets.
The z/OSMF workflow updates:
  • The CC2DPLD, CC2DMAPO, CC2DLINK, and CC**EXEC MVS libraries
  • ****DIS related code
  • The
    nmInterface
    USS directory
Run the CC2DZWU1 workflow after you have applied maintenance to your SMP/E environment, and it is ready for roll-out to a run-time environment. The general process of running the update workflow is identical to the configuration workflow, with the same registration and execution steps. And, as withe the configuration workflow, the update workflow can utilize a properties file to automatically fill in variables.

Update Workflow Prerequisites

  • Complete the configuration workflow.
  • Prior to starting the update workflow, stop the
    NetMaster
    Region and
    SOLVESSI
    tasks.

Register the Workflow

  1. Log in to the z/OSMF web interface.
  2. Ensure that your JOB statement is updated, as described in the IBM Knowledge Center article on customizing JOB statements.
  3. Select
    Workflows
    from the navigation tree (classic interface), or click the
    Workflows
    icon (desktop interface).
  4. Select
    Create Workflow
    from the
    Actions
    menu. The
    Create Workflow
    panel appears.
  5. Enter the system name in the
    Location (system) of definition and variable input files
    field. 
  6. Enter the data set with member name
    dsnpref.NMC2.CC2DXML(CC2DZWU1)
    in the
    Workflow definition file
    field.
  7. Optionally, if you used a properties file for the configuration workflow, it can be re-used for the update workflow. Enter the data set with the member name in the
    Workflow variable input file
    field.
  8. Click
    Next
    .
  9. Enter a unique
    Workflow name
    .
  10. Enter the
    Owner user ID
    .
  11. Select
    Assign all steps to owner user ID
    .
  12. Click
    Finish
    . The steps for the newly registered workflow display, and the workflow is available to execute for NetMaster deployment and configuration.

Execute the Workflow

The z/OSMF update workflow can be entirely automated, depending on your preferences. After you complete the first non-automated step,
Workflow Overview and Variable Definition
, the configuration process can be completed without further action, assuming that there are no errors.
To initiate the automated process, you must select the step (
Create SMP/E code copy Run-Time libraries
in this case), and then select
Perform
from the
Actions
menu. If you click the link for a step, and then use the
Perform
tab, the step completes, but the next steps will not proceed automatically. The steps below describe the automated process.
To execute the workflow, and configure your Netmaster product(s), follow these steps:
  1. From the workflow steps display, click the link for the first step,
    Workflow Overview and Variable Definition
    .  The view opens to the workflow description on the
    General
    tab.
  2. Review the workflow description.
  3. Click the
    Perform
      tab. The
    Input Variables - Data Set Names
    view displays.
    • If you entered a properties file in the registration process, the
      Data Set Names
      fields, as well as all of the other variables (e.g.,
      Storage
      ) will be filled in; click
      Next
      at each window to review the variable settings. When finished, proceed to step 6 below.
    • If you did not specify a properties file during registration, enter the data set names, and continue with step 4.
  4. Click
    Next
    . The next set of input variables,
    Storage
    appears.
  5. Enter all of the required information (indicated by red asterisks), and click
    Next
    . The
    Review Information
    view displays.
  6. Click
    Finish
    . The view returns to the workflow steps, and step 1 should display as
    Complete
    , while step 2 should display as
    Ready
    .
  7. Select step 2,
    Create .NEW SMP/E code copy Run-Time libraries
    .
  8. De-select step 1,
    Workflow Overview and Variable Definition
    .
  9. From the
    Actions
    menu, or by right-clicking on the link, select
    Perform
    . The
    Perform Automated Step
    dialog appears.
  10. Keep the default option -
    Automatically perform the selected step, and all subsequent automated steps, according to their declared step dependencies, until one of the following occurs...
    and click
    Ok
    . The workflow steps re-appear. To track the automated progress, as the steps change from
    Ready
    to
    Complete
    , click
    Refresh
    .  When all the steps display as
    Complete
    , the workflow is finished, and your NetMaster run-time environment will be available.