ca workload automation ae advanced integration for sap solution

Product Guide Release 11.4

CA Workload Automation AE Advanced Integration for SAP Solution Manager

This Documentation, which includes embedded help systems and electronically distributed materials, (hereinafter referred to as the “Documentation”) is for your informational purposes only and is subject to change or withdrawal by CA at any time. This Documentation is proprietary information of CA and may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA.

If you are a licensed user of the software product(s) addressed in the Documentation, you may print or otherwise make available a reasonable number of copies of the Documentation for internal use by you and your employees in connection with that software, provided that all CA copyright notices and legends are affixed to each reproduced copy.

The right to print or otherwise make available copies of the Documentation is limited to the period during which the applicable license for such software remains in full force and effect. Should the license terminate for any reason, it is your responsibility to certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed.

TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION “AS IS” WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE.

The use of any software product referenced in the Documentation is governed by the applicable license agreement and such license agreement is not modified in any way by the terms of this notice.

The manufacturer of this Documentation is CA.

Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, or their successors.

Copyright © 2014 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.

CA Technologies Product References

This document references the following CA Technologies products:

■ CA Workload Automation AE Advanced Integration for SAP Solution Manager (CA WA AE Advanced Integration for SAP Solution Manager)

■ CA Workload Automation AE (formerly named Unicenter® AutoSys® Job Management (Unicenter AutoSys JM))

■ CA Workload Control Center (CA WCC)

■ CA Embedded Entitlements Manager (CA EEM)

Contact CA Technologies

Contact CA Support

For your convenience, CA Technologies provides one site where you can access the information that you need for your Home Office, Small Business, and Enterprise CA Technologies products. At http://ca.com/support, you can access the following resources:

■ Online and telephone contact information for technical assistance and customer services

■ Information about user communities and forums

■ Product and documentation downloads

■ CA Support policies and guidelines

■ Other helpful resources appropriate for your product

Providing Feedback About Product Documentation

If you have comments or questions about CA Technologies product documentation, you can send a message to [email protected].

To provide feedback about CA Technologies product documentation, complete our short customer survey which is available on the CA Support website at http://ca.com/docs.

http://www.ca.com/support

mailto:[email protected]

http://ca.com/docs

http://ca.com/docs

Contents 5

Contents

Chapter 1: Introduction 7

Intended Audience ....................................................................................................................................................... 7

CA Workload Automation AE and SAP Solution Manager Integration ......................................................................... 8

Chapter 2: Installing CA WA AE Advanced Integration for SAP Solution Manager 11

How to Install CA WA AE Advanced Integration for SAP Solution Manager .............................................................. 12

Installation Considerations and Requirements ................................................................................................... 13

Collect Information for Your CA WA AE Advanced Integration for SAP Solution Manager Implementation .................................................................................................................................................. 15

Define the SAP Solution Manager User Role Authorizations .............................................................................. 17

Install the SAP Java Connector (SAP JCo 32bit) ................................................................................................... 19

Install CA WA AE Advanced Integration for SAP Solution Manager .................................................................... 21

How to Install CA WA AE Advanced Integration for SAP Solution Manager Silently.................................................. 29

Create a Response File ........................................................................................................................................ 30

Install CA WA AE Advanced Integration for SAP Solution Manager Silently ....................................................... 33

Uninstall CA WA AE Advanced Integration for SAP Solution Manager ...................................................................... 35

Chapter 3: Managing CA WA AE Advanced Integration for SAP Solution Manager 37

Additional Configuration Settings .............................................................................................................................. 37

Configure the SID.XBP File .................................................................................................................................. 37

Control Access to the CA Workload Control Center Web Interface .................................................................... 37

Logging ....................................................................................................................................................................... 38

Start or Stop the CA WA AE Advanced Integration for SAP Solution Manager Service ............................................. 38

Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP .................................................... 39

Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP By File ......................................... 41

Register CA WA AE Advanced Integration for SAP Solution Manager with SAP ........................................................ 43

Register CA WA AE Advanced Integration for SAP Solution Manager with Workload Automation .......................... 46

Test the Connection ................................................................................................................................................... 48

Create the Notification jcoDestination File ................................................................................................................ 50

Chapter 4: Scheduling Considerations 53

SMSE Templates ......................................................................................................................................................... 53

CA Workload Automation AE and SAP Solution Manager Job Status Mapping ......................................................... 54

6 Product Guide

CA Workload Automation AE and SAP Solution Manager User Interface Field Mapping .......................................... 55

Job Logs ...................................................................................................................................................................... 56

Scheduling Limitations ............................................................................................................................................... 58

Chapter 5: Known Issues 61

Importing or Searching Jobs ....................................................................................................................................... 61

Chapter 6: Related Documentation 63

CA Workload Automation AE Documentation ........................................................................................................... 63

Index 65


Chapter 1: Introduction

This section contains the following topics:

Intended Audience (see page 7) CA Workload Automation AE and SAP Solution Manager Integration (see page 8)

Intended Audience

The intended audiences for this guide are as follows:

■ Administrators─Responsible for installing and configuring CA WA AE Advanced Integration for SAP Solution Manager components.

■ Schedulers─Responsible for defining, scheduling, and controlling CA Workload Automation AE jobs using SAP Solution Manager.

You require knowledge of the operating system where you are installing the CA WA AE Advanced Integration for SAP Solution Manager components, and the SAP system to which the server communicates.

Note: The term Windows refers to the Microsoft Windows operating system.

CA Workload Automation AE and SAP Solution Manager Integration

8 Product Guide


CA WA AE Advanced Integration for SAP Solution Manager provides integration between CA Workload Automation AE Release 11.3.6 and above, and SAP Solution Manager 7.1 using the SAP Solution Manager Scheduling Enabler (SMSE) user interface. CA WA AE Advanced Integration for SAP Solution Manager enables SAP users to monitor and manage jobs that are scheduled and executed by CA Workload Automation AE from within SAP Solution Manager. Additionally, you can import jobs from CA Workload Automation AE to SAP Solution Manager and customize or schedule those jobs based on your requirements.

SAP Solution Manager lets you manage CA Workload Automation AE jobs without the need to log in to CA Workload Control Center.

Notes:

■ CA WA AE Advanced Integration for SAP Solution Manager is supported on Windows and Linux operating environments only.

■ Limited support is provided for non-SAP jobs that are contained in a work flow.

You can complete the following operations using SAP Solution Manager:

■ Scheduling jobs and job chains:

– Scheduling with parameters using complex start conditions

– Rescheduling

– Changing jobs and job chains

■ Monitoring jobs and job chains:

– Searching for jobs

– Getting parameters

– Getting output (such as job logs, spool logs, and event logs)

– Getting status

– Getting operator messages

■ Managing jobs and job chains:

– Holding

– Releasing a job on hold

■ Filtering Jobs:

– Selecting jobs based on date

– Selecting jobs based on status



■ Getting list of:

– Job instances or definitions and their parameters

– SAP Systems or queues and their parameters

■ Active notification from the external scheduler by:

– Job status change

■ Showing URLs that are attached to a job or to a system


Chapter 2: Installing CA WA AE Advanced Integration for SAP Solution Manager


How to Install CA WA AE Advanced Integration for SAP Solution Manager (see page 12) How to Install CA WA AE Advanced Integration for SAP Solution Manager Silently (see page 29) Uninstall CA WA AE Advanced Integration for SAP Solution Manager (see page 35)

How to Install CA WA AE Advanced Integration for SAP Solution Manager

12 Product Guide


As an administrator, you must install CA WA AE Advanced Integration for SAP Solution Manager on the CA Workload Automation AE server to enable you to use SAP Solution Manager to manage your jobs.

The following diagram illustrates how to install CA WA AE Advanced Integration for SAP Solution Manager:

To install CA WA AE Advanced Integration for SAP Solution Manager, follow these steps:

1. Review the installation considerations and requirements. (see page 13)

2. Collect information for your CA WA AE Advanced Integration for SAP Solution Manager implementation. (see page 15)

3. Define the SAP Solution Manager user role registration and notification authorizations (see page 17).

4. Install the SAP Java Connector (SAP JCo) (see page 19).

