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.
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.

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.
    - 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.

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.

About this task

The Batch Data Collector (BDC) Wait option prevents other HCL Workload Automation jobs that are dependent on the SAP job from being launched until all of the related BDC sessions for the SAP job have ended.

To use the option, a SAP job must write informational messages in its job log. This can be done by modifying the SAP function module BDC_OPEN_GROUP as follows:

FUNCTION BDC_OPEN_GROUP.
... 
CALL 'BDC_OPEN_GROUP' ID 'CLIENT'      FIELD CLIENT
                      ID 'GROUP'       FIELD GROUP
                      ID 'USER'        FIELD USER
                      ID 'KEEP'        FIELD KEEP
                      ID 'HOLDDATE' 	  FIELD HOLDDATE
 			             ID 'DESTINATION' FIELD DEST
 			             ID 'QID'         FIELD QID
 			             ID 'RECORD'      FIELD RECORD
 			             ID 'PROG'        FIELD PROG.
*
IF SY-SUBRC EQ 0.
  BQID   = QID.
  BUSER  = SY-MSGV1.
  BGROUP = GROUP.
* CALL FUNCTION 'DB_COMMIT'.
  CALL FUNCTION 'ENQUEUE_BDC_QID'
  EXPORTING  	DATATYP 		= 'BDC '
 	GROUPID  		= BGROUP
 	QID            		= BQID
  EXCEPTIONS 	FOREIGN_LOCK		= 98
 	SYSTEM_FAILURE  	= 99.
  
  IF SY-SUBRC EQ 0.
     message i368(00) with 'BDCWAIT: ' qid.
  ENDIF.

ENDIF.
*
PERFORM FEHLER_BEHANDLUNG USING SY-SUBRC.
*
*
ENDFUNCTION.

Note: The actual parameters of the call of the C function

(CALL
‘BDC_OPEN_GROUPʼ ID ...)

might vary depending on the SAP release. With this approach, you obtain a global change in your SAP system.

The completion status of a SAP job launched by HCL Workload Automation is based on the value you set for the bdc_job_status_failed option. By default, this option is set to ignore, meaning that the job is considered successfully completed when the BDC sessions are finished, regardless of their success or failure. For details about the bdc_job_status_failed option, refer to Task string parameters for SAP jobs.