Affinity Build view

Use the Affinity Build view to view and edit the contents of a CICSPlex® SM Workload Manager (WLM) transaction group file. This file contains combined affinity transaction groups that are suitable for input to CICSPlex SM. You can also specify the deployment parameters, modify the CICSPlex SM input, review the JCL job, and deploy the transaction group definitions to CICSPlex SM.

When you build a CICSPlex SM WLM transaction group file, it is displayed in the Affinity Build view. See Building a CICSPlex SM Workload Manager transaction group file.

To view an existing CICSPlex SM WLM transaction group file, start from the Report Explorer view. Either double-click the file name, or right-click the file name, then click Open report.

Overview tab

The Overview tab shows the options specified for the builder and lists the combined affinity transaction groups that were created. You can expand each transaction group to show the group parameters, the transactions in the group, and which transaction groups were merged to create that group.

Affinity Build view: Overview tab

CPSM Input tab

The CPSM Input tab shows the transaction group definitions that can be built into files that can be deployed to CICSPlex SM. You can use this tab to specify parameters for the CICSPlex SM deployment job and modify the input to CICSPlex SM.

The following parameters are required to deploy the transaction group definitions to CICSPlex SM:
Data Set
The data set to store the transaction group definitions. If you have a z/OS® connection to your z/OS system, you can use the Open data set Open data set icon or Create data set Create data set icon icons to select or create a data set, respectively.
Member
The data set member to store the transaction group definitions.
CMAS Name
The name of the CMAS for the CICSplex to which you are deploying. Deployment updates the data repository for this CMAS.
Output user name
A 1- to 8-character user identifier to associate with the output from the deployment.
Print Node
A 1- to 8-character print node identifier to route the output from the deployment.
You can select one of the following radio buttons:
  • Check. Select this option to add a CHECK statement to the generated JCL. When you use the Deploy to CPSM option, the JCL is submitted to the z/OS system and the CICSPlex SM program checks the transaction group definitions.
  • Execute. Select this option to add an EXECUTE statement to the generated JCL. When you use the Deploy to CPSM option, the JCL is submitted to the z/OS system and the CICSPlex SM program deploys the transaction group definitions. This option is the default.
You can use the CPSM Definitions section to modify the input to CICSPlex SM:
  • To include or exclude specific objects from input to CICSPlex SM, select or clear the relevant check boxes.
  • To change the Affinity, Lifetime, State, or Match parameters for the TRANGRP resource, right-click on the CREATE TRANGRP NAME statement, then use the relevant menu options. For example, to change the Affinity parameter, click Set Affinity, then click the required value on the menu.
  • To change the Context, the Trangroup name, or the Transaction name, right-click on the name, then click Set Name. Type the new name in the resulting dialog, then click OK.
Affinity Build view: CPSM Input tab

Deployment JCL tab

The Deployment JCL tab shows the JCL job to submit to the z/OS system to either check the transaction group definitions or deploy them to the specified CMAS. The generated JCL uses the default values that are set in the CPSM Deployment preferences in the Preferences window, and the deployment parameters that you set on the CPSM input tab. See Deploying transaction group definitions to CICSPlex SM.

You can use the facilities of the JCL editor to view and edit this JCL. See Editing data sets.

Any change to a deployment parameter in the JCL that is on the CPSM Input tab is updated in the corresponding field on the CPSM Input tab. Similarly, any change to a deployment parameter on the CPSM Input tab is updated in the corresponding JCL on the Deployment JCL tab.

Affinity Build view: Deployment JCL tab

Toolbar

You can use the following icon in the toolbar of the view:
  • Deploy to CPSM icon Deploy to CPSM. When the deployment JCL includes the EXECUTE statement (the default), submit the JCL to the z/OS system to deploy the transaction group definitions to the specified CMAS. You must have a z/OS connection to your z/OS system. Before you use this option, ensure that you set the deployment parameters in this view, set the CPSM Deployment preferences in the Preferences window, and review the generated JCL on the Deployment JCL tab. See Deploying transaction group definitions to CICSPlex SM.

    When the deployment JCL includes the CHECK statement, submit the JCL to the z/OS system to check the transaction group definitions.