Control-M for SAP Installation

Control-M for SAP is installed on Control-M/Agent on Windows or UNIX.

To upgrade Control-M for SAP to version 9.0.21, you must ensure the following:

Installing Control-M for SAP on Control-M/Agent on UNIX

This procedure describes how to install Control-M for SAP on Control-M/Agent on UNIX.

  • To install multiple instances of Control-M for SAP on several Agents using the same configuration, use automatic install as described below.

  • To use the default interactive install, configure XServer using the DISPLAY environment variable, as described in Setting Environment Variables in UNIX. If you do not have XServer, either use the console or do an automatic install.

Before You Begin

  • Stop all jobs running on Control-M/Agent.

    If you are using a Linux x86_64 platform that runs a 32bit version of Control-M/Agent, install the following 32bit libraries:

    • libXtst.so.6

    • libXi.so.6

Begin

  1. Stop the Control-M/Agent with the following command:

    $CONTROLM/scripts/shut-ag -u <agentUser> -p all

  2. Extract the files from the temporary directory that you created when you obtained the installation files.

    • If the Control-M/Agent was installed with root user , log in as root user every time you start or shut down the Control-M/Agent throughout this procedure.

    • (AIX only) Type the following command as a root user to remove unused libraries:

      /usr/sbin/slibclean

  3. Use one of the following modes:

    • Display: If you install using GUI or XServer, set your DISPLAY environment variable, as described in Setting Environment Variables in UNIX.

    • Console: It is not necessary to set DISPLAY.

  4. Activate the installation script with the following command:

    <source_path>/setup.sh

  5. Do one of the following:

    • Interactive install: Follow the on-screen instructions until the installation is complete.

    • Automatic install: Do the following:

      1. Follow the on-screen instructions until the Summary window appears.

      2. Click Generate, select a location to create the XML parameter file, and click Yes.

      3. Copy the XML parameter file to a network location that is accessible to all computers where you want to perform an automatic installation.

      4. Type the following command to run the installation script:

        <source_path>/setup.sh -silent <filename.xml>

        To start working with Control-M for SAP, you must download the required SAP Java Connector files. For more information, see Downloading the sapjco3.jar and sapjco3 C Library Files

  6. End the session.

  7. Start a new session and restart the Control-M/Agent with the following command:

    $CONTROLM/scripts/start-ag -u <agentUser> -p all

The installation log is saved to the following location:

$HOME/BMCINSTALL/log/cmsap/BMC_Control-M_For_For_SAP_Install_<date-time>.log

Installing Control-M for SAP on Control-M/Agent on Windows

This procedure describes how to install Control-M for SAP on Control-M/Agent on Windows.

To install multiple instances of Control-M for SAP on several computers using the same configuration, use automatic install as described below.

Before You Begin

Stop all jobs running on Control-M/Agent.

Begin

  1. Log in to Control-M/Agent as an Administrator.

  2. From the Services application, right click on Control-M Agent and click Stop.

  3. From the directory that contains the installation files that you obtained, double-click setup.exe.

  4. Do one of the following:

    • Interactive install: Follow the on-screen instructions until the installation is complete.

    • Automatic install: Do the following:

      1. Follow the on-screen instructions until the Summary window.

      2. Click Generate, select the location to create the XML file, and click Yes.

        The XML file is only relevant for computers with the same Agent instance name. For Agents that have a different instance name, create a separate XML file for each Agent.

      3. Copy the XML file to a network location that is accessible to all computers where you want to perform an automatic installation.

      4. Run the following installation script:

        <source_path>\setup.exe -silent <silent.xml>

        To start working with Control-M for SAP, you must download the required SAP Java Connector files. For more information, see Downloading the sapjco3.jar and sapjco3 C Library Files

  5. From the Services application, right click on Control-M Agent and click Start.

    After you have installed Control-M for SAP on a Control-M/Agent, you must install Control-M for SAP on the Control-M client if you do not have the latest version of Control-M client, as described in Installing Control-M for SAP on Control-M/EM on Windows

    .

  • The installation log is saved to the following location:

    BMCINSTALL\log\cmsap\BMC_Control-M_For_SAP_Install_<timestamp>.log

  • If the installation failed, the log file is saved to the following location:

    %temp%\BMC_Control-M_For_SAP_Install_<timestamp>.log

Installing the Secure Network Communications (SNC) on Control-M for SAP

This procedure describes how to install the SNC protocol on Control-M for SAP, which enables the encryption of data between Control-M for SAP and the SAP system.

