Receiving data structure changes from a strong receiver

In this task, you create and execute a task ID.

Before you begin

The following Change Manager objects are required for this script:

To create a task ID

1. On the BMC AMI Change Manager for Db2 Main Menu, select CM/PILOT, and press Enter.
2. On the CM/PILOT Main Menu, select TASKIDs and press Enter.
3. On the TASKID Action Menu, type the name of a new TASKID and select Create a TASKID. Then, press Enter.
4. On the Script Selection List, select Receive data structure changes (strong receiver), create Baseline and then press Enter.
5. On the Create TASKID panel , specify the information for a task ID.
   1. CM/PILOT uses the name of the task ID as the name for a new alter-type work ID. You can type a different name for WORKID or type the name of a work ID name template.

   2. (Optional) Type the name of a CM/PILOT Application. An Application groups a set of Change Manager profiles. For more information about Applications, see Using-scripting-tools-to-automate-change-management.

      Tip

      If you frequently use this script to receive changes for the same Db2 application, you can create an inbound migrate profile with the change rules that you need, define it to a CM/PILOT Application, and then specify the Application each time that you create a task ID for this job.

   3. (Optional) Specify a Comment to describe the task ID.
   4. Press Enter. Press END.The task ID is created.

To execute the task ID

1. On the TASKID Action Menu panel, select Execute a TASKID and press Enter.
2. On the TASKID Interface panel, specify the data set names to be used by CM/PILOT.
   1. Type the data set name for the CM/PILOT Worklist.
   2. Type the data set name for the CM/PILOT JCL.
   3. Type the data set name for Diagnostics or type SYSOUT.
3. Select the method of executing the CM/PILOT worklist.For more information about executing a CM/PILOT worklist, see Processing-CM-PILOT-worklists.
4. (Optional) Override the options that are set in Change Manager.
   1. Type S to select Override Change Manager options and then press Enter.
   2. On the Override Change Manager Options panel, select Override Change Manager Options.

   3. Type S to select the Change Manager Analysis and Execution options that you want to override, and press Enter.For more information about the options, see Using-options-to-control-your-environment.

      Warning

      We do not recommend that you select the Autosubmit override option. This powerful option automatically submits the JCL, which is created from the CM/PILOT generated worklist to Execution. When you use the Autosubmit override option, use caution because any error in your specifications might cause significant damage to your schemas and a loss of data.

   4. Press END until the TASKID Interface panel is displayed.
5. On the TASKID Interface panel, create a CM/PILOT worklist.
   1. Type S to select Create Worklist. Then, press Enter.
   2. On the Step Settings panel, type S to select the steps in the script that you want to modify, and press Enter.
   3. To display subsequent Step Settings panels, press Enter.After the Step Settings panels are displayed, the Taskid Compare CDL Options panel is displayed.
6. On the Taskid Compare CDL Options panel, specify the object types and attributes for the comparison.
   1. Type Y or N for each object type that you want to include in or exclude from the comparison.
   2. Type S to display a list of the object attributes to include in or exclude from the comparison.
   3. On the Compare Object Attributes panel, if you selected to display a list of the object attributes, specify the object attributes.
      1. To include an object attribute in the comparison, type Y adjacent to the attribute.
      2. If you specified to include the partition attributes, you can exclude one or more of the partition attributes. Type N adjacent to the attributes that you want to exclude.
      3. Press Enter to return to the Compare CDL Options panel.
   4. On the Taskid Compare CDL Options panel, press Enter.
   5. (Optional) On the TASKID Migrate Profiles panel, specify the name of an outbound migrate profile. The outbound migrate profile can contain change rules and locations. Change Manager applies the rules after it performs the comparison (when it generates the CDL).
   6. (Optional) Specify the name of a second outbound migrate profile. The outbound migrate profile must contain change rules to resolve the names of the objects and creators. Change Manager applies the change rules to the objects before the comparison.
   7. (Optional) Specify the name of an inbound migrate profile. The inbound migrate profile can contain change rules. It can be used when the CDL that is generated from the comparison is imported.
   8. Press Enter.
   9. On the TASKID Baseline Profiles panel, type the name of the Baseline Profile to be used in this task ID or type a wildcard pattern and select a profile from the list. Then, press Enter.

   10. On the TASKID New Baselines panel, specify the information for the new baseline.

       Important

       If the baseline profile that you specified in Step 6.i uses a baseline profile template, the name of the template is displayed. To use the baseline profile template, do not specify the name of the baseline. To override the baseline profile template, type a name or a template for Baseline Name.

       If you are using baseline name templates to create names for baselines, the latest baseline that is created from the baseline profile that is specified for this script is used in the comparison step.

       1. (Optional) Type the name of a new baseline.
       2. To protect the baseline from deletion, type Y to select Protect.
       3. (Optional) Specify Comments to describe the baseline.
       4. Press Enter.
   11. On the TASKID Existing Baselines panel, specify the name of the baseline and press Enter.
   12. On the Change Manager Datasets panel, specify the DDL and CDL files, and the data set names to be used by the Import, Analysis, and Execution components of Change Manager. Then, press Enter until the TASKID Interface panel is displayed.

7. On the TASKID Interface panel, select your options for processing the CM/PILOT worklist.

   1. To edit the CM/PILOT worklist, type S to select Edit Worklist.
   2. To create the JCL to run the worklist, type S to select Create JCL.
   3. To review or modify the JCL, type S to select Edit JCL.
   4. To submit the JCL to run the CM/PILOT worklist, type S to select Submit JCL.
   5. Press Enter.

   CM/PILOT creates an Analysis worklist and the Execution JCL that is required to run the worklist.

8. To receive the data structure changes, execute the Analysis worklist.

   Important

   The JCL that you use to execute the Analysis worklist is contained in the data set that you specified for JCL Dataset Name in the Change Manager Datasets panel.