5. Install CA WA AE Advanced Integration for SAP Solution Manager (see page 21).



Installation Considerations and Requirements

Installation Restrictions:

■ If you installed CA Workload Automation AE in the default installation location, CA WA AE Advanced Integration for SAP Solution Manager is installed in the following location:

Windows:

On a 64-bit computer—C:\Program Files (x86)\CA\WAAE_SAP_SolMan

On a 32-bit computer—C:\Program Files\CA\WAAE_SAP_SolMan

Linux:

/opt/CA/WAAE_SAP_SolMan

■ If you installed CA Workload Automation AE in a custom location, CA WA AE Advanced Integration for SAP Solution Manager is installed two levels above the CA Workload Automation AE installation directory.

■ Single installation per server

■ Supported operating systems—Microsoft Windows 2008, Microsoft Windows 2012, Red Hat Enterprise Linux 5 (x86), Red Hat Enterprise Linux 6 (x86), SuSE Linux Enterprise Server 10 (x86), SuSE Linux Enterprise Server 11 (x86), and Oracle Enterprise Linux 6 (x86).

CA Workload Automation AE Requirements

■ CA Workload Automation AE Release 11.3.6 and above

■ CA Workload Automation AE Release 11.3.6 Server (SDK runtime, 32-bit JRE)

■ SAP JCo 3.0 32-bit libraries to communicate with SAP Solution Manager

■ Cluster environments that are supported by CA Workload Automation AE Release 11.3.6, Microsoft Cluster Server, and Red Hat Cluster Suite.

Note: The SAP Solution Manager must have a dependency on the CA Workload Automation AE server and scheduler services for the CA Workload Automation AE AI for SAP Solution Manager service to start on a cluster.

Important! A machine with the exact application server host name (value that is specified in the AutoServer parameter in the UNIX configuration file or the Server Host field on the CA Workload Automation AE Administrator utility) exists in CA Workload Automation AE. If you are using multiple application servers, the corresponding machines must exist in CA Workload Automation AE. If you are inserting a machine, ensure that the jobs that run on the local host are resolved properly.

Note: For information about the CA Workload Automation AE server requirements, see the CA Workload Automation AE Release Notes.


14 Product Guide

SAP Server Requirements

■ SAP NetWeaver 7.0 SP16 and above

■ SAP Solution Manager 7.1

■ SAP Note 1999878 must be applied to SAP Solution Manager before registration.

SAP Services Requirements

■ Standard SAP service names must be defined to the CA Workload Automation AE system. The SAP GUI, which defines the service names, must be installed. If the SAP GUI is not installed, add the service names manually to the following path:

Windows

C:\Windows\system32\drivers\etc\services

UNIX

/etc/services

The service names are defined as follows:

■ sapdpNN 32NN/tcp, where NN specifies a number from 00 to 99; that is, starting from sapdp00 3200/tcp, sapdp01 3201/tcp, sapdb02 3202/tcp to sapdp99 3299/tcp

Examples: Defined as follows:

sapdp00 3200/tcp

sapdp01 3201/tcp

sapdp02 3202/tcp

■ sapgwNN 33NN/tcp, where NN specifies a number from 00 to 99; that is, starting from sapgw00 3300/tcp, sapgw01 3301/tcp, sapgw02 3302/tcp to sapgw99 3399/tcp

Examples: Defined as follows:

sapgw003300/tcp

sapgw013301/tcp

sapgw023302/tcp



Collect Information for Your CA WA AE Advanced Integration for SAP Solution Manager Implementation

Before you install CA WA AE Advanced Integration for SAP Solution Manager, collect the following information:

Information Your Value

SAP System ID—Specifies the SAP system identifier (SID) CA WA AE Advanced Integration for SAP Solution Manager registers to. This value corresponds to the System ID field on the SAPGUI properties dialog.

SAP Host Address—Specifies the host name of the SAP Solution Manager server to which CA WA AE Advanced Integration for SAP Solution Manager registers. This value corresponds to the Application Server field on the SAPGUI properties dialog.

SAP System Number—Specifies the system number of the system CA WA AE Advanced Integration for SAP Solution Manager registers to. This value must have two digits and it corresponds to the System Number field on the SAPGUI properties dialog.

SAP Client Number—Specifies the SAP client number.

SAP User ID—Specifies the SAP user ID to use during registration.

SAP Password—Specifies the password associated with the SAP user ID.

SAP Gateway Host—Specifies the name of the SAP gateway host.

SAP Gateway Service—Specifies either a named port sapgwNN or a numerical port number in the range 33NN, where NN corresponds to your SAP system number.


16 Product Guide


CA Workload Automation AE User Name—Specifies the CA Workload Automation AE user name.

Notes:

When CA Workload Automation AE is running in high availability mode, the same user name must exist on all machines.

When CA Workload Automation AE is using native security, the user name provided during install should be an edit or exec super user.

When CA Workload Automation AE is using CA EEM security, the user name provided during install should be a privileged user to do operations on CA Workload Automation AE resources using SAP Solution Manager. Additionally the user must have the following permissions:

■ create , delete, execute and update jobs that start with NOTFI*

■ create , delete, execute and update calendars that start with _*

■ create, delete, execute and update global variables

CA Workload Automation AE Password—Specifies the password that is associated with the CA Workload Automation AE user.

Note: When CA Workload Automation AE is running in high availability mode, the password must be the same on all machines.

CA Workload Control Center Host—Specifies the host name of the CA Workload Control Center server. This information is required for registering CA WA AE Advanced Integration for SAP Solution Manager with CA Workload Automation AE.




CA Workload Control Center port—Specifies the port number of the CA Workload Control Center server. This information is required for registering CA WA AE Advanced Integration for SAP Solution Manager with CA Workload Automation AE.

CA Workload Control Center protocol (HTTP/HTTPS)—Specifies whether the CA Workload Control Center server is using SSL or non-SSL communication protocol.

SAP Notification user name—Specifies the SAP user ID which will be used during the notification process to log into the SAP Solution Manager instance with updates to job status and execution time.

SAP Notification user password—Specifies the password associated with the SAP Notification user ID.

Define the SAP Solution Manager User Role Authorizations

Before you can install CA WA AE Advanced Integration with SAP Solution Manager and register the adapter, you need to define SAP user authorizations.

Notes:

■ This connection only occurs during the installation process.

■ The user can be an SAP administrator, Basis Administrator, or Security Administrator.

■ The specified user and password must correspond to an ID defined in the SAP Solution Manager system.

■ The specified user must be authorized for the required functionality.

To assign an SAP role for the specified user, the SAP Security Administrator must define the following authorizations:

Authorization Object

Values

S_ADMI_FCD S_ADMI_FCD=ST0R;


18 Product Guide


Values

S_BTCH_ADM BTCADMIN=Y;

S_BTCH_EXT ACTVT=*;USER=*;

S_RFC RFC_TYPE=FUGR;RFC_NAME=SYST;ACTVT=16;

S_RFC RFC_TYPE=FUGR;RFC_NAME=SXMI;ACTVT=16;

S_RFC RFC_TYPE=FUGR;RFC_NAME=SXBP_EXT_SDL_BAPI;ACTVT=16;

S_RFC RFC_TYPE=FUGR;RFC_NAME=SYSU;ACTVT=16;

S_RFC RFC_TYPE=FUGR;RFC_NAME=RFC1;ACTVT=16;

S_RFC RFC_TYPE=FUGR;RFC_NAME=SDIFRUNTIME;ACTVT=16;

S_RFC RFC_TYPE=FUGR;RFC_NAME=BAPI_EXT_SDL_READ_DEST;ACTVT=16;

S_RFC RFC_TYPE=FUGR;RFC_NAME=SXBP_EXT_SDL_BAPI;ACTVT=16;

S_RFC_ADM ACTVT=01;RFCTYPE=T;RFCDEST=CAWorkloadautomation INSTANCEID_*;ICF_VALUE=*;

S_XMI_PROD EXTCOMPANY=CA;EXTPRODUCT=Workload Automat;INTERFACE=XBP;

Additionally, you must store the SAP user credentials in a configuration file for use in the notification process.