Begin

  1. Follow the download and installation procedures, as described in the Knowledge Base solution 000111305 on the Customer Support website, located at www.bmc.com/support.

  2. After the SNC set up is complete, stop Control-M/Agent.

  3. Stop Control-M for SAP with the following commands:

    • UNIX: sapcmbe.sh stop

    • Windows: sapcmbe.cmd stop

  4. (UNIX only) Start Control-M for SAP with the following command:

    sapcmbe.sh start &

  5. Start Control-M/Agent.

Installing Control-M for SAP on Control-M/EM on Windows

This procedure describes how to install Control-M for SAP on the Control-M/EM on Windows.

Before you begin

  • Ensure that Control-M for SAP 9.0.21 for Control-M/EM Server on Windows installation files are accessible through your network.

  • Close the Control-M client and the CCM.

Begin

  1. Log in as an Administrator.

  2. Navigate to the EM directory and click setup.exe.

  3. Do one of the following:

    • Interactive install: Follow the on-screen instructions until the installation is complete.

    • Automatic install: Do the following:

      1. Follow the on-screen instructions until the Summary window.

      2. Click Generate, select the location to create the XML file, and click Yes.

        The XML file is only relevant only for computers with the same Control-M/EM version. For computers with different Control-M/EM versions, a separate file must be created for each computer.

      3. Copy the XML file to a network location that is accessible to all computers where you want to perform an automatic installation.

      4. Run the installation script with the following command:

        <source_path>\EM\setup.exe -silent <silent.xml>

    The installation log is saved to the following location or under the directory that contains the %temp% directory:

    %temp%\BMC_Control-M-CM_EM_Install_<date-time>.log

  4. Restart the Control-M GUI Server after you have completed the installation on the Control-M/EM server.

Control-M for SAP XBP Interface and Control-M Function Modules

Control-M for SAP works integrally with the XBP interface and supports the following versions:

  • XBP 1.0

  • XBP 2.0

  • XBP 3.0

XBP 2.0 and higher is designed to work with external scheduling applications and functions best with Control-M Function Modules, also known as Control-M FMs.

Control-M FMs are Control-M for SAP specific APIs which perform tasks that are not provided by the SAP standard BAPIs.

Control-M for SAP comes with a set of predefined Control-M FMs.

By default, Control-M prefers to use XBP BAPIs over Control-M FMs. For example, if you want to copy a variant on an SAP system with XBP 1.0, install Control-M FMs. However, if you install SAP system XBP 2.0 or later and configure the account with the XBP version, the variant is copied using the XBP BAPIs.

Installing the Control-M Function Modules in a Non-Unicode SAP System

This procedure describes how to install the Control-M FMs in a non-Unicode SAP system.

If you do not want to install Control-M FMs, ensure that the Use Extended option is set to No. See SAP Connection Profile Parameters.

Begin

  1. Navigate to the SAP Transports directory:

    • UNIX: <source_path>/Tools/Transports

    • Windows: <source_path>\Tools\Transports

  2. Copy the transport files into the SAP system transport directory.

  3. Remove the read-only attribute from the transport files to prevent import issues to your SAP system.

    For more information about the contents of the sub-folders of the Transports folder, see Transport Sub-folder Contents.

  4. Use the SAP Transport Management System—transaction STMS—or the operating system executable program to import the required transport files.

Installing the Control-M Function Modules in a Unicode SAP System

This procedure describes how to install Control-M FMs in a Unicode SAP system.

If you do not want to install Control-M FMs, ensure that the Use Extended option is set to No. For more information, see SAP Connection Profile Parameters.

Begin

  1. Navigate to the SAP Transports directory:

    • UNIX: <source_path>/Tools/Transports

    • Windows: <source_path>\Tools\Transports

  2. Do one of the following:

    • If you want to set the Unicode flag manually, do the following:

      1. Follow the import procedure in SAP Note 330267 in the section Transports from 4.6 to 6.10/6.20/6.30.

      2. Copy the transport files into the transport directory of your SAP system.

      3. Remove the read-only attribute from the transport files to prevent import issues to your SAP system.

        For more information about the contents of the sub-folders of the Transports folder, see Transport Sub-folder Contents.

      4. Use the SAP Transport Management System—STMS—or the operating system executable program to import the required transport.

        Before calling the transaction, set the SAP parameter setunicode to 1 in the SAP transport system.

    • If you do not want to set the Unicode flag manually do the following:

      1. Copy the transport files into the transport directory of your SAP system.

      2. Remove the read-only attribute from the transport files to prevent import issues to your SAP system.

        For more information about the contents of the sub-folders of the Transports folder, see Transport Sub-folder Contents.

      3. Use the SAP Transport Management System—STMS—or the operating system executable program to import the required transport. Ignore the warnings.

      4. Extract the uc_support.zip file located under directory transports on the Control-M for SAP root directory to a temporary directory.

      5. Import the transport QW1K900062 from the extracted files.

      6. Open transaction SE38 and execute the following program:

        /BMCCTRLM/RUN_CHANGE_TO_UNICOD

        The program updates the Control-M FMs to run SAP Unicode systems.

     

