Raising an SAP event

About this task

You can raise events on XBP 2.0 (or later) SAP jobs in the HCL Workload Automation database in one of the following ways:
Using the Monitor Workload in the Dynamic Workload Console
Perform the following steps:
  1. On the SAP system, create a job that has as start condition a SAP event. When you create this job, its status is released.
  2. Check that this job was not intercepted by the interception function.
  3. Log in to the Dynamic Workload Console.
  4. From the Monitoring and Reporting menu, click Monitor Workload.
  5. In the Monitor Workload window select the engine, enter Workstation in the Object Type field, and select the plan to display the list of workstations you want to monitor. Click Run.

    A list of workstations is displayed.

  6. Select a workstation that has been defined to connect to a remote SAP system.
  7. From the toolbar, select More Actions > Raise Event. The Raise Event panel opens.
    Figure 1. The Raise Event panel

    The Raise Event panel
  8. The panel consists of the following:
    Event ID
    The identifier of the event that is to be raised.
    SAP Event Parameter
    The parameter of the event that is to be raised.
  9. Click OK. The event is raised.
Creating a job that launches a Windows or UNIX command that raises an event
Do the following:
  1. In the Dynamic Workload Console, select Design > Workload Design > Manage Workload Definitions.
  2. Specify an engine name, either distributed or z/OS. The Workload Designer window opens. Job types and characteristics vary depending on whether you select a distributed or a z/OS engine.
  3. In the Working List pane, select New > Job Definition .
  4. Select the Native category and then either Windows or UNIX.
  5. Use the General page to provide general information about the new job definition.
  6. Use the Task page to provide task information for the job.
  7. In the Task page, select Command and in the command string type the following command that raises the event:
    <data_dir>/methods/r3event -c workstation_name -u user_name 
    -e SAP_event_ID -p parameter
    where:
    workstation_name
    The name of the workstation where the SAP R/3 job is defined.
    user_name
    The name of the SAP user with which the access method connects to the SAP system. This is the name specified in the r3user option.
    SAP_event_ID
    The identifier of the event.
    parameter
    The parameter defined for the event.
  8. Save the job definition.

What to do next

See Defining conditions and criteria for information about how to define criteria that manages which raised events to log.