Notes:

■ Set the user type to System to prevent the password from expiring.

■ The credentials are stored in a configuration file with the password encrypted.

■ The specified user must be authorized for the required functionality.

To assign an SAP role for the specified user, the SAP Security Administrator must define the following authorizations:


Values

S_RFC RFC_TYPE=FUNC;RFC_NAME=SYST;ACTVT=16;

S_RFC RFC_TYPE=FUNC;RFC_NAME=BAPI_EXT_JOB_STATUS_CALLBACK;ACTVT=16;

S_RFC RFC_TYPE=FUNC;RFC_NAME=BAPI_XMI_LOGOFF;ACTVT=16;

S_RFC RFC_TYPE=FUNC;RFC_NAME=BAPI_XMI_LOGON;ACTVT=16;




Values

S_RFC RFC_TYPE=FUNC;RFC_NAME=DDIF_FIELDINFO_GET;ACTVT=16;

S_RFC RFC_TYPE=FUNC;RFC_NAME=RFCPING;ACTVT=16;

S_RFC RFC_TYPE=FUNC;RFC_NAME=RFC_GET_FUNCTION_INTERFACE;ACTVT=16;

Install the SAP Java Connector (SAP JCo 32bit)

For CA Workload Automation AE to communicate with SAP Solution Manager, install the SAP Java Connector (SAP JCo) package.

Follow these steps:

1. Log in to SAP Service Marketplace.

2. Navigate to SAP Java Connector, Tools & Services.

3. Download the latest SAP JCo3 for your operating system.

4. Create a directory or choose an existing directory to store the SAP JCo connector component.

5. Extract the following libraries and sapjco3. jar file to the directory where the SAP JCO was installed :

■ On UNIX, extract libsapjco3.so and sapjco3.jar.

■ On Windows, extract sapjco3.dll and sapjco3.jar.

The SAP Java Connector is installed.


20 Product Guide

SAP JCo 3.0 Support

SAP JCo 3.0 release supports the following operating environments in combination with the Java 7 Standard Edition of the corresponding platform vendor [mentioned in brackets]:

■ Microsoft Windows x86 32bit (Versions: Microsoft Windows XP, Microsoft Windows 7, Microsoft Windows 8) [Oracle JSE 1.7.0]

■ Microsoft Windows x64 64bit (Versions: Microsoft Windows Server 2003, Microsoft Windows Server 2008, Microsoft Windows Server 2008 R2, Microsoft Windows Server 2012, Microsoft Windows Server 2012 R2, Microsoft Windows 7, Microsoft Windows 8) [Oracle JSE 1.7.0]

■ Linux x86 32bit (Versions: SuSE Linux Enterprise Server 10, SuSE Linux Enterprise Server 11, Red Hat Enterprise Linux 5, Red Hat Enterprise L6) [IBM or Oracle JSE 1.7.0]

■ Linux x86 64bit (Versions: SuSE Linux Enterprise Server 10, SuSE Linux Enterprise Server 11, Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6) [IBM or Oracle JSE 1.7.0]



Install CA WA AE Advanced Integration for SAP Solution Manager

You can install CA WA AE Advanced Integration for SAP Solution Manager with a SAP system using an interactive program that prompts you for the required information.

Note: On Windows, to install CA WA AE Advanced Integration for SAP Solution Manager, use active Perl v5.8.8 to hide passwords.

Follow these steps:

1. Log in as a user with Administrators group privileges.

Note: On UNIX, log in as the root user.

2. Extract the CAWAAE_AI_SAP_Solman_Installer.zip (on Windows) or CAWAAE_AI_SAP_Solman_Installer.tar (on UNIX) file on your CA Workload Automation AE server.

3. Enter the following command at the CA Workload Automation AE command prompt to start the installation program:

perl install.pl

The welcome message is displayed.

4. Press Enter to continue.

The License Agreement page appears.

5. Read the license text and enter Y at the prompt to continue.

Note: If you do not accept the license agreement, you cannot continue with the installation.

6. Enter the required information for each of the following prompts:

Specify the SAP system ID:

Specifies the SAP system identifier (SID) CA WA AE Advanced Integration for SAP Solution Manager registers to. This value corresponds to the System ID field on the SAPGUI properties dialog.

Example: PRD

Specify the SAP host address:

Specifies the host name of the SAP Solution Manager server to which CA WA AE Advanced Integration for SAP Solution Manager registers. This value corresponds to the Application Server field on the SAPGUI properties dialog.

Specify the SAP system number:

Specifies the system number of the system CA WA AE Advanced Integration for SAP Solution Manager registers to. This value corresponds to the System Number field on the SAPGUI properties dialog.

Example: 00


22 Product Guide

Specify the SAP client:

Specifies the SAP client number.

Example: 000

Specify the SAP user name:

Specifies the SAP User ID that is used to connect to SAP Solution Manager.

Specify the SAP user password:

Specifies the password that is associated with the SAP user ID.

Specify the SAP gateway host (optional):

Specifies the SAP/R3 gateway host name.

Specify the SAP gateway service (optional):

Specifies the SAP gateway service name.

Example: sapgw09

Set this connection as the default [Y|N]:

Specifies whether you want to set this connection as the default connection.

Specify the CA Workload Automation AE user name:

Specifies the CA Workload Automation AE user name.

Note: When CA Workload Automation AE is running in high availability mode, the same user name must exist on all machines.

Specify the CA Workload Automation AE user password:

Specifies the password that is associated with the CA Workload Automation AE user.

Notes:

■ When CA Workload Automation AE is running in high availability mode, the password must be the same on all machines.

■ The password is not displayed on the screen.

Specify the Workload Automation WCC Server Host Name (optional):

Specifies the name of the computer where the CA WCC server resides.

Specify the Workload Automation WCC Server Port Number (optional):

Specifies the application port number of the CA WCC instance.

Specify the Workload Automation WCC Server transport protocol [HTTP|HTTPS] (optional):

Specifies whether the CA WCC server is using SSL or non-SSL communication protocol.



Specify the SAP Notification user name:

Specifies the SAP user ID which will be used during the notification process to log into the SAP Solution Manager instance with updates to job status and execution time.

Specify the SAP Notification user password:

Specifies the password associated with the SAP Notification user ID.

Specify the folder location of sapjco3.jar and sapjco3.dll (Windows) or Specify the directory location of sapjco3.jar and libsapjco3.so (UNIX):

Specifies the directory where the sapjco3.jar and libsapjco3.so files (UNIX) or the sapjco3.dll and sapjco3.jar files (Windows) are located.

Do you wish to start the CA WA AE Advanced Integration for SAP Solution Manager service automatically? [Y/N]:

Specifies whether you want to start the CA WA AE Advanced Integration for SAP Solution Manager service automatically or manually.

The summary information is displayed.

7. Review the summary information, and if it is correct enter N to accept the values.

Note: If you enter Y to modify the information, you must re-enter your password. The values that you entered for each of the prompts are displayed. Modify the information and enter N to accept the values.

The installer copies the files, registers the CA WA AE Advanced Integration for SAP Solution Manager server with SAP and CA Workload Automation AE, and tests the connection. The WAAEAdvancedIntegration_SAPSolMan_Install log file is written to the installation directory.

Notes:

■ During the installation, the WAAEAdvancedIntegration_SAPSolMan_Install log is created in the /tmp (UNIX) or %TEMP% (Windows) directory. After the installation is complete, the log file is copied to the installation directory.

■ When CA WA AE Advanced Integration for SAP Solution Manager is registered with CA Workload Automation AE, CA WA AE Advanced Integration for SAP Solution Manager uses the properties of CA Workload Automation AE. For example, if you are running CA Workload Automation AE in external security mode, the CA EEM policies that apply to CA Workload Automation AE also apply to CA WA AE Advanced Integration for SAP Solution Manager. The encryption set for CA Workload Automation AE applies to CA WA AE Advanced Integration for SAP Solution Manager.


24 Product Guide

■ If you change any of the following CA Workload Automation AE configuration settings, you must regenerate the WorkloadAutomation.properties file using the registration program and restart the CA WA AE Advanced Integration for SAP Solution Manager service to ensure that CA WA AE Advanced Integration for SAP Solution Manager works with CA Workload Automation AE. The configuration settings are as follows:

