HCL Workload Automation, Version 9.4

Creating SAP Standard R/3 jobs from the Dynamic Workload Console

How to create and manage an SAP job that is associated to an HCL Workload Automation job that manages it.

About this task

You can easily create and manage Standard R/3 jobs on a remote SAP system entirely from the Dynamic Workload Console, and then continue to manage the remote SAP job from HCL Workload Automation.

The HCL Workload Automation job definition, available for both distributed and z/OS environments, maps to the newly created job on the SAP system. The SAP job can run on extended agent workstations, dynamic agent workstations, pools, dynamic pools, and workstations depending on the type of job definition you choose to create.

Note: Using this procedure to create a new IBM Workload Scheduler for z/OS Agent SAP Standard R/3 job, you cannot manage variants. To manage variants, use the SAP graphical user interface or use the List Jobs on SAP entry from the navigation tree of the Dynamic Workload Console.
To create a new SAP Standard R/3 job on a remote SAP system that maps to an HCL Workload Automation job definition, you have to associate your SAP Standard R/3 jobs to HCL Workload Automation jobs and you can do it in either of the following ways:

When performing operations that require a connection to a remote SAP system, you must configure the SAP connection data. The connection is made through an HCL Workload Automation workstation with the r3batch access method installed. Each workstation can have one or more options files that can be used to customize the behavior of the r3batch access method, except for extended agent workstations, where only one options file can be defined and therefore a selection is not required. For information about setting the SAP connection data, see Setting the SAP data connection.

Create an SAP job and associate it to an HCL Workload Automation job

How to create a new SAP job that is associated to an HCL Workload Automation job that manages it.

Before you begin

To be able to save your SAP job on a remote SAP system, you must specify the connection details. See Setting the SAP data connection.

About this task

To create a new SAP job and then associate it to a new HCL Workload Automation job, perform the following steps:

Procedure

  1. Click Administration > Workload Design > Manage Workload Definitions.
  2. Select an engine. The Workload Designer window is displayed.
  3. From the Working List pane, click New > Remote SAP R/3 Job:
    New SAP job
  4. In the Properties pane, specify the properties for the SAP job definition you are creating using the tabs available. The tabs for each type of SAP job definition are similar, but there are some differences depending on the type of engine you selected and the type of workstation on which the job runs. For more detailed information about the UI elements on each tab, see the Dynamic Workload Console online help.
  5. In the Details view, right-click the new job to add ABAP, External command or External program steps to it. It is mandatory to add at least one job step to the job before you can save the job:
    Add step to SAP job
  6. Right-click the SAP job and click Create SAP Job Definition to create a new HCL Workload Automation job associated to the new job on SAP. Select the job definition in accordance with the engine and type of agent on which the job runs.
    SAP
    For z/OS systems only. This job definition references an existing job on the SAP system and can run on dynamic agent workstations, dynamic pools, and IBM Workload Scheduler for z/OS Agent.
    SAP Job on Dynamic Workstations
    For distributed systems only. This job definition can run on dynamic agent workstations, dynamic pools, and IBM Workload Scheduler for z/OS Agent workstations.
    SAP Job on XA Workstations
    This job definition can run on extended agent workstations, which are workstations hosted by fault-tolerant agents or master workstations.
  7. Right-click the steps to move them and change their sequence.
  8. The HCL Workload Automation job definition opens in Workload Designer. Some fields in the Properties pane already contain information relating to the associated SAP job. Specify the remaining properties using the tabs available. The tabs for each type of SAP job definition are similar, but there are some differences depending on the type of engine you selected and the type of workstation on which the job runs. For more detailed information about the UI elements on each tab, see the Dynamic Workload Console online help.
  9. Click Save icon to save the SAP job definition in the HCL Workload Automation database.

Create an HCL Workload Automation job and associate it to an SAP job

Create an HCL Workload Automation job definition and map it to a new or existing SAP job to manage it.

About this task

To create a new HCL Workload Automation job and then associate it to a new SAP job, follow these steps:

Procedure

  1. Click Administration > Workload Design > Manage Workload Definitions.
  2. Select an engine. The Workload Designer window is displayed.
  3. From the Working List pane,
    • Click: New >Job Definition > ERP > SAP Job on...., choosing the type of workstation on which it is going to run:
      SAP Job on Dynamic Workstations
      For distributed systems only. This job definition can run on dynamic agent workstations, dynamic pools, and IBM Workload Scheduler for z/OS Agent workstations.
      SAP Job on XA Workstations
      This job definition can run on extended agent workstations, which are workstations hosted by fault-tolerant agents or master workstations.
      New SAP job
    • Click: New > ERP > SAP
      SAP
      For z/OS systems only. This job definition references an existing job on the SAP system and can run on dynamic agent workstations, dynamic pools, and IBM Workload Scheduler for z/OS Agent.
  4. In the Properties pane, specify the properties for the SAP job definition you are creating using the tabs available. The tabs for each type of SAP job definition are similar, but there are some differences depending on the type of engine you selected and the type of workstation on which the job runs. For more detailed information about the UI elements on each tab, see the Dynamic Workload Console online help.
  5. In the Task tab, specify the HCL Workload Automation job that you want to associate to the SAP job. If this job already exists, specify it in the Job name field, otherwise, click New to create it from new and specify its properties in the Properties pane.
  6. In the Details view, right-click the new job to add ABAP, External command or External program steps to it. It is mandatory to add at least one job step to the job before you can save the job:
    Add step to SAP job
  7. Save the job.
  8. After you have saved the SAP job, close the SAP job definition view or select the HCL Workload Automation job definition to assign the SAP job to it.
  9. In the Task pane, enter the details of the SAP job created before or use the picklist to retrieve the SAP job details from SAP
  10. Click Save icon to save the SAP job definition in the HCL Workload Automation database.

Creating an SAP job from the Dynamic Workload Console

How to create an SAP job definition on a remote SAP system from the Dynamic Workload Console.

About this task

You can also create and save SAP Standard R/3 jobs directly on the remote SAP system from HCL Workload Automation, as you would from the SAP graphical user interface. To create Standard R/3 jobs on the SAP system from the Dynamic Workload Console, perform the following steps:

Procedure

  1. Click Administration > Workload Design > Manage Jobs on SAP.
  2. In the Filter, select Standard R/3 Job and specify the workstation name. This parameter is mandatory because it identifies the remote SAP system.
  3. Specify the workstation where the SAP job runs. This is the workstation with the r3batch access method that communicates with the remote SAP system.
  4. If the workstation is not an extended agent workstation, you must also specify the options file to be used.
  5. Click Display to view a list of the Standard R/3 jobs for the specified workstation.
  6. Click New to create a new Standard R/3 job and enter the required information in the R/3 Job Definition and R/3 steps tabs.
  7. Click OK to save the job on the SAP system.

What to do next

After creating the new SAP job on the SAP from the Dynamic Workload Console, you must reference it in an HCL Workload Automation SAP Standard R/3 job if you want to manage the job from within HCL Workload Automation as explained in Create an HCL Workload Automation job and associate it to an SAP job.