Home
Scheduling Job Integrations with HCL Workload Automation
Integration with SAP
Access method for SAP
The SAP R/3 batch access method enables communication between an external SAP R/3 system and HCL Workload Automation and provides a single point of entry for automating the launching of jobs, monitoring the status of jobs and managing exceptions and recovery.
Job interception and parent-child features
This section describes how the job interception and parent-child features of BC-XBP 2.0 and 3.0 are supported by HCL Workload Automation.
Implementing job interception
The high-level steps required to implement job interception.
Collecting intercepted jobs periodically for BC-XBP 3.0
With the BC-XBP 3.0 interface, you can configure the job interception collector using an HCL Workload Automation job that periodically retrieves intercepted jobs and relaunches them.

Scheduling Job Integrations with HCL Workload Automation
- Job integrations to extend workload scheduling capabilities
- Access methods
- Integration with SAP
  - Introducing HCL Workload Automation for SAP
    Improve SAP operations and enable business growth with HCL Workload Automation.
  - Access method for SAP
    The SAP R/3 batch access method enables communication between an external SAP R/3 system and HCL Workload Automation and provides a single point of entry for automating the launching of jobs, monitoring the status of jobs and managing exceptions and recovery.
    - Scheduling process for the agent workstation hosting the r3batch access method
    - Roles and responsibilities
    - Configuring user authorization (Security file)
    - Configuring the SAP environment
      You must configure the SAP environment before using the SAP access method.
    - Configuring the SAP access method
      This section provides detailed information about the SAP options file creation.
    - Defining SAP jobs
      You must define some jobs to be able to run jobs on an SAP workstation from HCL Workload Automation.
    - Managing SAP jobs
      This section describes how to manage SAP jobs.
    - Defining SAP jobs dynamically
      This section describes how to create and submit SAP jobs dynamically without creating or referencing predefined job templates.
    - Defining conditions and criteria
      HCL Workload Automation accesses the Computer Center Management System (CCMS) Background Processing components of SAP systems through the BC-XBP interface to provide additional capabilities from the Dynamic Workload Console, one of those being the Criteria Manager.
    - Using the BDC Wait option
      By using the Batch Data Collector (BDC) Wait option, you can specify that a SAP job launched by HCL Workload Automation is not to be considered complete until all of its BDC sessions have completed.
    - Job interception and parent-child features
      This section describes how the job interception and parent-child features of BC-XBP 2.0 and 3.0 are supported by HCL Workload Automation.
      - Implementing job interception
        The high-level steps required to implement job interception.
        Collecting intercepted jobs periodically for BC-XBP 2.0
        With the BC-XBP 2.0 interface, you can configure the job interception collector using an HCL Workload Automation job that periodically retrieves intercepted jobs and relaunches them.
        Collecting intercepted jobs periodically for BC-XBP 3.0
        With the BC-XBP 3.0 interface, you can configure the job interception collector using an HCL Workload Automation job that periodically retrieves intercepted jobs and relaunches them.
        Setting interception criteria on the SAP system
        Setting interception criteria on HCL Workload Automation
        Activating the job interception feature
        Activate the job interception feature for the appropriate BC-XBP interface.
      - The parent-child feature
    - Using Business Information Warehouse
      Business Information Warehouse (BIW) is a data warehouse solution tailored to SAP.
    - Job throttling feature
      Learn how the job throttling feature helps you to improve the efficiency of your scheduling on SAP systems and reduce the batch window for your SAP jobs to a minimum.
    - Exporting SAP factory calendars
      This section describes how to export SAP factory calendars into a file format that can be processed by the HCL Workload Automation composer command line, to add the exported calendar definitions to the HCL Workload Automation database.
    - Defining internetwork dependencies and event rules based on SAP background events
      This section describes how to define internetwork dependencies and event rules for HCL Workload Automation based on SAP background events.
    - Defining event rules based on IDoc records
      You can use HCL Workload Automation to monitor Intermediate Document (IDoc) records in SAP systems and forward events to the HCL Workload Automation event integration framework.
    - Defining event rules based on CCMS Monitoring Architecture alerts
      Use CCMS functions to check the performance of the various SAP system components, diagnose potential problems, and be alerted about error and warning conditions.
    - National Language support
      The National Language support feature allows you to install SAP on a localized HCL Workload Automation workstation and use localized characters for HCL Workload Automation job names, job streams, and SAP variants.
    - Troubleshooting
      Learn what to do if you get any problems while installing or using HCL Workload Automation access methods or plug-ins.
  - Scheduling jobs on HCL Workload Automation from SAP Solution Manager
    HCL Workload Automation and SAP Solution Manager are integrated to allow the HCL Workload Automation engine to run the job scheduling tasks available from the Solution Manager user interface.

Collecting intercepted jobs periodically for BC-XBP 3.0

With the BC-XBP 3.0 interface, you can configure the job interception collector using an HCL Workload Automation job that periodically retrieves intercepted jobs and relaunches them.

About this task

Because intercepted jobs remain in the Released and then Intercepted status until they are relaunched, you need to use the SAP interception collector task to collect and relaunch them.

To use the job interception collector BC-XBP 3.0 to collect and restart jobs, create the r3batch_icp folder in the TWS_home/methods/ path with the correct access rights.

To define an HCL Workload Automation job that collects and relaunches jobs use the following syntax:

ENGINE_NAME_HOSTING_XA#[folder/]JOBNAME
DOCOMMAND "TWA_home/methods/r3batch -t HIJ -c UNIQUE_ID -- \
   "-profile_id profile_ID_number\""
STREAMLOGON TWSuser
DESCRIPTION "Collects intercepted jobs on SAP XA XA_Unique_ID"
TASKTYPE UNIX
RECOVERY STOP

where,

ENGINE_NAME_HOSTING_XA: The name of the engine workstation hosting the XA workstation with the r3batch access method that communicates with the SAP system.
JOBNAME: Name of the HCL Workload Automation job and the folder within which it is defined, if any.
TWA_home: Fully qualified path to your HCL Workload Automation installation.
XA_Unique_ID: The unique identifier for the extended agent workstation. See UNIQUE_ID for more details about retrieving the unique identifier.
–t HIJ: This is the SAP task type to run the job interception collector. HIJ stands for Handle Intercepted Jobs.
- profile_id profile_ID_number: Specifies the identification number of the interception criteria profile on the SAP system for XBP 3.0.
TWSuser: Name of the HCL Workload Automation user that launches the access method.

The interception collector job runs at periodical intervals; for example, every 10 minutes. It retrieves all the jobs that have been intercepted since the last run of the interception collector, and launches them again according to a template.

Note: If the interception collector is configured for XBP 3.0 job interception, but the XBP 2.0 interface is configured on the SAP system, the collector fails. Ensure the XBP interface versions are synchronized.