– Application server host name

– Application server port

– Username and password that is used by the adapter

– CA WCC host name

– CA WCC port

– CA WCC protocol

■ If you update the CA Workload Automation AE encryption settings, you must only restart the CA WA AE Advanced Integration for SAP Solution Manager service.

■ If the registration with SAP or CA Workload Automation AE fails, the installation completes with a non-zero exit code. In such cases, manually register CA WA AE Advanced Integration for SAP Solution Manager server with SAP or CA Workload Automation AE.

■ If you encounter authentication errors, verify the following information and rerun the installation:

– The username and password you provided are correct.

– A machine with the exact application server host name (value that is specified in the AutoServer parameter in the UNIX configuration file or the Server Host field on the CA Workload Automation AE Administrator utility) exists in CA Workload Automation AE. If you are using multiple application servers, the corresponding machines must exist in CA Workload Automation AE. If you are inserting a machine, ensure that the jobs that run on the local host are resolved properly.

– The agent is running.

– On Linux, you configured the agent to use an incorrect PAM service using the oscomponent.auth.pam.svc and oscomponent.auth.pam.lib parameters in the agentparm.txt file.

– In SUSE 11, The WAAE AI for SAP Solution Manager service may not start if you configured the agent to use oscomponent.auth.pam.svc=sshd. You should change the parameter to oscomponent.auth.pam.svc=su in the agentparm.txt file and restart the agent.

More information:

install.pl—Install or Remove CA WA AE Advanced Implementation for SAP Solution Manager (see page 25)



install.pl—Install or Remove CA WA AE Advanced Implementation for SAP Solution Manager

You can install or remove CA WA AE Advanced Integration for SAP Solution Manager from the CA Workload Automation AE server using the Perl script named install.pl. You can also use this script to generate a response file for a silent installation and to perform a silent installation. When you run install.pl, you can specify the appropriate options depending on the functions you want to perform.

Important! Run the install.pl script from the CA Workload Automation AE console.

This script has the following format:

perl install.pl [--interview=RESPONSE_FILE] | [--silent=RESPONSE_FILE] |

--ae-user-name=USER --ae-user-password=PASSWORD

--sap-system-id=SYSID --sap-host-address=HOSTADDRESS

--sap-system-number=SYSNUMBER --sap-client=CLIENT

--sap-user-name=USER --sap-user-password=PASSWORD]

[--sap-gateway-host=GATEWAY_HOST]

[--sap-gateway-service=GATEWAY_SERVICE]

--default=Y|N [--wcc-host-name=WCCHOSTNAME]

[--wcc-port-number=PORTNUMBER] [--wcc-protocol=HTTP|HTTPS]

--sap-notification-user-name=USER --sap-notification-user-password=PASSWORD

--sap-jco-loc=DIRECTORY --service=A|M

[--uninstall] [--help]

--interview=RESPONSE_FILE

(Optional) Specifies to run the installation in interview mode and to create a response file. Specify the full path in the response file name. When --interview is specified, CA WA AE Advanced Integration for SAP Solution Manager is not installed.

Note: This option is mutually exclusive with all other options.

--silent=RESPONSE_FILE

(Optional) Specifies to install CA WA AE Advanced Integration for SAP Solution Manager in silent or unattended mode, using the values in the response file. Specify the full path in the response file name. When --silent is specified, no prompts are displayed and no output is logged to standard output.


Note: If neither --interview or --silent options are specified, the installer runs in interactive mode.


26 Product Guide

You can minimize the number of prompts by specifying the following options:

Note: If an option is not specified, and its value is required, you are prompted to supply the information.

--ae-user-name=USER

Specifies the CA Workload Automation AE user name. If --ae-user-name is not specified, you are prompted to enter the name. Authorization to the various CA Workload Automation AE activities and resources are performed using this user.

--ae-user-password=PASSWORD

Specifies the password that is associated with the CA Workload Automation AE user. If --ae-user-password is not specified, you are prompted to enter the password.

--sap-system-id=SYSID

Specifies the SAP system identifier (SID) CA WA AE Advanced Integration for SAP Solution Manager registers to. This value corresponds to the System ID field on the SAPGUI properties dialog. If --sap-system-id is not specified, you are prompted to enter the SAP system ID.

Note: This value is used to name the connection properties file. CA WA AE Advanced Integration for SAP Solution Manager uses the connection properties file to establish an RFC connection to the SAP system.

Example: CE2 (The agent stores the SAP connection data in the CE2.jcoserver file.)

--sap-host-address=HOSTADDRESS

Specifies the host name of the SAP Solution Manager server to which CA WA AE Advanced Integration for SAP Solution Manager registers. This value corresponds to the Application Server field on the SAPGUI properties dialog. If --sap-host-address is not specified, you are prompted to enter the host name.

--sap-system-number=SYSNUMBER

Specifies the system number of the system CA WA AE Advanced Integration for SAP Solution Manager registers to. The value must have two digits and it corresponds to the System Number field on the SAPGUI properties dialog. If --sap-system-number is not specified, you are prompted to enter the system number.

Example: 00

--sap-client=CLIENT

Specifies the SAP client number. If --sap-client is not specified, you are prompted to enter the client number.

--sap-user-name=USER

Specifies the SAP user ID to use to connect to SAP Solution Manager. If --sap-user-name is not specified, you are prompted to enter the user name.



--sap-user-password=PASSWORD

Specifies the password that is associated with the SAP user ID. If --sap-user-password is not specified, you are prompted to supply the user password.

--sap-gateway-host=GATEWAY_HOST

(Optional) Specifies the SAP/R3 gateway host.

--sap-gateway-service=GATEWAY_SERVICE

(Optional) Specifies the SAP gateway service name.

Example: sapgw00.

--default=Y|N

Specifies whether you want to set this connection as the default connection. If --default is not specified, you are prompted to supply either Y or N.

--wcc-host-name=WCCHOSTNAME

(Optional) Specifies the name of the computer where the CA Workload Control Center server resides. If --wcc-host-name is not specified, you are prompted to supply the CA Workload Control Center server host name.

--wcc-port-number=PORTNUMBER

(Optional) Specifies the application port number of the CA Workload Control Center instance. If --wcc-port-number is not specified, you are prompted to supply the CA Workload Control Center server port number.

--wcc-protocol=HTTP|HTTPS

(Optional) Specifies whether the CA Workload Control Center server is using SSL or non-SSL communication protocol. If --wcc-protocol is not specified, you are prompted to supply the protocol.

--sap-notification-user-name=USER

Specifies the SAP user name which will be used during the notification process to log into the SAP Solution Manager instance with updates to job status and execution time. If --sap-notification-user-name is not specified, you are prompted to supply the SAP/R3 user name.

--sap-notification-user-password=PASSWORD

Specifies the password associated with the SAP Notification user ID. If --sap-notification-user-password is not specified, you are prompted to supply the SAP/R3 user password.


28 Product Guide

--sap-jco-loc=DIRECTORY

Specifies the directory where the sapjco3.jar and libsapjco3.so files (UNIX) or the sapjco3.dll and sapjco3.jar files (Windows) are located. If --sap-jco-loc is not specified, you are prompted to enter the folder name.

Note: If you are performing a silent installation, this directory must exist on the computer where you are installing CA WA AE Advanced Integration for SAP Solution Manager silently.

--service=A|M

(Optional) Specifies whether you want to start the service automatically or manually. By default, the CA WA AE Advanced Integration for SAP Solution Manager service starts automatically.

--uninstall

(Optional) Specifies to uninstall CA WA AE Advanced Integration for SAP Solution Manager.

Note: --uninstall is mutually exclusive with all other options.

--help

(Optional) Displays the usage statement.


More information:

Uninstall CA WA AE Advanced Integration for SAP Solution Manager (see page 35) Install CA WA AE Advanced Integration for SAP Solution Manager (see page 21) Install CA WA AE Advanced Integration for SAP Solution Manager Silently (see page 33) Create a Response File (see page 30)

How to Install CA WA AE Advanced Integration for SAP Solution Manager Silently



