Defining an Execution REST API operation step

The following procedure describes how to define an Execution operation step for REST API. You can add many execution operation steps if required.

After completing Execution operation steps you can validate, test and then deploy the job type. For more information about deployment, see Job type deployment.

To define an Execution operation step:

1. Do the following:
   • In the Name field, type the name of the operation step.
   • (Optional) In the Description field type a description for the step which helps you identify the Execution step.
2. To run the operation step based on a specific event or condition, in the Conditions field, click and from the dropdown list select the parameters, as described in Condition parameters.

   NOTE: By default, the operation step only runs if the previous step succeeded. If you want the operation step to run regardless of the result of the previous operation, delete the condition by clicking.

3. In the Type field, from the dropdown list ensure that you select REST API.

   NOTE: To change the operation type, from the dropdown list select either Command Line or Web Service.

4. In the REST API field, click Add REST API URL and do one of the following:
   • To add a new REST API URL see Adding a REST API URL.
   • If you already defined, select the REST API URL.
5. If you want to edit the URL and/or want to add authentication, see Editing a REST API URL.
6. In the Method field, from the dropdown list select one of the Methods to be invoked.
7. Type the REST API parameters as described in REST API parameters.
8. In the Advanced Options section, add the options you require, as described in REST API Advanced options.
9. To define how the output should be handled, in the Output Handling field, click.

   For more information about Output Handling rules, see Output handling rules.

10. If you want to add job completion verification select the Verify operation completion checkbox.

    For more information about Verify operation completion, see Defining a Command Line job completion verification rule.

11. If you want to attach content to job output do any of the following:
    • To attach the REST API request to Control-M output, select the Append REST API request checkbox.
    • To attach the REST API response to Control-M output, select the Append REST API response checkbox.

    NOTE: If you want to change job content, from the toolbar, click Options.

12. (Optional) From the Execution operation step, click do one or more of the following:
    • To define how the job runs in the Monitoring domain, click Runtime information capture. For more information, see Defining a Command Line runtime data rule.
    • To define how to stop the job manually, click Manual abort operation. For more information, see Defining a Command Line manual abort operation rule.

    NOTE: You can also duplicate, clear content, add or delete a step. If you have created more than one Execution operation step, you can move the priority by clicking Move up or Move down.