Differences Between XBP BAPIs and Control-M Function Modules

The following table describes the differences between XBP BAPIs and Control-M FMs.

Y indicates that the BAPI has the action.

Action

XBP 1.0 BAPI

XBP 2.0 BAPI

XBP 3.0 BAPI

Control-M Function Modules

Parent/Child (mass parallel) functionality

 

Y

Y

 

Intercept functionality

 

Y

Y

 

Enhanced Extract functionality

 

Y

Y

 

Basic Extract functionality (ctmextract)

 

 

 

Y

(Works partially without Control-M FMs)

Raise SAP events

 

Y

Y

Y

Submit an event-based job

 

Y

Y

 

Batch Input functionality

 

 

 

Y

Submitting Data Archiving jobs

 

Y

Y

Y

Detecting and Releasing Data Archiving jobs

 

Y

(Using the Parent/Child and the Interception functions)

Y

(Using the Parent/Child and the Interception functions)

Y

Job Class (A, B) in Create mode

 

Y

Y

Y

Preventing duplication in extracting jobs from SAP

 

Y

Y

Y

Support for External Command

 

Y

Y

 

Spool List Recipient in Create job mode

 

Y

Y

 

Additional Print and Archiving Job Step parameters

 

Y

Y

Y

Improved faster mechanism for tracking jobs in SAP

 

Y

Y

 

Configure Job log retrieval

Y

Y

Y

 

Opersys cover page parameter

 

Y

Y

 

CP and NP options in variant selection

 

Y

Y

 

Parameters for time of printing (Print immediate, Print later or Send to SAP spooler)

 

Y

Y

 

Use Logon Groups

Y

Y

Y

 

Application logs and status support

 

 

Y

 

Load and Action requests:

ABAP Programs list

 

Y

Y

Y

Variants list

Y

Y

Y

 

Show variant

 

Y

Y

Y

Variant copy

 

Y

Y

Y

Variant change

 

Y

Y

Y

Output devices (printers) list

 

Y

Y

 

Layouts (print formats)

 

Y

Y

 

Load Job Server Groups

 

Y

Y

 

Load External Command

 

Y

Y

 

Load for distribution list

 

Y

Y

 

Load owner

 

Y

(Supported when working with SAP 6.20 or above)

Y

(Supported when working with SAP 6.20 or above)

 

Load event

 

 

Y

Y

View Job Steps

Y

Y

Y

 

Manage Event History Profiles

 

 

Y

 

Manage Interception Profiles

 

 

Y

 

Differences Between SAP Business Warehouse and Control-M Function Modules

Some actions are performed by Control-M FMs instead of the standard SAP BAPIs with SAP-BW.

The following table describes the major differences in actions performed by BW 2.x BAPIs, BW 3.x or later BAPIs, and Control-M FMs:

Action

BW 2.x BAPI

BW 3.x or above BAPI

Control-M Function Modules

Start I/P

Y

Y

 

Monitor I/P

Y

Y

  

I/P Output

 

Y

Y

Get Background Job

Name/Count

 

 

Y

Set Background Job Name

 

Y

Y

Display the number of records transferred and requested of an I/P run

    

Y

Start P/C

 N/A

Y

  

Monitor P/C

 N/A

Y

  

Restart P/C

N/A

Y

 

P/C Output

 N/A

Y

  

Process Chains (P/C) capabilities are only available in SAP-BW 3.x systems or above.

Importing Transport Sub-Folders

This procedure describes how to import the transport sub-folder that is needed to authorize Control-M users.

Begin

  1. Import the required transport into Client 000. For more information, see Transport Sub-folder Contents.

  2. Create a local transport and import it to the target client.

  3. Define the SAP System User Type to Control-M for SAP.

Transport Sub-folder Contents

The following table lists the contents of the sub-folders in the Transports folder:

Transport Name

Description

SAP_R3

Enables you to use any of the Control-M FMs.

Install this transport before installing any other transports.

BW

Enables you to use the BW-related FMs.

Install this transport only after installing the SAP_R3 transport.

DA

Enables you to use the Control-M Data Archiving functionality.

Install this transport only after installing the SAP_R3 transport.

Do NOT install this transport on SAP release 4.5B.

AUTH

Enables you to use the Control-M authorization-role.