Building a CICSPlex SM Workload Manager transaction group file

You can build a CICSPlex® SM Workload Manager (WLM) transaction group file in XML format that contains affinity-transaction-group definitions that are suitable for input to CICSPlex SM. To build a CICSPlex SM WLM transaction group file, you use the Report Explorer view.

About this task

Before you build a CICSPlex SM WLM transaction group file, you must create one or more affinity reports, which contain affinity transaction groups. The builder uses the affinity reports and combines affinity transaction groups that contain the same transaction identifier so that the resulting CICSPlex SM WLM transaction group file is suitable for input to CICSPlex SM. You can combine affinity reports that were created for the same CICS® workload, and CICSPlex SM WLM transaction group files that were built previously, into a CICSPlex SM WLM transaction group file.

Procedure

  1. From the Report Explorer view, use one of the following methods to open the Build CPSM WLM Transaction Groups wizard.
    • Click the Build CPSM WLM Transaction Groups icon Build CPSM WLM Transaction Groups icon.
    • Select one or more affinity reports, CICSPlex SM WLM transaction group files, or folders that contain these reports or files, right-click a selected report, file, or folder, then click Build CPSM WLM Transaction Groups.
    The currently selected reports or files are also selected in the Build CPSM WLM Transaction Groups window. If required, you can change your selection in the next step.
  2. Select the affinity reports and any existing CICSPlex SM WLM transaction group files that you want to build into a CICSPlex SM WLM transaction group file. The reports or files you select must be for the same CICS workload.
  3. Optional: In the Context field, specify the name of the CICSplex with which you want to associate the affinity transaction groups in the CICSPlex SM WLM transaction group file. For further details, see Editing the CIUAFFBL job in CICS Interdependency Analyzer product information.

    If you specify a context, a CICSPlex SM CONTEXT statement is generated and CICSPlex SM uses this statement to associate the affinity transaction groups with the specified CICSplex. If you do not specify a context, a CICSPlex SM CONTEXT statement is not generated and CICSPlex SM associates the affinity transaction groups with the local CICSPlex SM address space (CMAS).

  4. In the Match section, specify the filter that CICSPlex SM uses for workload separation for this CICSPlex SM WLM transaction group file.
    You can select from the following options:
    • LUNAME
    • USERID
    For details, see Editing the CIUAFFBL job in CICS Interdependency Analyzer product information.
  5. In the State section, select whether the affinity transaction groups are defined as active or dormant to CICSPlex SM for this CICSPlex SM WLM transaction group file.

    For details, see Editing the CIUAFFBL job in CICS Interdependency Analyzer product information.

  6. When your selections are complete, click Finish.

    Report generation begins and a message is displayed in the Status bar. When generation is complete, the results are displayed in the New Affinity Build view.

  7. Optional: Use the CPSM Input tab and Deployment JCL tab to specify parameters for the CICSPlex SM deployment job, modify the input to CICSPlex SM, and review the generated JCL.

    For details, see Deploying transaction group definitions to CICSPlex SM.

  8. To save the CICSPlex SM WLM transaction group file, click the Save icon Save icon on the workbench toolbar. Use the Save Affinity Builder Output window to specify a name and location for the file, then click OK. The saved CICSPlex SM WLM transaction group file is listed in the Report Explorer view.

What to do next

You can deploy the transaction group definitions in the CICSPlex SM WLM transaction group file to a CICSplex. See Deploying transaction group definitions to CICSPlex SM.