As an administrator, you can install CA WA AE Advanced Integration for SAP Solution Manager silently. You are not prompted to enter responses like you do during a normal installation. Silent installation uses a response file that you create to automatically provide the required information.

The following diagram illustrates the process to install CA WA AE Advanced Integration for SAP Solution Manager silently:

To install CA WA AE Advanced Integration for SAP Solution Manager silently, follow these steps:

1. Create a response file (see page 30).

2. Install CA WA AE Advanced Integration for SAP Solution Manager silently (see page 33).


30 Product Guide

Create a Response File

A response file provides responses to the prompts that occur when you perform a silent installation. You can create a response file by running the interview option for the installation command. You can then use the response file to install CA WA AE Advanced Integration for SAP Solution Manager silently.

Follow these steps:



2. Enter the following command at the CA Workload Automation AE command prompt:

perl install.pl --interview=RESPONSE_FILE

RESPONSE_FILE

Specifies the full path and the name of the file you are creating.

The welcome message is displayed.

3. Press Enter to continue.

The License Agreement page appears.

4. Read the license text and enter Y at the prompt to continue.

Note: If you do not accept the license agreement, you cannot continue with the installation.


Specify the SAP system ID:


Example: PRD

Specify the SAP host address:


Specify the SAP system number:

Specifies the system number of the system CA WA AE Advanced Integration for SAP Solution Manager registers to. This value corresponds to the System Number field on the SAPGUI properties dialog.

Example: 00



Specify the SAP client:


Example: 000





Specify the SAP gateway host (optional):

Specifies the SAP/R3 gateway host name.

Specify the SAP gateway service (optional):


Example: sapgw09

Set this connection as the default [Y|N]:

Specifies whether you want to set this connection as the default connection.

Specify the CA Workload Automation AE user name:

Specifies the CA Workload Automation AE user name.

Note: When CA Workload Automation AE is running in high availability mode, the same user name must exist on all machines.

Specify the CA Workload Automation AE user password:

Specifies the password that is associated with the CA Workload Automation AE user.

Note: When CA Workload Automation AE is running in high availability mode, the password must be the same on all machines.

Specify the Workload Automation WCC Server Host Name (optional):

Specifies the name of the computer where the CA WCC server resides.

Specify the Workload Automation WCC Server Port Number (optional):

Specifies the application port number of the CA WCC instance.

Specify the Workload Automation WCC Server transport protocol [HTTP|HTTPS] (optional):

Specifies whether the CA WCC server is using SSL or non-SSL communication protocol.


32 Product Guide

Specify the SAP Notification user name:

Specifies the SAP user ID which will be used during the notification process to log into the SAP Solution Manager instance with updates to job status and execution time.

Specify the SAP Notification user password:


Specify the folder location of sapjco3.jar and sapjco3.dll (Windows) or Specify the directory location of sapjco3.jar and libsapjco3.so (UNIX):

Specifies the directory where the sapjco3.jar and libsapjco3.so files (UNIX) or the sapjco3.dll and sapjco3.jar files (Windows) are located.

Do you wish to start the CA WA AE Advanced Integration for SAP Solution Manager service automatically? [Y/N]

Specifies whether you want to start the CA WA AE Advanced Integration for SAP Solution Manager service automatically or manually.

The summary information is displayed.

6. Review the summary information, and if it is correct enter N to accept the values.

Note: If you enter Y to modify the information, you must re-enter your password. The values that you entered for each of the prompts are displayed. Modify the information and enter N to accept the values.

The installer copies the information to the response file and exits the installation process.

More information:




Install CA WA AE Advanced Integration for SAP Solution Manager Silently

The silent installation lets you install CA WA AE Advanced Integration for SAP Solution Manager without having to enter responses to the prompts at installation time. Instead, silent installation uses your previously created response file to provide the required information.

Note: On Windows, to install CA WA AE Advanced Integration for SAP Solution Manager, use active Perl v5.8.8 to hide passwords.

Follow these steps:



2. Extract the CAWAAE_AI_SAP_Solman_Installer.zip (on Windows) or CAWAAE_AI_SAP_Solman_Installer.tar (on UNIX) file on your CA Workload Automation AE server.

3. Enter the following command at the CA Workload Automation AE command prompt to start the installation program:

perl install.pl --silent=RESPONSE_FILE

RESPONSE_FILE

Specifies the full path and the name of the file you previously created.

CA WA AE Advanced Integration for SAP Solution Manager is installed silently. During the installation, the WAAEAdvancedIntegration_SAPSolMan_Install log is created in the /tmp (UNIX) or %TEMP% (Windows) directory. After the installation is complete, the log file is copied to the installation directory.

Notes:

■ During the installation, the WAAEAdvancedIntegration_SAPSolMan_Install log is created in the /tmp (on Linux) or %TEMP% (on Windows) directory. After the installation is complete, the log file is copied to the installation directory.

■ When CA WA AE Advanced Integration for SAP Solution Manager is registered with CA Workload Automation AE, CA WA AE Advanced Integration for SAP Solution Manager uses the properties of CA Workload Automation AE. For example, if you are running CA Workload Automation AE in external security mode, the CA EEM policies that apply to CA Workload Automation AE also apply to CA WA AE Advanced Integration for SAP Solution Manager. The encryption set for CA Workload Automation AE applies to CA WA AE Advanced Integration for SAP Solution Manager.


34 Product Guide

■ If you change any of the following CA Workload Automation AE configuration settings, you must regenerate the WorkloadAutomation.properties file using the registration program and restart the CA WA AE Advanced Integration for SAP Solution Manager service to ensure that CA WA AE Advanced Integration for SAP Solution Manager works with CA Workload Automation AE. The configuration settings are as follows:

– Application server host name

– Application server port

– Username and password that is used by the adapter

– CA WCC host name

– CA WCC port

– CA WCC protocol

■ If you update the CA Workload Automation AE encryption settings, you must only restart the CA WA AE Advanced Integration for SAP Solution Manager service.

■ If the registration with SAP or CA Workload Automation AE fails, the installation completes with a non-zero exit code. In such cases, manually register CA WA AE Advanced Integration for SAP Solution Manager server with SAP or CA Workload Automation AE.

■ If you encounter authentication errors, verify the following information and rerun the installation:

– The username and password you provided are correct.

– A machine with the exact application server host name exists in CA Workload Automation AE. If you are using multiple application servers, the corresponding machines must exist in CA Workload Automation AE.

– The agent is running.

– On Linux, you configured the agent to use an incorrect PAM service using the oscomponent.auth.pam.svc and oscomponent.auth.pam.lib parameters in the agentparm.txt file.

– In SUSE 11, The WAAE AI for SAP Solution Manager service may not start if you configured the agent to use oscomponent.auth.pam.svc=sshd. You should change the parameter to oscomponent.auth.pam.svc=su in the agentparm.txt file and restart the agent.

Uninstall CA WA AE Advanced Integration for SAP Solution Manager


Uninstall CA WA AE Advanced Integration for SAP Solution Manager

You can uninstall CA WA AE Advanced Integration for SAP Solution Manager with a SAP system using an interactive program that prompts you for the required information.

Important! Deactivate the RFC destination before you unregister WA AE Advanced Integration for SAP Solution Manager with SAP. To deactivate the RFC destination manually, log in to SAP, enter EXTSDL in the command line, and select the RFC destination. Next, click the Deactivate Connection button.

Follow these steps:

1. Copy the install.pl file from the installation directory to any other location.

2. On Windows, open the CA Workload Automation AE command prompt.

On UNIX, run the shell that is sourced to use CA Workload Automation AE.

3. Change to the location where the install.pl file is copied.

4. Enter the following command at the CA Workload Automation AE command prompt to start the uninstallation process:

perl install.pl --uninstall


Do you want to uninstall CA WA AE Advanced Integration for SAP Solution Manager [Y/N]:

Specifies whether you want to uninstall CA WA AE Advanced Integration for SAP Solution Manager.





CA WA AE Advanced Integration for SAP Solution Manager is uninstalled. The destination in EXTSDL is removed and unregistered.

