IBM Tivoli Composite Application Manager for Applications, Version 7.2.1

Using the sapshcut command

You use the sapshcut command to open the SAPGUI.

About this task

In most of the SAP agent workspace tables, you right-click on a table row and select Launch. A list of SAP transactions are shown that are relevant to the IBM® Tivoli® Monitoring workspace that you are viewing are shown.

When you select one of the Launch options, IBM Tivoli Monitoring starts the SAP command called sapshcut that in turn brings up the SAPGUI. IBM Tivoli Monitoring passes the appropriate parameters that start the selected SAP transaction on the SAP system that is being monitored.

For this feature to work, you must complete the following procedure:

Procedure

Install the SAPGUI on the computer where you are running the Tivoli Enterprise Portal desktop or browser. This computer must have a Windows operating system because the sapshcut command is available on Windows systems only. The SAP agent supports the Windows SAPGUI only, not the Java™ SAPGUI.
Add the directory that contains the sapshcut.exe command to your system or user path. The sapshcut.exe command is installed as part of the SAP client into the following directory: C:\Program Files\SAP\FrontEnd\SAPgui. To add additional directories to the system or user path on Windows systems, select Control Panel > System > Advanced > Environment Variables.
Restart the Tivoli Enterprise Portal desktop or browser after you modify the path.
Configure saplogon for any systems to which you want to connect. It is optional to reduce the number of SAPGUI prompts.
Make sure the saplogon description starts with the SID. It is optional to reduce the number of SAPGUI prompts.
By default you are logged on to the SAPGUI as follows:
- SAP system that is being monitored
- SAP client that was specified for the SAP agent
- Windows user ID
You can override these default logon parameters (client and user) by setting them in the sapshcut.bat file. You can also set the password and other SAP environment variables in this file.

You can override these default logon parameters (client and user) by setting them in the sapshcut.bat file. You can also set the password and other SAP environment variables in this file.

You can create and run a Windows sapshcut.bat file as a front end to the sapshcut executable file. The .bat file must be named sapshcut.bat(or sapshcut.cmd) and must be located in your default path preceding the sapshcut.exe file.

The following parameters are passed to the sapshcut.bat file when called from a predefined Launch definition:
%1

keyword "-command"

%2

transaction_name, for example: SM13

%3

keyword "-system"

%4

SAP_system_identifier, for example: TV1

%5

keyword "-client"

%6

client_number, for example: 100
The following example shows a sample sapshcut.cmd file. In this example, you use a different user ID and password when sapshcut is run through the Application Launch for the SAP system TV1. All other SAP systems use the default logon parameters.
```
@echo off set sapshcut="C:\Program Files\SAP\FrontEnd\SAPgui\sapshcut.exe" 
if "%4" == "TV1" (
   %sapshcut% %* -user=myid -password=mypwd 
) else (
   %sapshcut% %* 
)
```

Feedback