Note: If you did not deactivate the RFC destination before starting the uninstall script, you are prompted to deactivate it and run the uninstallation script again.

More information:



Chapter 3: Managing CA WA AE Advanced Integration for SAP Solution Manager


Additional Configuration Settings (see page 37) Logging (see page 38) Start or Stop the CA WA AE Advanced Integration for SAP Solution Manager Service (see page 38) Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP (see page 39) Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP By File (see page 41) Register CA WA AE Advanced Integration for SAP Solution Manager with SAP (see page 43) Register CA WA AE Advanced Integration for SAP Solution Manager with Workload Automation (see page 46) Test the Connection (see page 48) Create the Notification jcoDestination File (see page 50)

Additional Configuration Settings

Configure the SID.XBP File

To view Business Process Monitor job alerts and job status in the Job Documentation page in SAP Solution Manager, you must manually create the SID.XBP file (where SID indicates the SAP System ID) in the folder containing the CAWorkloadAutomationAEAdapter.jar file. The default location is C:\Program Files (x86)\CA\WAAE_SAP_SolMan\bin\ (on Windows) and /opt/CA/WAAE_SAP_SolMan (on UNIX). A SID.XBP.template file is included in the bin directory for your use. Rename SID.XBP.template file to SID.XBP and update the SAP server details.

Control Access to the CA Workload Control Center Web Interface

For information about accessing CA WCC components such as Quick Edit and Quick View from the SAP Solution Manager, see the CA Workload Control Center Implementation Guide.

Logging

38 Product Guide

Logging

CA WA AE Advanced Integration for SAP Solution Manager uses Log4J logging utility to debug communication and data issues and to determine system status.

The following files are provided with the installation software:

■ log4j.properties—Controls the output of AsAPI calls

■ log4j2.xml—Controls the output of JCo code

Start or Stop the CA WA AE Advanced Integration for SAP Solution Manager Service

CA WA AE Advanced Integration for SAP Solution Manager runs on the CA Workload Automation AE AI for SAP Solution Manager(%AUTOSERV%) (on Windows) or waae_solman$AUTOSERV (on UNIX) service.

AUTOSERV

Specifies the CA Workload Automation instance ID.

On Windows, use the Services window to start or stop the CA Workload Automation AE AI for SAP Solution Manager(%AUTOSERV%) service.

On UNIX, log in as the root user and enter the following command at the command prompt:

unisrvcntr {start|stop|restart|status} service_name

start

Starts the service.

stop

Stops the service.

restart

Stops and then starts the service.

status

Reports the status of the service.

Note: The service_name is optional when you run the command with the status argument. With no service name specified, the status of each service managed by unisrvcntr is displayed.

service_name

Specifies the name of the waae_solman.$AUTOSERV service.

Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP



If you specified a wrong SAP instance during the installation and you want to correct it without rerunning the installation, you must manually unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP. The interactive program prompts you for the required information.

Important! Deactivate the RFC destination before you unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP. To deactivate the RFC destination manually, log in to SAP, enter EXTSDL in the command line, and select the RFC destination. Next, click the Deactivate Connection button.

Follow these steps:



2. Change to the CA WA AE Advanced Integration for SAP Solution Manager installation directory. For example, type the following command:

(UNIX) cd sap_smse_install_directory/bin

(Windows) cd sap_smse_install_directory\bin

3. Type the following command to start the registration program:

(UNIX) waae_solman_register.sh

(Windows) waae_solman_register.bat

The CA WAAE Registration Utility opens, prompting you to select an option.

4. Select option 2 to unregister.

5. Enter 1 at the next prompt to manually unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP.


SAP Host Address


SAP System Number

Specifies the system number of the system CA WA AE Advanced Integration for SAP Solution Manager registers to. This value must have two digits and it corresponds to the System Number field on the SAPGUI properties dialog.

Example: 00


40 Product Guide

SAP Client


SAP Username

Specifies the SAP user ID to use to connect to SAP Solution Manager.

SAP Password


Note: If you enter an incorrect value in any of the options, a message is returned prompting you to select from one of the following options:[1] Start over, [2] Reenter credentials, or [0] Exit.

Workload Automation Destination Name

Specifies the RFC destination name that the server program uses to register on the SAP gateway.

Gateway Service (Optional)


Example: sapgw09

Gateway Host (Optional)

Defines the name of the SAP gateway host.

Default: SAP Host Address

Also Remove RFC destination?

Specifies whether you want to remove a destination from the list of RFC destinations in the SAP system.

■ true—Removes the destination from the list of RFC destinations.

■ false—Does not remove the destination from the list of RFC destinations.

Note: The destination in EXTSDL is removed and unregistered irrespective of whether you select the true or false option.

The registration program displays a message and closes automatically after completing successfully.

More information:

Register CA WA AE Advanced Integration for SAP Solution Manager with SAP (see page 43) Test the Connection (see page 48) Register CA WA AE Advanced Integration for SAP Solution Manager with Workload Automation (see page 46) Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP By File (see page 41)

Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP By File



Alternatively, you can unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP by file, in which case, you are not prompted to manually enter responses.

Important! Deactivate the RFC destination before you unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP. To deactivate the RFC destination manually, log in to SAP, enter EXTSDL in the command line, and select the RFC destination. Next, click the Deactivate Connection button.

Follow these steps:










4. Select option 2 to unregister.

5. Enter 2 at the next prompt to unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP by file.


SAP System ID (SAPSID)

Specifies the file that contains the details that are needed to unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP system.

SAP Username

Specifies the SAP user ID that is used for the RFC call to the SAP system to unregister.

SAP Password



42 Product Guide

Gateway Service (Optional)


Example: sapgw09




Delete .jcoServer file? Please select from the following options:

[1] Yes.

[2] No.

Specifies whether you want to delete the .jcoServer file.

The program displays a message and closes automatically after completing successfully.

More information:

Register CA WA AE Advanced Integration for SAP Solution Manager with SAP (see page 43) Test the Connection (see page 48) Register CA WA AE Advanced Integration for SAP Solution Manager with Workload Automation (see page 46) Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP (see page 39)

Register CA WA AE Advanced Integration for SAP Solution Manager with SAP



If you specified a wrong SAP instance during the installation and you want to correct it without rerunning the installation, you must manually register CA WA AE Advanced Integration for SAP Solution Manager with SAP. The interactive program prompts you for the required information.

Follow these steps:










4. Select option 1 to register.


SAP Host Address


SAP System Number


Example: 00


44 Product Guide

SAP Client






SAP Username


SAP Password




Registered Program ID

Specifies the program ID that will be used by the adapter to register with the SAP gateway. The registered program ID is associated with the RFC destination that is created during the registration process and can be seen in transaction SM59.




Set as the default

Specifies whether you want to register the server as the default external scheduler.

■ [1] True—Registers the server as the default external scheduler

■ [2] False—Does not register the server as the default external scheduler

Default: 1



Recreate the destination?

Specifies whether you want to overwrite or reuse the RFC destination in the SAP system. This field is displayed only if the RFC destination already exists in the SAP system.

■ [1] True—Overwrites the RFC destination and CA WA AE Advanced Integration for SAP Solution Manager is registered using the destination.

■ [2] False—Reuses the existing RFC destination and CA WA AE Advanced Integration for SAP Solution Manager is registered using the existing destination.

The program displays a message and closes automatically after registering successfully.

Note: To know the version of the CAWorkloadAutomationAEAdapter and CAWorkloadAutomationAERegistrator jar files, change to the installation directory, and run the version.bat or version.sh file.

More information:

Test the Connection (see page 48) Register CA WA AE Advanced Integration for SAP Solution Manager with Workload Automation (see page 46) Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP (see page 39) Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP By File (see page 41)

Register CA WA AE Advanced Integration for SAP Solution Manager with Workload Automation

46 Product Guide


If you specified a wrong CA Workload Automation AE instance during the installation and you want to correct it without rerunning the installation, you must manually register CA WA AE Advanced Integration for SAP Solution Manager with CA Workload Automation AE. The interactive program prompts you for the required information.

Follow these steps:










4. Select option 4 to register.


Workload Automation Application Server Host Name:

Specifies the host name of the computer where the CA Workload Automation AE application server resides.

Workload Automation Application Server Port Number:

Specifies the virtual port number that is assigned to the CA Workload Automation AE application server host computer.

Default: 9000

Workload Automation Application Server Username:

Specifies the CA Workload Automation AE application server user name.



Workload Automation Application Server Password:

Specifies the password that is associated with the CA Workload Automation AE application server user name.

Workload Automation WCC Server Host Name:

Specifies the name of the computer where the CA Workload Control Center server resides.

Workload Automation WCC Server Port Number:

Specifies the application port number of the CA Workload Control Center instance.

Workload Automation WCC Server transport protocol. Please select from the following options:

[1] HTTP

[2] HTTPS

Specifies whether the CA Workload Control Center server is using SSL or non-SSL communication protocol.

The program displays a message and closes automatically after registering successfully. The adapter program uses the WorkloadAutomation.properties file to which the Workload Automation properties are written.

6. Start the adapter service to connect CA WA AE Advanced Integration for SAP Solution Manager with SAP and Workload Automation.

More information:

Register CA WA AE Advanced Integration for SAP Solution Manager with SAP (see page 43) Test the Connection (see page 48) Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP (see page 39) Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP By File (see page 41)

Test the Connection

48 Product Guide

Test the Connection

After you manually register CA WA AE Advanced Integration for SAP Solution Manager with SAP and CA Workload Automation AE, you can verify if the connection was successful.

Follow these steps:










4. Select option 3 to test whether CA WA AE Advanced Integration for SAP Solution Manager is connected successfully to SAP and CA Workload Automation AE.


SAP Host Address


SAP System Number


Example: 00

SAP Client


SAP Username


SAP Password


Test the Connection




Isolation Group

Specifies the GLOBAL group name.

The program displays a message indicating that CA WA AE Advanced Integration for SAP Solution Manager is connected successfully to SAP and CA Workload Automation AE.

More information:

Register CA WA AE Advanced Integration for SAP Solution Manager with SAP (see page 43) Register CA WA AE Advanced Integration for SAP Solution Manager with Workload Automation (see page 46) Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP (see page 39) Unregister CA WA AE Advanced Integration for SAP Solution Manager with SAP By File (see page 41)

Create the Notification jcoDestination File

50 Product Guide


If the notification jcoDestination file isn’t created during the installation, you can manually create it without rerunning the installation.The interactive program prompts you for the required information.

Follow these steps:










4. Select option 5 to create the notification jcoDestination file.


SAP Host Address


SAP System Number


Example: 00

SAP Client








SAP Username

Specifies the SAP user name which will be used during the notification process to log into the SAP Solution Manager instance with updates to job status and execution time.

SAP Password


The program displays a message indicating that the jcoDestination file is created.

Note: If CA Workload Automation AE is running in high availability mode, ensure that the directory structure of CA Workload Automation AE, CA WA AE Advanced Integration for SAP Solution Manager, and SAP Jco are the same as the CA Workload Automation AE primary scheduler. You must copy the CA WA AE Advanced Integration for SAP Solution Manager folders from the CA Workload Automation AE primary scheduler to the shadow scheduler.


Chapter 4: Scheduling Considerations


SMSE Templates (see page 53) CA Workload Automation AE and SAP Solution Manager Job Status Mapping (see page 54) CA Workload Automation AE and SAP Solution Manager User Interface Field Mapping (see page 55) Job Logs (see page 56) Scheduling Limitations (see page 58)

SMSE Templates

Job templates, created with the group name SMSE, are added to the CA Workload Automation AE database when CA WA AE Advanced Integration for SAP Solution Manager is installed. One job type template is provided for each SAP, Command, FTP, and SCP job type. You can use a template in SAP Solution Manager to schedule jobs. You can modify these job templates as needed to fit your job requirements and then use these templates to define new jobs in SAP.

Important! Only those job templates that are defined with a group name of SMSE and whose job name corresponds exactly to a CA Workload Automation AE job type can be created or maintained using SAP Solution Manager. This lets you restrict the job types that can be administered from SAP Solution Manager. For example, the SAP R/3 template job must be named SAP to match the CA Workload Automation AE job type. Similarly, name the template job for CA Workload Automation AE command jobs as CMD. Defining the SAP and CMD jobs lets you create those job types using SAP Solution Manager.

Notes:

■ You can add additional job templates per job type with SMSE as the group name.

■ Do not define job templates with date_conditions enabled or with other conditions that may cause the jobs to run automatically

CA Workload Automation AE and SAP Solution Manager Job Status Mapping

54 Product Guide

CA Workload Automation AE and SAP Solution Manager Job Status Mapping

The following table displays the job status mapping between CA Workload Automation AE and SAP Solution Manager:

CA Workload Automation AE Job Status

CA Workload Automation AE Job Status Code

CA Workload Automation AE Job Status Icon

SAP Solution Manager Job Status

SAP Solution Manager Job Status Code

Unknown 0

Unknown U

Running 1

Running R

Starting 3 Accepted r

Success 4 Completed C

Failure 5 Error E

Terminated 6 Terminated K

On Ice 7 Deactivated J

Inactive 8 New -

Activated 9

Chained P

Restart 10 Console Restart o

On Hold 11 Held H

Queue Wait 12 Delayed D

Waiting for Reply

13 Waiting for event

V

Pending Machine

14 Assigned a

Waiting for Resources

15 Overdue F

On No Execution

16

Skipped T

CA Workload Automation AE and SAP Solution Manager User Interface Field Mapping


CA Workload Automation AE and SAP Solution Manager User Interface Field Mapping

You can schedule, update, or change the status of a CA Workload Automation AE job using the fields on the Scheduling page of SAP Solution Manager.

The following table lists the SAP Solution Manager fields and the corresponding job actions that take place within CA Workload Automation AE:

SAP Solution Manager Field Job Actions Within CA Workload Automation AE

Copy Job Lets you import a job id. After the job is imported, you can cancel the job, release the job, or make a copy of the job.

Important! To copy a job, go to the Scheduling page, copy the job, and close the Scheduling page. Repeat these steps for every job that you want to copy.

Notes:

■ To copy the job, change the job name, delete the ID displayed in the External Job ID field, and click the Schedule/Change Externally button.

■ If the Queue field is not populated (the value in the Queue field is displayed as GLOBAL.) when you copy a job, click the Delete button next to the External Job ID field. Next, select the queue manually and enter GLOBAL.machine_name in the Queue field.

■ Use the Job Definition field only when you create a job. We recommend that you do not use the Job Definition field when you perform other activities such as copying a job, importing a job, filtering a job, and so on. However, if you want to use it, you must enter the exact job name in the Job Definition field.

Schedule/Change Externally

Schedules a job when you click the Schedule/Change Externally button for the first time. Updates the job from the next click.

Release Takes a job OFF_HOLD.

Reschedule Reschedules a job.

Cancel Job Puts a job ON_HOLD.

Job Logs

56 Product Guide

SAP Solution Manager Field Job Actions Within CA Workload Automation AE

Schedule Stopped and Schedule/Change Externally

Puts a job ON_HOLD.

Note: To put a job in the ON_HOLD state, select the Schedule Stopped check box and click the Schedule/Change Externally button.

Job Definition Lets you browse and select a CA Workload Automation AE job template to create a new job.

Note: To view a job definition, enter an existing job name in the Job Definition field and press Enter.

The following table lists the SAP Solution Manager fields and what they refer to in CA Workload Automation AE:

SAP Solution Manager Field Refers to in CA Workload Automation AE

Queue Machine

Event Global variable

Application Log Not applicable

Job Definition Type Job Type

Job Logs

The following job logs are supported in SAP Solution Manager:

Job Type Event Log Agent Log Spool Other Logs

CMD Displays the CA Workload Automation AE Event Log information for that job run. (autorep –j jobname –d)

Displays the CA Workload Automation AE Agent Log information for that job run.

STDOUT—Displays the Standard Output file. The parameter must be specified in the job definition.

STDERR—Displays the file entry for the Standard Error file. The parameter must be specified in the job definition.

Job Logs


Job Type Event Log Agent Log Spool Other Logs

SAP Displays the CA Workload Automation AE Event Log information for that job run. (autorep –j jobname –d)


Displays the SAP Spool file.

SAP Job Log—Displays the SAP job log for that job run.

FTP Displays the CA Workload Automation AE Event Log information for that job run. (autorep –j jobname –d)


SCP Displays the CA Workload Automation AE Event Log information for that job run. (autorep –j jobname –d)


Note: The agent log that is displayed for the SAP, FTP, and SCP job types does not contain any data because the agent does not generate it.

Scheduling Limitations

58 Product Guide


When you schedule a CA Workload Automation AE job using SAP Solution Manager, the following limitations apply:

■ If you define a job using CA Workload Automation AE starting conditions, the SAP Solution Manager starting conditions are ignored.

– To use SAP Solution Manager starting conditions, ensure that you perform the following tasks:

■ Select any of the following starting conditions in the Start Conditions section on the Scheduling page: Immediately, Once, Daily, Weekly, Monthly, Annually, and Date. SAP Solution Manager creates an internal calendar for the job if you select Daily, Weekly, Monthly, Annually, or Date condition. For example, selecting Once generates a calendar that schedules a job to run one-time only. The calendar is created based on the date and time you enter in the corresponding fields.

■ Click the Primary tab and clear the Condition field.

■ Click the Schedule tab and clear the following date and time entries: Must complete times, Must start times, Minutes after each hour, Time zone, Run days, Exclude calendar, Use date/time conditions, Run window, Run calendar, and Times of day.

Note: The Extended start condition in SAP Solution Manager is not supported by CA Workload Automation AE.

– To use CA Workload Automation AE scheduling criteria or date conditions, click the Schedule tab and specify the corresponding date condition attributes. For example, on the Schedule tab, specify Use date/time conditions and enter the conditions in the following fields as appropriate: Must complete times, Minutes after each hour, Run days, Exclude calendar, Must start times, Run window, Run calendar, and Times of day.

■ When working with existing job definitions, if you click the Schedule/Change Externally button, the job definition is updated, but the SAP Solution Manager starting conditions are not used. A message indicating that the job is scheduled appears, although it updates the job definition. To use SAP Solution Manager starting conditions, click the Reschedule button after you click the Schedule/Change Externally button.

■ No End Date and Ended at lets you repeat the schedule for a specified number of times. For example, to schedule a job to run 10 times every two days, select Daily, then select the Repeat option and enter 2 in the Day(s) field. Next, select Ended at, and enter 10 in the Number of Repetitions field.

■ When you schedule a job using the hour, minutes, and seconds format (hh:mm:ss) in SAP Solution Manager, CA Workload Automation AE ignores the seconds when it schedules the job. This applies to all SAP start conditions, except Immediately.

Example: Schedule a job with starting conditions set to Once. Next, specify a Start Date and set the Start Time as 11:45:30. The job is scheduled to run at 11:45:00.



■ When you schedule a job using SAP Solution Manager Start Condition date, the user timezone is ignored in SAP Solution Manager and the SAP system timezone is used. You can verify the system timezone on the Scheduling page in SAP Solution Manager.

■ The maximum job name character length in SAP Solution Manager is 40 characters. CA Workload Automation AE jobs with names longer than 40 characters can be retrieved. However, the following operations are not supported for jobs with names longer than 40 characters: Copy Job, Schedule/Change Externally, Release, Reschedule, Cancel Job, External Notes, and External Log.

■ In SAP Solution Manager, the error messages that are displayed on the Scheduling page are truncated.

■ When you schedule a job in SAP Solution Manager, the job ID is displayed in the External Job ID field instead of the Job Name and Job Number fields.

■ The Queue and Priority fields on the Scheduling page are input fields only. The queue and priority defined for the CA Workload Automation AE job are not retrieved in these fields.

■ When you run a Job Run Status query, the Scheduled start time column displays the actual job run time instead of the scheduled start time.

■ You cannot use the Job ID field (jobname:jobrun id) as a filter to retrieve the jobrun status information for jobs whose name is defined in lowercase. In the Job ID field, you must specify the job name in uppercase. If you enter the job name in lowercase, SAP Solution Manager automatically converts it to uppercase. If the job name is defined in lowercase, use the Job Definition field as a filter to retrieve the jobrun status information.

■ If you have a long list of machine names, and you know the name of the machine you are using, you can enter the name in the Queue field using the following format: GLOBAL.machine_name.

■ You cannot specify or modify the Spool list recipients parameter for a SAP Batch Input Session (SAPBDC) or SAP R/3 (Sap) job in SAP Solution Manager.

■ You cannot specify or modify the Info Package details parameter for a SAP BW InfoPackage (SAPBWIP) job in SAP Solution Manager.

■ The Scheduling page in SAP Solution Manager does not refresh consistently. When the Scheduling page is not refreshed, it displays the values from a previous transaction. To refresh the values, close and open the Scheduling page.

■ The Blob Input attribute is not supported for the Command job in SAP Solution Manager.

■ CA Workload Automation AE does not support the No Subsequent Jobs check box on the Import Jobs and Copy Jobs pages in SAP Solution Manager.

■ When searching for jobs on the Import Jobs page, specify concise search parameters to minimize the result set and optimize performance.

Chapter 5: Known Issues 61

Chapter 5: Known Issues

Importing or Searching Jobs

If CA Workload Automation AE is installed on an Oracle database, you can use SAP Solution Manager to import or search only those CA Workload Automation AE jobs that are defined with group jil attribute.

Note: If you encounter this problem (Pr#4203 - SDK FILTER QUERY ON ORACLE RESULT SET MAY BE INCOMPLETE), contact CA Technical Support at http://ca.com/support for the latest patch.

The Import Jobs page in SAP Solution Manager takes approximately 5 to 15 minutes to respond and display jobs if the CA Workload Automation AE server has more than 1000 jobs. The time it takes to display the jobs is dependent on the number of jobs and job runs on the CA Workload Automation AE server.



Chapter 6: Related Documentation 63

Chapter 6: Related Documentation

The CA Workload Automation AE Advanced Integration for SAP Solution Manager Product Guide is included on the product DVD and may be installed in your environment. However, we strongly recommend that you go to http://support.ca.com for the latest version of the CA Workload Automation AE Advanced Integration for SAP Solution Manager Product Guide to ensure that you are viewing the most accurate and up-to-date information.

Documentation for CA Workload Automation AE is available at http://ca.com/support.

Notes:

■ To view PDF files, download and install the Adobe Reader from the Adobe website if it is not already installed on your computer.

■ For SAP Solution Manager help, visit help.sap.com or see the SAP Solution Manager documentation help.

Important! The acknowledgements for third-party components used by CA Workload Automation AE Advanced Integration for SAP Solution Manager are in the acknowledgements.txt file that is located in the root directory of the installed product.

CA Workload Automation AE Documentation

To work with CA Workload Automation AE, see the following documentation:

Task Documentation

Configure the scheduling manager

CA Workload Automation AE UNIX Implementation Guide

CA Workload Automation AE Windows Implementation Guide

Define, monitor, and control jobs

CA Workload Automation AE Reference Guide

CA Workload Automation AE User Guide

CA Workload Control Center Workload Scheduling Guide



http://www.help.sap.com/

http://www.help.sap.com/

Index 65

Index

A

accessing CA WCC • 37

C

CA WA AE Advanced Integration for SAP Solution Manager checking connections • 48 installing • 21, 25 installing silently • 33 intended audience • 7 registering with CA Workload Automation AE •

46 registering with SAP • 43 uninstalling • 35 unregistering with SAP • 39 unregistering with SAP by file • 41

CA Workload Control Center web interface controlling access • 37

configuring the SID.XBP file • 37 creating Notification jcoDestination file manually •

50

D

documentation, scheduling manager • 63

I

installation collecting information • 15 considerations • 13 process • 12 requirements • 13

installation script • 25

R

response file creating • 30

S

SAP JCo installing • 19 support • 20

SAP Solution Manager integration with CA Workload Automation AE • 8

services starting • 38 stopping • 38

U

user interface field mapping • 55

ca workload automation ae advanced integration for sap solution

Documents