Professional Documents
Culture Documents
The documentation may have changed since you downloaded the PDF. You can always find the latest information on SAP Help Portal.
Note
This PDF document contains the selected topic and its subtopics (max. 150) in the selected structure. Subtopics from other structures are not included.
2014 SAP AG or an SAP affiliate company. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose
without the express permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG
and its distributors contain proprietary software components of other software vendors. National product specifications may vary. These materials are provided by
SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be
liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express
warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty. SAP and other
SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other
countries. Please see www.sap.com/corporate-en/legal/copyright/index.epx#trademark for additional trademark information and notices.
Table of content
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 1 of 31
Table of content
1 Configuration in the CCMS
2 Logon Load Balancing
2.1 Recommendations for Logon Load Balancing and Logon Groups
2.2 Questions and Answers: Logon Load Balancing
2.3 Checking the Logon Load
2.4 Configure Dynamic Logon Load Distribution for RFC Calls
2.5 Configuring Logon Groups
2.6 PC Installation
2.7 SAP Logon
3 Operation Modes
3.1 Setting Up Operation Modes
3.2 Switching Operation Modes
3.2.1 Switching Operation Modes Automatically
3.2.2 Switching the Operation Mode Manually
3.2.3 Simulating Operation Mode Switching
3.2.4 Rules for Work Process Distribution
3.2.4.1 Setting the Work Process Distribution
3.3 Operation Mode Errors
3.4 Defining Operation Modes
3.5 Defining Day and Night Operation
3.6 Prerequisites for Maintaining Operation Modes
3.7 Defining Normal Operation
3.8 Defining Exception Operation
3.9 Monitoring Servers and Work Processes
3.10 Checking the Operation Mode with the Control Panel
3.11 Consistency Check
4 Instances
4.1 Creating an Instance Definition for One Server
4.2 Creating an Instance Definition for All Servers
4.3 Prerequisites for Starting Remote Instances
4.4 Maintaining Instance Definitions
5 Profiles
5.1 Saving and Importing Profiles After Installation
5.2 General Information About Profiles
5.2.1 Variables in Profile Values
5.2.2 Where Do Profiles Come From?
5.2.3 Valid Profile Parameter Values
5.2.4 Starting SAP Services by Making an Entry in the Instance Profile
5.3 Profile Files
5.3.1 Default Profile
5.3.2 Instance Profiles
5.4 Maintaining Profiles
5.4.1 Changing and Switching Profile Parameters
5.4.2 Determining a Change to a Profile
5.4.3 Checking, Saving, and Activating Profiles
5.4.4 Checking Active Parameters
5.4.5 Deleting Profiles
6 External Operating System Command: Contents
6.1 Executing External Commands
6.2 Maintaining External Commands
6.3 External Commands: Overview
6.4 Authorizations for External Commands
6.5 What Information is Displayed?
6.5.1 Displaying Detailed Information
6.5.2 Additional Parameters
6.6 Profile Parameters in External Commands
6.6.1 Security Checks
6.6.1.1 Check Modules
6.7 Processing Illegal Changes to External Commands
6.7.1 Syslog Trace and System Alert Monitor
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 2 of 31
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 3 of 31
Purpose
This component enables you to manage the configuration of your SAP system with the Computing Center Management System (CCMS). The CCMS provides you
with extensive support when configuring your system, and you can use it to perform many functions within the SAP system.
Integration
The CCMS is a standard part of the SAP system. You can therefore easily use it as part of your overall configuration activities.
Features
The most important functions that you can configure with the CCMS are:
Logon Load Balancing
Operation Modes
Instances
Profiles
Purpose
Load distribution allows you to dynamically distribute the SAP users to application server instances. You can increase the efficiency of individual work groups by
setting up multiple logon workgroups that consist of one or more application instances.
You can assign one or more application servers to certain workgroups or specific applications. When users log on to the system, they are automatically logged on
to the server that currently has the best performance statistics and/or the fewest users.
Workgroups are configured and maintained centrally from in the SAP system. Each application server group is assigned maximum thresholds for response time
and number of users that can log on to any particular group server. You can assign particularly important workgroups with time-critical transactions to application
servers with better response time behavior. Setting up logon groups means that the activities of each server become more predictable, which allows you to tune
each specific server with respect to the working applications.
To log on to an SAP system, the user needs to know only the name of the SAP system and the logon group. The host name and system numbers are no longer
needed when you have logged on.
See also:
SAP Logon
Configuring Logon Groups
Configuring Logon Load Balancing for RFC Calls
Questions and Answers: Logon Load Balancing
Logon Group SD
Server A FI/CO
Server B FI/CO
Server C SD
Server D SD
With logon load balancing and shared, or homogeneous, properties of servers across logon groups:
Logon Group FI/CO
Logon Group SD
Server A FI/CO
Server B FI/CO
Server C FI/CO
Server C SD
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Server D SD
Server E SD
Page 4 of 31
Not recommended:
With logon load balancing and servers available to all applications:
Logon Group PUBLIC
Server A FI/CO + SD
Server B FI/CO + SD
Server C FI/CO + SD
Server D FI/CO + SD
With only two servers with logon load balancing and servers assigned to specific groups:
Logon Group FI/CO
Logon Group SD
Server A
Server B
Logon Groups
Each SAP application has different resource requirements. Certain applications may therefore require more servers and logon groups. For example, you should
assign separate servers for the application component PP.
Generally, each logon group should have two servers. If one server is not available, the users are automatically connected to the second server. Servers can be
added or removed while the SAP system is running.
If it is not practical for you to assign separate servers to integrated applications such as the application components SD-MM and FI-CO, you should assign
common logon groups to these applications.
See also:
SAP Logon
Configuring Logon Groups
Questions and Answers: Logon Load Balancing
2.2
Process
Q: How can I define a default configuration for different PC's?
A: First create or check the files described in PC Installation . Then, from the SAP Logon Menu, create the desired entries. Copy the files sapmsg.ini,
saproute.ini, saplogon.ini and services to each of the PCs. SAP Logon then displays the configured entries on all these PCs.
Q: Can I use the SAPgui program in the same way as in previous releases?
A: Yes, sapgui behaves as it did in earlier releases.
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 5 of 31
logon group. This information now also contains a value for the change in quality for an additional logon (Delta Quality). This negative value is added to the
quality after a logon, which gives a lower quality for the server.
For further RFC client logons, the client uses the quality and the delta quality to calculate locally which RFC server has the best quality for this logon. An
equal distribution of the logons is ensured in this way.
Only after the interval specified in a logon group, or after a specified number of RFC client logons does the RFC client read the values for quality (and delta
quality) from the message server again.
The mechanism for dynamic logon load distribution for RFC logons does not replace the distribution mechanism for dialog logons, but rather extends it in the
respect that an RFC client can find the RFC server with the best quality locally.
Prerequisites
You have already defined logon groups for dialog applications in transaction SMLG (CCMS: Logon Group Maintenance) (see Configuring Logon Groups ). You can
also use these logon groups for RFC logons.
Activating Dynamic RFC Load Distribution for a Logon Group
1. Choose CCMS Configuration Logon Groups, or call transaction SMLG.
2. Choose the required logon group by double clicking it. The system displays the Change Assignment dialog box.
3. Choose the Properties tab page and activate the Extern. RFC enabled indicator. Choose Copy.
Display Parameters for Dynamic RFC Load Distribution
1. Choose CCMS Configuration Logon Groups, or call transaction SMLG.
2. Choose Msg-Srv Status Area ( ). The system displays the Display Control/Status Area screen. In the Integer Storage list, the system displays, among
other information, the current quality for every system (6 th numerical column) and the delta quality (8 th numerical column).
3. To display the parameters for the dynamic logon load distribution for RFC calls, choose the required logon group in the Logon Favorite Storage list by double
clicking it. The parameters displayed in this dialog window have the following meanings:
Parameter
Meaning
Version
Selection criteria
Best: The server for which the best quality was calculated is used for the next logon
Round Robin: Each server in the group is used in turn for the next logon.
Time to read
Time after which the RFC client reads new values for quality and delta quality from the
message server
Number of logons after which the RFC client reads new values for quality and delta
quality from the message server
You can only display the parameters in this window. To make changes to the parameters, follow this procedure:
Change Parameters for Dynamic RFC Load Distribution
1. Call Transaction SE16 (Data Browser).
2. Enter the table name RZLLICLASS and choose Enter (
).
3. The system displays the screen Data Browser: Table RZLLICLASS: Selection Screen. Choose Execute (
4. To change an entry, select the entry and choose Change (
Column
Parameter
Default Value
TIMERERD
Time to read
120 seconds
LOGRERD
200
FAVTYPE
Round Robin)
2.5
Use
In SAP Logon, you can create and delete group entries, remove instances from groups, and delete entire logon groups.
Note
When you call transaction SMLG, the CCMS: Maintain Logon Groupsscreen shows a table with entries for logon groups and the associated instances.An entry
in this table, which is characterized by an instance and a logon group, is known as as assignment.A logon group to which multiple instances belong therefore
consists of multiple assignments in this table, where an assignment contains one instance in each case.
Procedure
Creating a Logon Group or Adding an Instance to a Logon Group
1. Choose CCMS Configuration Logon Groups, or call transaction SMLG.
2. Choose
(Create Assignment), and specify the desired name of the logon group in the Logon Groupinput field. Enter the name of the desired Instancethat
is to belong to the logon group.
Note
The logon group SPACE is reserved for SAP; therefore, do not use this name.
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 6 of 31
3. Repeat the last step until you have entered all instances that are to belong to the logon group.
4. Save your changes.
Deleting a Logon Group or Removing an Instance from a Logon Group
1. Choose CCMS Configuration Logon Groups, or call transaction SMLG.
2. Select any assignment for the logon group that you want to delete or from which you want to remove an instance.
3. To remove an instance from the selected logon group, choose
by choosing
Remove Instance, enter the desired instance on the next screen, and confirm your choice
(Delete).
Note
The values for Response Time and Users are not absolute limits, but rather thresholds. Even if the current value for response time or number of
users is higher than this threshold value, it is possible to log on to another instance. The threshold values only influence the calculation of the
current logon server of the logon groups.
Note
You can use a preview to see how the settings of the threshold values can affect the quality calculation, based on the current performance data.
Choose
4. Choose
Test to do this. In a logon group, the instance with the highest quality key figure is always selected for the logon.
See also:
Recommendations for Logon Load Balancing and User Groups
Questions and Answers: Logon Load Balancing
2.6 PC Installation
Use
When you upgrade an SAP System from Release 2.x to Release 3.x, copy the file saplogon.exe to the directory in which the sapgui.exe file was installed. The
saplogon.ini file should be saved locally in the Windows directory. You should save the sapmsg.ini and saproute.ini files, however, in the frontend installation
directory.
Procedures
1. In your Windows installation directory, check the sapmsg.ini file.
With Windows 3.1/3.11, the files are normally in the directory c:\windows. Wiith Windows NT they are normally in the directory c:\winnt .
The first line must contain the entry [Message Server] . For each SAP System that is available, the following entry should exist:
<SID> = <host name on which the message server is running> .
[Message Server]
C11 = hostname.yourdomain
O01 = oss001
saproute.ini
The first line must contain the item [Router]
For each possible network connection, the following entry should exist:
<route name>=<route>
Here <route> is formulated as:
/H/<hostname on which the SAProuter is running>/S/<service>
You can concatenate several of these strings if the connection uses multiple SAProuters.
[Router]
SAP Walldorf=/H/hostname.your.saprouter/S/sapdp99/H/147.204.64.1/S/sapdp99
SAP Foster City=/H/hostname.your.saprouter/S/sapdp99/H/147.204.69.1/S/sapdp99
1. Ensure that the services file (with Windows 3.1/3.11 normally in the directory c:\windows ) for each system contains the following entry in the sapms.ini file:
sapms<SID> <nr.>/tcp
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 7 of 31
sapmsC11 3670/tcp
sapmsO01 3616/tcp
The configuration data is stored in the saplogon.ini file in the Windows installation directory. You can configure the file names and the path specifications of the
saplogon.ini file as you like. You should also save this individually-configured file locally.
If you are the administrator and want to preset a particular selection for the user, you can either deactivate:
selection options for Group Selection and Server Selection
unrestricted user logon
To deactivate the selection options for Group Selection and Server Selection:
To log on to the system, you only need the saplogon.ini file. If sapmsg.ini and saproute.ini are not available locally, the selection options are not available to the
user.
Alternatively, you can call the saplogon.ini file and insert the entry Restricted Mode=1 in the Configuration section. To be on the safe side, save saplogon.ini as a
write-protected file. You could also set the environment variable to slg_restriction=1 for the entire system.
To deactivate unrestricted logon for the user:
You can use the saplgpad program so that users cannot edit or log on freely to the SAP Logon.
To log on to the system, you only need the preconfigured file saplogon.ini .
sapmsg.ini and saproute.ini are not required at runtime.
saplgpad and saplogon use .ini files from the installation directory. If no .ini files are available in the installation directory, the programs access the Windows
directory. If the system still cannot find any .ini files, saplogon creates saplogon.ini in the Windows directory as well as sapmsg.ini (if this is required).
When the user logs on, the system displays the SAP Logon. This only contains the selection list.
Use
Use SAP Logon to log on to SAP systems. Use the defined entries on the Systems tab to start an SAP system. Use this tab to log on to a specific application
server or to log on to a group to select the application server with the best response time automatically. Use the defined entries on the Shortcuts tab to start SAP
transactions, run reports, or execute system commands directly.
More Information
To start the SAP Logon, perform one of the following: You reach this help in an opened, active SAP Logon window by pressing the F1 key. The user help of the
SAP Logon is context-sensitive: The related section of the documentation is displayed depending on the screen that you are currently on.
Operation Modes
Purpose
Operation modes let you flexibly adapt the system configuration to varying requirements, maximizing the use of available system resources.
An operation mode defines a resource configuration for the instances in your system. It can be used to determine which instances are started and stopped, and
how the individual services are allocated for each instance in the configuration.
You can define operation modes to suit specific system requirements, for example, to provide additional dialog or background processing resources during a
particular period of time without having to restart the system.
Operation modes define:
The number of work processes used for each service in the instance
The times that the services are available
Operation modes support:
24 hour uninterrupted system operation
Automatic switching of work process types
Note
An instance is not created through an operation mode. Instances are created when the system is installed, and can be assigned to operation modes.
See also:
Example: Day and Night Operation
Instances
Consistency Check
Switching Operation Modes
Switching Operation Modes Automatically
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 8 of 31
3.1
Use
The Computing Center Management System (CCMS) is shipped to every customer site pre-configured so that all internal functionality is intact. The consistency
and/or accuracy of this function depends to a significant degree on how you configure the operation modes .
Prerequisites
Note
To be able to work with the CCMS, you require the authorization S_RZL_ADM.
You receive administrator authorization with S_RZL_ADM 1.
You receive display authorization with S_RZL_ADM 3.
If operation modes, instances, or the timetable are not correctly defined, the CCMS will not display meaningful data. For example, in this case, the job scheduling
monitor will not be able to determine where background processes are currently running, and the alert monitor may report errors for the operation modes.
Before you can work with the CCMS, it must be set up correctly. To ensure the accuracy of the data of the monitored system, you must define at least one
operation mode and maintain the operation modes calendar.
Note
If no operation modes have been defined, the test operation mode DUMMY will be displayed. This operation mode is automatically configured so that system
functions such as the Control Panel and background processing can be used. The operation mode DUMMY cannot be used for operation mode switching.
Existing operation modes are listed as they were previously defined. For example, you may see one or more operation modes for daytime operation and one or
more for nighttime operation.
Procedure
1. To set up operation modes, choose CCMS Configuration Operation Modes/Instances or call transaction RZ04.
2. The screen CCMS: Maintain Operation Modes and Instances appears. You can create and change operation modes and instances from here.
More information:
Defining Operation Modes
Switching Operation Modes
Creating an Instance Definition for All Servers
Creating an Instance Definition for One Server
Maintaining Instance Definitions
3.2
Use
When operation modes are switched, the work processes are redistributed automatically without stopping and restarting the instances.
Only the work process types are changed. For example, a work process used as a dialog process can be switched for use as a background process.
The new process type is not activated until the process is free. This means that a process might not be switched immediately. Instead, a process is set to be
switched when next possible. For example, if all background processes to be switched to dialog processes still have jobs, the processes are switched one by
one when the jobs are completed.
Processing is not interrupted. Normal system operation continues uninterrupted during the operation mode switch.
Operation mode switches are recorded in the system log. The old process type and the new process type are recorded for each work process that is switched.
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 9 of 31
alert values, performs profile checks and creates DUMMY operation modes. The profile parameter rdisp/autoabaptime controls the intervals at which the
program runs. The default cycle is 300 seconds.
SAPMSSY6 only switches operation modes if the application server is not running in an operation mode. Normally, the system is switched within 5 minutes of
system startup to the operation mode defined in the operation mode calendar.
SAPMSSY6 does not perform a continuous switch. This means that a manual operation mode switch will not be switched back after 5 minutes.
Timed Operation Mode Switch
The exact times for operation mode switches are defined in the operation mode calendar.
A timed operation mode switch is started by the job scheduler (SAPMSSY2). The operation mode switch can therefore only be performed automatically if at least
one job scheduler is running in the system. This means that at least one background work process and parameter rdisp/btctime > 0 must be available.
The switch is always done for all servers defined in the operation mode.
If more than one job scheduler is running, only one job scheduler can activate an operation mode switch.
See also:
Switching Operation Modes
Switching Operation Modes Automatically
Normal Operation
Exception Operation
Switching Operation Modes Manually
The time intervals defined for the operation modes are repeated in a 24 hour cycle
Exception operation
The time intervals defined for the operation modes are activated once for a specified time
period
Only productive operation modes can be switched automatically. Test operation modes cannot be entered in the timetable.
See also:
Normal Operation
Exception Operation
3.2.2
Use
You can switch an operation mode manually at any time.
However, you must always ensure that a manual operation mode switch does not interrupt system operation, for example because there are too few dialog
processes available.
Note
Before you switch the operation mode manually in the system, you can perform a simulation of the switch .
Procedure
1.
2.
3.
4.
Choose CCMS Control/Monitoring Control Panel, or call transaction RZ03. The system displays information about operation modes and server status.
Choose Choose operation mode. The system displays a list of defined operation modes.
Choose the operation mode that you want to switch to. You return to the list of operation modes and servers.
To switch the operation mode on all servers, choose Control Switch operation mode All servers. The servers remain in the manually activated
operation mode until the next switch time.
Note
You can also switch the operation mode on individual servers. However, you should only do this in exceptional cases, for example, if automatic
switching has not worked correctly.
If an operation mode switch cannot be performed on all of the selected servers, the system displays an error message. The test log for operation mode switching
(Log) provides information to help you decide whether or not to go ahead with the switch anyway.
More information:
Switching Operation Modes Automatically
3.2.3
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 10 of 31
3.2.3
Use
Before you switch an operation mode in the system, you can simulate this switch.
Procedure
To start the simulation from the SAP Easy Access menu, choose Administration CCMS Control/Monitoring Control Switch Operation Mode
Simulation.
The test log describes the possible switches and the errors that may occur, which you can then avoid for the "real" operation mode switch.
See also:
Switching Operation Modes
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 11 of 31
2. Choose Other operation mode and enter the name of an operation mode in the Operation mode field. Repeat this for all the operation modes whose work
process distribution you want to change.
3. Change the work process distribution for the new operation mode as required.
4. Save your changes.The changes will take effect when the operation mode is next activated.
To set the same work process distribution for all operation modes, enter ' * ' for all operation modes. This definition does not depend on the operating system.
See also:
Rules for Work Process Distribution
3.4
Use
You can define a new operation mode or change an existing operation mode.
Procedure
1. Choose CCMS Configuration Operation Modes/Instances, or call transaction RZ04.
The system displays a list of productive instances.
Note
If you have not yet defined any operation modes, the test operation mode DUMMY will be displayed. This operation mode is automatically configured so
that system functions such as the Control Panel and the scheduling of background jobs can be used.
If there is already a DUMMY operation mode, this is updated every time that the server is started, and is therefore adjusted to different system
relationships.
The operation mode DUMMY cannot be used for operation mode switching.
2. Create an operation mode (which can be automatically switched).
To do this, choose Operation Mode Create.
3. Enter the data in the following fields:
Operation Mode
Enter a name for the operation mode, such as DAY_OPERATION , and a short
description. You can enter any name for the operation mode, but it is advisable to
choose a name that is meaningful and that makes the task of the operation mode
clear.
Short Description
Enter a short description of the operation mode, such as "Day operation with 6 dialog
processes".
Note
You can call the operation mode maintenance from the Control Panel.
See also:
Instances
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 12 of 31
3.5
Use
You can define separate operation modes for day and night operation. This means you can guarantee response times for important data entry transactions during
the day, and use more work processes at night for job processing.
Between 6:00 and 20:00, you will predominantly use the system for dialog processing. Outside that time, system resources are primarily required for background
jobs.
You can reconfigure your system dynamically at set times by switching operation modes and thus avoid the disadvantages of a system restart.
The diagram below illustrates the effect of an operation mode switch:
Procedure
You can display the status of the operation modes and instances using the control panel. To do this, choose CCMS Control/Monitoring Control Panel.
Note
Assume that your system has a total of ten work processes available. Define an operation mode for night operation to allow more efficient data processing at
night.
In the timetable for automatic operation mode switching, enter the times for the two operation modes:
6 a.m. to 8 p.m. for day operation
8 p.m. to 6 a.m. for night operation
Table: Operation mode switching: Day/night operation
Work Process Distribution
Dialog
Background
Update
5
1
2
2
4
2
Enqueue
Spool
1
1
1
1
Most resources will then be available for dialog processing during the day. At 8 p.m. the operation mode will be switched automatically, making more system
resources available for background jobs and data transfer from other systems. At 6 a.m. the next day, the day operation mode will automatically be activated,
making more system resources available for dialog processing.
See also:
Instances
Scheduling an Operation Mode Switch
Switching Operation Modes
3.6
Definition
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 13 of 31
Before you can maintain operation modes and instances in the CCMS, you must have correctly installed the SAP sytsem. The installation procedure for distributed
instances ensures that the following actions are carried out:
The shared file systems in the SAP system are automatically mounted on the host system of the distributed instance.
The instance directories are created.
The users are defined in the host system.
The operating system kernel for the instance is generated in accordance with the host system attributes.
Entries in the configuration files of the host system are maintained (such as hosts and services).
Start and system profiles are generated for the instances
You can use the program sapstart and the installed profiles to start the system.
After starting the SAP system, you begin the required configuration tasks.
See also:
Profile Files
Defining Operation Modes
Choose CCMS Configuration Operation mode timetable. Alternatively, call Transaction SM63.
Choose Normal operation (24 hr), and Display.
The system displays the timetable for the 24 hour cycle.
To assign other times to the operation mode, choose Normal operation (24 hr) and Change.
Double-click on the start time and end time that you require.
Choose Assign to assign these times to the operation mode.
Enter the name of the operation mode to be active for the time period that you defined.
You can only select productive operation modes.
Save the changes.
Finally, save the table.
You must always define a full 24 hour cycle, that is, the operation modes must be set up for 24 hour system operation. If the timetable is not defined:
The start configuration according to the profile will remain active
No unattended automatic operation mode switch is possible
The job scheduling monitor will not function properly
When a job is created or released with start date/time, it will not be possible to check whether background processes are available at the start time
Jobs that are scheduled to start when the operation mode is switched are not started.
See also:
Exception Operation
Switching Operation Modes
See also:
Normal Operation
Switching Operation Modes
3.9
Use
When an operation mode has been switched you can see in the process overview whether the work process types have been changed correctly.
Procedure
To monitor the work processes on your current application server:
From the SAP Easy Access menu, choose Administration Monitor System Monitoring Process Overview. Alternatively, call Transaction SM50.
The system displays an overview of the work processes for the server you have logged onto.
The information for each work process is displayed in a row. The Ty. column shows the work process type: for example, DIA is a dialog process, BTC is a
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 14 of 31
background process.
To monitor the work processes on a different application server:
From the SAP Easy Access menu, choose Administration Monitor System Monitoring Servers. Alternatively, call Transaction SM51.
The system displays a list of the SAP servers. To display the processes for a particular server, position the cursor on the line containing the server name, then
choose Processes.
See also:
Global Work Process Overview
3.10
Use
The primary function of the control panel is to start or stop instances. However, you can also use it to check whether instances were started correctly and whether
they are running in the correct operation mode; that is, whether automatic operation mode switching is possible.
Procedure
To display an overview of operation modes and instances:
1. Start the Control Panel by choosing CCMS Control/Monitoring Control Panel.
The control panel displays a list of the host systems and the instances in your system. The list contains:
Instance names
Status
Services running on your application server
Active operation mode
2. Select a server.
To find out the cause of a non-standard operation mode:
1. Choose Monitoring Status Details.
The system displays a dialog box showing the details of the server.
The most frequent reason for an operation mode switch failing is inconsistencies in the total number of work processes or in the profiles.
2. When you have solved the problem, switch the operation mode manually from the Control Panel.
3.11
Consistency Check
Use
You can run an error check of the profile definitions to avoid any system problems. This consistency check determines whether changes made to profiles are
valid, and recognizes any settings that will prevent the system from starting or operating properly.
Prerequisites
Consistency checks are only possible for profiles that were maintained using the profile maintenance tool. You cannot perform a consistency check if you have
maintained a profile in any other way, for example with an operating system editor.
Procedure
From the list of productive instances, choose Instance Consistency check.
All the start and instance profiles for the defined instances are checked. The profiles are compared with the current work process distribution. The check
determines, for example, whether the enqueue processes are started on more than one server, or whether the message server has been properly configured.
See also:
Rules for Work Process Distribution
Instances
Definition
SAP instances are defined during the installation of the SAP system.
Note
The term "instance" is often used synonymously with "server" or "application server" in the SAP system. This depends on the selected installation
environment. You can install multiple instances on one application server.
An SAP instance defines a group of resources such as memory, work processes and so on, usually in support of a single application server or database server
within a client/server environment. Application servers share the same memory areas and are controlled by the same dispatcher process.
An SAP instance is handled by CCMS as a unit. A user logs on to the SAP system using an instance.
An SAP system can consist of one or more instances, such as an SAP system with a single instance with only one central server or a client/server system with
two or more separate instances.
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 15 of 31
Note
An SAP instance is not assigned automatically to an operation mode.
More Information:
Creating an Instance Definition for All Servers
Prerequisites for Starting Remote Instances
Creating an Instance Definition for One Server
Consistency Checks
Monitoring Servers and Work Processes
Enter the SAP System number that was specified when your SAP System was
installed.
The name of the start profile from Profiles to start the instance with.
Choose the input help to display a list of available start profiles. You can choose a profile
from the list.
The name of the instance profile from Profiles to run the instance with.
Choose the input help to display a list of available instance profiles. You can choose a
profile from the list.
1. Choose Save. The system checks your configuration automatically when you save and informs you of any inconsistencies. Choose Continue. The result of
the check is displayed in the Display Check Log of Profile window.
UNIX systems only: So that you can start and stop instances from the control panel, you must enable a remote logon on the target UNIX server. See Prerequisites
for Starting Remote Instances
1. In the CCMS: Maintain distribution of work processes dialog box, assign the work processes to at least one operation mode.
2. In the Operation mode field, enter the name of the operation mode or select an operation mode from the list of possible entries. To set the same work process
distribution for all operation modes, enter * .
The system proposes the current work process distribution in the instance profile. However you can change the work process distribution (see Setting the
Work Process Distribution ).
3. Save your changes. To assign the work process distribution to additional operation modes, choose Yes when the system prompts you. Choose No if you do
not want to do this.
4. When you have finished, you can perform a consistency check . Save your changes. All the instance definitions for productive operation modes are then
saved in the database.
To change the assignment of work processes to the instance, see Setting the Work Process Distribution
See also:
Creating an Instance Definition for All Servers
Maintaining Instance Definitions
4.2
Use
You can generate the current instance definition for all the active servers. This procedure is helpful if you want to generate all instance descriptions for the first
time.
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 16 of 31
Procedure
1. Choose CCMS Configuration Operation Modes/Instances Instances/Operation modes, or call transaction RZ04.
2. The screen CCMS: Maintain Operation Modes and Instances appears. Choose Settings Based on current status New instances Generate. The
system now queries the current status of every active application server, and an instance definition is created.
For every configured operation mode, the system creates a work process distribution in accordance with the distribution of the respective instance profile.
3. Save the new instance.
4. Define the work process distribution for switching operation modes .
Note
If you want to start and stop servers from the control panel , you should maintain the instance startup user.
More information: Prerequisites for Starting Remote Instances
5. When you have finished defining the work process distribution, you can perform a consistency check .
It only makes sense to do this if you are maintaining profiles using the CCMS profile maintenance tool.
6. Save your changes. All the instance definitions for productive operation modes are then saved in the database.
See also:
Creating an Instance Definition for One Server
Maintaining Instance Definitions
4.3
Note
Prior to SAP R/3 4.5A, you could use transaction RZ04 (Tools CCMS Configuration Operation modes/instances) to store a UNIX user and password
for use in starting SAP instances on remote servers. The remote start-up capability (and the user and password) were used in the CCMS control panel
(Transaction RZ03) and in the CCMS system monitor (Transaction RZ02), for example.
The SAP system needs a stored user and password only for starting SAP instances on remote UNIX servers. Remote start-up of instances on AS/400 and
Microsoft Windows servers uses other mechanisms and requires no user and password.
It is no longer possible to store a user and password in the SAP system. You should therefore maintain the UNIX files listed above to enable remote startup
and shutdown of SAP instances.
Further, whenever Transaction RZ04 is started, the system checks whether a user and password have been stored. If so, the user (the system administrator)
is warned about the problem. If the user so wishes, the user and password are deleted automatically by the system.
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 17 of 31
1. From the list of productive instances, position the cursor on the line with the operation mode or work process.
2. Choose Instance Delete entry. Only the assignment to that work process is deleted.
To delete an operation mode:
1. From the list of productive operation modes, position the cursor on a line with the operation mode.
2. Choose Operation mode Delete. The operation mode, and all the instances and work process definitions assigned to it, are deleted.
The automatically configured DUMMY operation mode is no longer needed once you have defined your operation modes. Delete the DUMMY operation mode as
described above.
See also:
Creating an Instance Definition for All Servers
Creating an Instance Definition for One Server
Profiles
Purpose
SAP profiles are operating system files that contain instance configuration information. SAP systems can consist of one or more instances. Individual configuration
parameters can be customized to the requirements of each instance. These individual parameters allow you to configure:
The runtime environment of the instance (resources such as main memory size, shared memory, roll size)
Which services the instance itself provides (work processes)
Where other services can be found (database host)
Features
The profile file is structured as follows:
# This is a comment in an SAP profile:
Parametername1 = Value1
Parametername2 = Value2
Parameter names that logically belong together have a common root. For example, the root of parameters that control the dispatcher within an application server is:
rdisp/.
Tip
The parameter rdisp/wp_non_dia specifies how many dialog work processes are started by the dispatcher.
The SAP profiles are stored in a special file directory. This directory can be made accessible from all hosts, depending on current requirements.
UNIX systems:/usr/sap/<SID>/SYS/profile
Microsoft Windows systems:\\<SAPGLOBALHOST>\saploc\<SID>\SYS\profile\
<SID> is the system ID of the SAP system, and <SAPGLOBALHOST> is the name of the host on which the global profile directory physically exists.
saploc is the name of a share; by default, this is the directory [drive]:\usr\sap.
All host computers in an SAP System can access these profiles.
Note
To edit configuration profiles in the SAP system, use transaction RZ10 (Edit Profiles). You should therefore not edit the active profiles directly at operating
system level.
See also:
Saving and Importing Profiles After Installation
Profile Files
Profile Maintenance
5.1
Use
After you have used the SAP installation program SAPINST to install a new system or a new instance, we recommend that you perform the following steps:
Back up all profiles in the profile directory at operating system level.
This provides you with additional security if you can no longer start the system due to incorrect changes to the profiles. In this case, you can copy the
original profiles back to the profile directory and ensure that the system can be started to analyze and correct the cause of the error.
Import all profiles.
During an initial installation of an SAP system, an upgrade to a new SAP release, or the addition of a new application server, the system automatically
generates or updates the profile files at operating system level. However, the installation program cannot store profiles directly in the database. Since we
recommend that you edit profiles exclusively using the profile maintenance tool, you need to ensure that the current version of the profiles exists in the
database. You can do this by importing the profiles.
You can import profiles at any time; however, if you consistently use only the profile maintenance tool to make changes to the profiles, you only need to do
so after installation and upgrade.
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 18 of 31
Note
Make sure all application servers (instances) are active before you importing profiles.
5.2
5.2.1
Process Flow
Parameter values in instance profiles can contain the following variables:
$(parameter name) is replaced by the value of the parameter name specified in brackets.
Tip
Param1 = '/usr/sap/C11/D53/dbg'
Param2 = $(Param1)/stats
Therefore Param2 = /usr/sap/C11/D53/dbg/stats
$$is replaced by the SAP system number.
Tip
Param3 = logfile$$.
SAPSYSTEM = 29
Therefore Param3 = logfile29
You can also define local replacement variables. These values are not used by the SAP programs, they are only relevant within a profile. They contain
values used for setting up or filling parameter values. The names of these local replacement variables begin with an underscore ('_') .
Tip
_SAP_PROFILE_DEFAULT = /usr/sap/C11/SYS/profile/DEFAULT.PFL
Param4 = _SAP_PROFILE_DEFAULT.
This results in Param4 = /usr/sap/C11/SYS/profile/DEFAULT.PFL
5.2.2
Definition
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 19 of 31
When an SAP instance is installed on a computer using the SAP installation program SAPINST, a start profile and an instance profile are automatically
generated. If it is the first instance of an SAP system, the system also creates a default profile. Otherwise, the existing default profile is simply updated.
The installation program assigns various profile settings, such as buffer sizes, important data directories, and the name of the database host.
The profiles are placed in a global file directory so as to have access from every client in the system.
See also:
Saving and Importing Profiles After Installation
Profiles start page
5.2.3
Definition
Parameters can be in default profiles or instance profiles . Parameter values are configured as shown below:
The value that a profile parameter receives is determined by the following rules:
If the parameter is set in the instance profile, it always has this value.
If the parameter is set in the default profile, it receives this value only if it is not set in the relevant instance profile.
If the parameter is set in neither the instance profile nor the default profile, it receives the default value from the relevant coding.
Note
If possible, ensure that a particular parameter appears only in the default profile or in the instance profile.
5.2.4
Profile
Use
One of the tasks of the instance profile is to control which SAP services are started (for example, the message server, dialog, gateway, or enqueue process).
Note
Up NW2004s, there were standalone start profiles for this purpose. Their functions have now been integrated into the instance profiles.
You can start the following processes:
Application server
Message server
SNA gateway
System log send demon
System log receive demon
The following parameter names will are used for this:
Execute_xx (xx = 00-99): To start operating system commands that prepare the start of the SAP system. For example, you can use this parameter to start
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 20 of 31
the database used with the SAP system or to set up links to executables on UNIX platforms.
Start_Program_xx(xx = 00-99): To start an SAP instance, for example on an application server.
Stop_Program_xx(xx = 00-99): To start an operating system command or SAP program after the SAP instance has been stopped. For example, the
stopping or removing of shared memory areas that were used by the SAP system.
The number xx defines the execution sequence. The programs specified in the Execute_ parameters are executed before the programs listed in the
Start_Program parameters. After the instance has been stopped, the programs specified in the Stop_Program parameters are started.
Features
To run a program on the local host, place the word local in front of the relevant parameter value:
Execute_00 = local sapmsesa 53 remove
To execute a program on a remote host, place the host name in front of the parameter value:
Execute_00 = hs0011 sapmsesa 53 remove
Profiles start page
5.3
Profile Files
Definition
During installation, two profiles are created in the file system:
DEFAULT.PFL
<SID>_<instance>_<host name>
These profiles contain the parameters that determine the operating system resource usage of the instance, for example, the number of work processes, the
buffer sizes.
You import and activate these profiles using the profile maintenance tool. After that, you should simply maintain and activate the profiles using the profile
maintenance .
Profiles start page
5.3.1
Default Profile
Definition
To assign the same parameter value for all application servers, for example, the name of the database host or the computer on which the message server is
running, enter it in the default profile. In general, you can list any parameter you like here.
We recommend that you use the following values:
Parameter Definition
SAPDBHOST
rdisp/vbname
rdisp/enqname
rdisp/btcname
rdisp/msname
Name of the TCP service under which the message server can be reached
rdisp/msserv
rdisp/sna_gateway
Name of the TCP Service under which the SNA Gateway can be reached
rdisp/sna_gw_service
Note
You cannot choose a name for the default profile. It is always called DEFAULT.PFL. The default profile is, like all other profiles, in the global profile directory of
the SAP system.
Tip
Example of a typical default profile for a double-stack system:
#.***********************************************************#.* *#.* Default profile DEFAULT *#.* *#.* Version = 000005 *#.* Generated by User = NAKE
*#.* Date of Generation = 04.01.2007 , 13:21:04 *#.* *#.*************************************************************SAPDBHOST =
WDFN00148651Aj2ee/dbtype = sapj2ee/dbname = PMNj2ee/dbhost = WDFN00148651Aj2ee/dbadminurl = http://WDFN00148651A:9999/webdbm?
Server=WDFN00148651A&Database=PMN&User=controlSAPSYSTEMNAME = PMNSAPGLOBALHOST = WDFN00148651A#------------------------------------------------------------# SAP Central Service Instance for J2EE#-------------------------------------------------------------j2ee/scs/host = WDFN00148651Aj2ee/scs/system =
01j2ee/ms/port = 3901rdisp/bufrefmode = sendoff,exeoff#-------------------------------------------------------------# SAP Messaging Service for ABAP#------------------------------------------------------------rdisp/mshost = WDFN00148651Ardisp/msserv = sapmsPMNrdisp/msserv_internal = 3900login/system_client = 001
5.3.2
Instance Profiles
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 21 of 31
5.3.2
Instance Profiles
Definition
Instance profiles provide an application server with additional configuration parameters that complement the settings in the default profile . Typically, these
parameter settings adapt the instance according to the desired resources. They also define the available instance resources (main memory, shared memory, roll
memory, and so on), and how to allocate memory to the SAP application buffers.
Tip
Example of a typical instance profile for a double-stack instance:
#.***************************************************************#.* *#.* Instance profile PMN_DVEBMGS00_WDFN00148651A *#.* *#.* Version = 000011
*#.* Generated by User = NAKE *#.* Date of Generation = 04.01.2007 , 13:31:26 *#.*
*#.***************************************************************SAPSYSTEMNAME = PMN#parameter created by: NAKE 27.12.2005
17:20:32rsdb/ntab/entrycount = 10000#parameter created by: NAKE 27.12.2005 17:20:04rsdb/ntab/ftabsize = 10000SAPGLOBALHOST =
WDFN00148651ASAPSYSTEM = 00INSTANCE_NAME = DVEBMGS00DIR_CT_RUN =
$(DIR_EXE_ROOT)\$(OS_UNICODE)\NTI386DIR_EXECUTABLE = $(DIR_INSTANCE)\exeDIR_PROFILE = $(DIR_INSTALL)\profile_PF =
$(DIR_PROFILE)\PMN_DVEBMGS00_WDFN00148651Ajstartup/trimming_properties = offjstartup/protocol = onjstartup/vm/home =
C:\j2sdk1.4.2_09jstartup/max_caches = 500#parameter created by: NAKE 27.12.2005 17:27:38alert/MONI_SEGM_SIZE = 20000000jstartup/release =
700jstartup/instance_properties = $(jstartup/j2ee_properties);$(jstartup/sdm_properties)j2ee/dbdriver =
C:\sapdb\programs\runtime\jar\sapdbc.jarPHYS_MEMSIZE = 128#old_value: 3 changed: KRIEGER 27.04.2006 15:59:26rdisp/wp_no_dia = 4#old_value: 2
changed: KRIEGER 19.12.2006 11:26:35rdisp/wp_no_btc = 3rdisp/j2ee_start_control = 1rdisp/j2ee_start = 1rdisp/j2ee_libpath =
$(DIR_EXECUTABLE)exe/j2ee = $(DIR_EXECUTABLE)\jcontrol$(FT_EXE)rdisp/j2ee_timeout = 600rdisp/frfc_fallback = onicm/HTTP/j2ee_0 =
PREFIX=/,HOST=localhost,CONN=0-500,PORT=5$$00icm/server_port_0 = PROT=HTTP,PORT=80$$#----------------------------------------------------------------#
SAP Messaging Service parameters are set in the DEFAULT.PFL#----------------------------------------------------------------ms/server_port_0 =
PROT=HTTP,PORT=81$$rdisp/wp_no_enq = 1rdisp/wp_no_vb = 1rdisp/wp_no_vb2 = 0rdisp/wp_no_spo = 1rsdb/dbid = PMNdbs/ada/schema =
SAPPMN#------------------------------------------------------------# Jcontrol: Migrated Profile Parameter# create at Wed Nov 30 16:29:57 2005#-----------------------------------------------------------j2ee/instance_id = ID0037994#------------------------------------------------------------alert/cache/size_MB = 10mpi/buffer_size =
32768mpi/total_size_MB = 20abap/buffersize = 100000alert/GREEN_ALERTS = 1icm/keep_alive_timeout = -1icm/host_name_full =
wdfn00148651a.wdf.sap.corp#------------------------------------------------------------------# Copy SAP Executables#-----------------------------------------------------------------Start_Program_00 = immediate $(DIR_CT_RUN)\sapcpe$(FT_EXE) pf=$(_PF)#------------------------------------------------------------------# Start ABAP database#-----------------------------------------------------------------_DB = $(DIR_CT_RUN)\strdbs.cmdStart_Program_01 = immediate $(_DB) PMN#-----------------------------------------------------------------# Start SAP messaging service#------------------------------------------------------------------_MS =
$(DIR_EXECUTABLE)\msg_server$(FT_EXE)Start_Program_02 = local $(_MS) pf=$(_PF)#------------------------------------------------------------------# Start application
server#------------------------------------------------------------------_DW = $(DIR_EXECUTABLE)\disp+work$(FT_EXE)Start_Program_03 = local $(_DW) pf=$(_PF)#-----------------------------------------------------------------# Start internet graphics server#------------------------------------------------------------------_IG =
$(DIR_EXECUTABLE)\igswd$(FT_EXE)Start_Program_04 = local $(_IG) -mode=profile pf=$(_PF)rsdb/dbid = PMNdbs/ada/schema = SAPPMN
You can choose any name for an instance profile. The SAP naming convention has the following structure: <SID>_<instance name>_<host name>.
Profiles start page
5.4
Maintaining Profiles
Use
With non-production systems, you can often make changes to system profiles. In the case of production SAP systems, changes to the system profiles are only
rarely required. In both cases, you should use the profile maintenance to maintain the profiles.
The profile maintenance tool has the following advantages:
Convenience of use
Extensive profile checks
Testing of (several) individual profiles for consistency
No inconvenient profile editing at operating system level
Changes to profiles are logged
Profile data is held in the SAP database (security, consistency)
Provision of basic data for operation mode switching
Note
You should no longer edit profiles with an editor at operating system level. It only makes sense to do this if the SAP system cannot be started in any
other way.
Integration
You can edit profiles using basic maintenance or extended maintenance.
In basic maintenance, general data bout the profile and the parameters for buffer sizes, the number of work processes, and swap requirements is
displayed.
In extended maintenance, the individual parameter values for the profile are displayed.
Note
Detailed documentation is available for every parameter in the profile. To display the documentation, place the cursor on the parameter and choose F1.
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 22 of 31
Prerequisites
Set Authorizations
To use the profile maintenance, assign authorization values to the authorization object S_RZL_ADM in accordance with the desired processing mode:
Processing Mode
01, 03
Display profiles
03
Import Profiles
Since you are working with profile data from the SAP database in the profile maintenance, you need to ensure that this data matches the corresponding active
profiles in the file systems of the instances. You do this by importing the profiles. To import the profiles for all active servers, choose Utilities Import Profiles
Of Active Servers. More information: Saving and Importing Profiles After Installation .
Ensure that you import the profiles in the following situations:
Before you first use the profile maintenance
After installing a new application server
After changing a profile at operating system level
To check whether the profile in the database matches the active profile in the file system, you can compare these profiles at any time. To do this, select the
desired profile in the profile maintenance and choose Profile Compare Profile in Database Against Active Profile.
Profiles start page
5.4.1
Use
You can use profile maintenance to change and switch profile parameters.
Procedure
1.
2.
3.
4.
Call profile maintenance by choosing CCMS Configuration Profile Maintenance. Alternatively, call transaction RZ10.
In the Profile field, specify the name of the profile for which you want to change parameters.
To maintain the most important profile parameters, select Basic maintenance and choose Change. Once you have made the changes, choose Copy.
In Extended maintenance, you can create, change, or delete all parameters in a profile. Once you have made the changes, choose Copy.
Note
You can switch between Basic and Extended maintenance at any time. Changes are only copied when you save them to the database .
5. Changes to the profile parameters only become active when the relevant instance is next restarted. An exception to this are dynamically-switchable profile
parameters. To determine which profile parameters can be switched dynamically, choose Profile Dyn. Switching Display Parameters.
6. To switch the values of these profile parameters immediately (rather than only after the next start of the instance), change the profile parameters as
describes above, and then choose Profile Dyn. Switching Execute. Specify the instance for which the dynamic switching is to be performed.
Profiles start page
5.4.2
Use
When you change and save a profile, the old status in the database is not overwritten. Instead, a separate version with the changed values is created. The SAP
system allocates an individual number for each profile version. For example, when you create a new profile, it has the version number 1. All additional versions
are then numbered sequentially.
The associated profile file at operating system level is only overwritten if you explicitly specify this within the profile maintenance transaction (the system prompts
you accordingly when you save a profile). You can only activate the most recent version of a profile. However, you can also reactivate older versions by copying
them.
For each parameter that you change, a corresponding comment is stored in that same profile.
Tip
If user BATCHMAN changes the number of update work processes in an instance profile from 0 to 1. The following entry is made:
# old value: 0 changed by: BATCHMAN, 9.8.1995, 16:45:38rdisp/wp_no_vb = 1
Using the versions of the profile and the associated modification comments, you should be able to trace the history of all changes.
In particular, you can confirm whether a profile file has been changed manually at operating system level by comparing the profile information in the database with
the active profile in the operating system. If the profile data is not identical, the operating system files have been manually changed. The system writes all
differences in a log, and triggers an alert in the Alert Monitor .
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 23 of 31
Procedure
1. Call profile maintenance by choosing CCMS Configuration Profile Maintenance.
2. Specify the name and version of the profile that you want to examine, and choose Profile Comparisons Profile in database With active profile. If the
system finds differences, it displays these in a log.
Profiles start page
Note
The profile maintenance tool ensures that changes to profiles are activated when the corresponding SAP instance is restarted. You cannot make changes to
an SAP instance during active operation.
Procedure
1. Call profile maintenance by choosing
Administration
CCMS
Configuration
Profile Maintenance
2. To call the individual functions in the table, execute the relevant commands specified:
Function
Command
Save profiles
Choose
Choose Utilities
Activate profiles
Utilities
Profile
Save
Profile
Check
In operation modes
Profile
Activate
Note
Stop the instance(s) in which you want the profile changes to take effect, and
restart them.
Check Rule
Example
Integer value
rdisp/TRACE
Time value
rdisp/btctime
Boolean value
Legal values:
0, 1ON, OFFYES, NOTRUE, FALSE
gw/accept_remote_trace_level
rdisp/workdir
File name
abap/rsyn
rdisp/mshost
rdisp/msserv
rdisp/vbname
File mask
enque/log_file
Strings
abap/locale_ctype
Special parameters
Start Parameters
More Information
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 24 of 31
5.4.4
Use
You can use transaction RSPFPAR to determine which parameters are active for a particular instance.
Procedure
1. Call transaction RSPFPAR.
2. Start this program on the instance that has the parameter values you are interested in.
The system displays a list that consists of two parts:
The first part shows the parameter values in unsubstituted form, that is, before the substitute variables were replaced.
The second part displays the actual values of the individual parameters.
See also:
Variables in Profile Values
Profiles start page
5.4.5
Deleting Profiles
Use
You can either delete single profiles or all versions of a profile as follows:
Procedure
1. Call profile maintenance by choosing CCMS Configuration Profile Maintenance. Alternatively, call transaction RZ10.
2. To delete a single profile, choose Profile Delete Individual Profile.
3. To delete all versions of a profile, choose Profile Delete All versions Of a profile.
Note
Initially, the profiles are deleted from the database. However, you can also delete the corresponding profile files at operating system level.
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 25 of 31
See also:
What Information is Displayed?
Additional Parameters
Maintaining External Commands
6.2
Use
You can create, display, change, delete, rename, and copy external commands. SAP commands cannot, however, be changed in customer systems.
External commands can only be processed individually. For example, you cannot delete several external commands at the same time. External commands
cannot be used by multiple users simultaneously.
Procedure
1. Choose CCMS Configuration External Commands, or call transaction SM69.
2. You can then display or change the external commands. To display a list of all external commands defined in the system, choose Display Change.
External commands are uniquely identified by a user-definable logical name and an operating system.
You can specify the name of an ABAP function module which, at the time of execution, decides whether the specific command should be executed or not. The
interface to this check module must be the same as for the check module SXPG_DUMMY_COMMAND_CHECK delivered by SAP.
Caution
SAP recommends that you copy SXPG_DUMMY_COMMAND_CHECK before using it. Do not change this function module in your system.
Note
Command names beginning with 'X' or 'Z' are reserved for customer commands.
See also:
What Information Is Displayed?
Additional Parameters
Executing External Commands
6.3
Definition
An external command is a pre-defined operating system command that can be executed within the SAP system.
Both the maintenance and execution of external commands is protected with SAP authorizations. You can maintain and execute external commands in dialog
(from the CCMS menu) or in ABAP programs, using special function modules. External commands can also be executed as a step in a background job.
As the CCMS administrator, you can modify commands and activate additional security mechanisms without having to change the program.
You can add your own commands and parameters to the variety of (pre-defined) commands delivered by SAP.
See also:
Authorizations for External Commands
Executing External Commands
Maintaining External Commands
Security Checks
6.4
Use
To create or change external commands, you require appropriate authorization.
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 26 of 31
Procedure
Define the authorizations for executing external commands in the SAP system and assign them to users through authorization profiles. Authorizations can be given
for all external commands, for groups of external commands, or for individual commands. They can also be restricted to specific computers.
The system does not differentiate between capital and lowercase letters in authorizations.
Table: Purpose of SAP Authorizations
SAP Authorization
Purpose
S_RZL_ADM
with activity '01'
S_LOG_COM
OPSYSTEM
HOST
The authorization S_LOGCOM_ALL, which enables the execution of all external commands, is delivered as standard in the profiles S_A.SYSTEM and
S_A.ADMIN.
See also:
Security Checks
6.5
Definition
When you execute or maintain external commands, a list of the commands is displayed. Each line in the list contains a brief summary of the most important
information about an individual command.
The first two columns contain the name of the external command and an operating system on which the external command should be executed.
Note
The operating system does not have to be the same as the specific operating system. However, we recommend that you adapt the type to the ABAP runtime
variable SY OPSYS where possible, since the default for operating system is SY OPSYS when an external command is executed.
You can also enter the name of the syntax group belonging to SY OPSYS or the name ANYOS, provided the corresponding command can be used
universally.
See also: documentation for SXPG_CALL_SYSTEM.
Type
There are two different identifiers in the column Type: SAP and Customer.
External commands of the type SAP are delivered by SAP and cannot be changed in customer systems. Customers can create commands of the type Customer.
These commands are not changed during release upgrades.
We recommend that you only use commands of the type Customer for in-house developments (that is, in your own ABAP sources).
Note
Commands are automatically created with the type Customer in customer systems.
OS Command
In the fourth and fifth columns, you can see the specific operating system command and the predefined parameters with which it should be executed. These two
values are not shown in their entirety in this list, but can be defined with up to 128 characters each.
See also:
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 27 of 31
6.5.1
Procedure
You can display detailed information on a command by double-clicking it.
The system displays the operating system command and the predefined parameters in full, as well as whether or not additional parameters can be included when
the command is executed.
Note
For security reasons, information relevant to system security is only displayed in 'Display mode' if the user has CCMS administrator authorization. This
information includes, for example, the name of the check module and whether an entry is made in the system log when the command is executed.
See also:
Additional Parameters
Profile Parameters in External Commands
6.5.2
Additional Parameters
Definition
When executing an external command, you can include a character string of up to 128 characters containing additional parameters.
Prerequisites:
The use of additional parameters must be allowed for this command (standard).
Maintaining External Commands
The total length of all parameters (predefined and passed at runtime) cannot exceed the maximum length of 128 characters.
Placeholder
These additional parameters are generally added to the end of pre-defined parameters following a blank space. You can, however, also define placeholders for
these additional parameters within the pre-defined parameters.
Purpose
'?'
'&'
If no parameter values (or a blank character string) is passed at runtime for a required parameter, then the exception PARAMETER_EXPECTED is triggered. The
placeholder '&' for optional parameters is removed in this case. Otherwise, the characters '?' and '&' are replaced with the parameter character string passed.
See also:
Displaying Detailed Information
Profile Parameters in External Commands
6.6
Definition
You can decide whether the value of a profile parameter is entered in the command text at runtime (for operating system commands and the predefined
parameters). A placeholder for a profile parameter must have the following syntax:
$-SAPSYSTEMNAMEThe first place must always contain a '$', followed by a separator which does not appear in the names of any profile parameters. The subsequent text is
interpreted as the name of a profile parameter until the separator appears again. The complete character string, from '$' up to and including the second separator,
is replaced by a value defined for the profile parameter before the operating system command is executed. The value of the profile parameter is used as defined
in the target system, provided an application server was started there.
Tip
/usr/sap/$-SAPSYSTEMNAME-/SYS/exe/run/sapgui
If the profile parameter SAPSYSTEMNAME had the value 'ABC', then the character string above would look like this:
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 28 of 31
/usr/sap/ABC/SYS/exe/run/sapgui
Special Characters
Use the following special characters:
$ To identify profile parameters
? Placeholder for required parameters
& Placeholder for optional parameters
# Escape character
If you want to use '$' as a regular character, then you need to precede it with '#' as an escape character. You must enter the escape character '#' twice if you
want to use it in the text.
See also:
Displaying Detailed Information
Additional Parameters
Illegal Characters
AIX
HP-UX
Windows NT
VMS
other
If you want to prohibit the use of other characters, SAP recommends that you use check modules. If you want to avoid these restrictions, you should use shell
scripts or in-house C programs.
See also:
Check Modules
Illegal Changes to External Commands
Syslog Trace and System Alert Monitor
6.6.1.1
Check Modules
Definition
When maintaining an external command, you can specify the name of a check module. A check module is a function module that is executed immediately before
the command, and can decide whether the command will be executed or not.
Your system already contains the prototype of such a check module:
SXPG_DUMMY_COMMAND_CHECK
The check module contains an ABAP comment with an example of how it is used.
Do not change the check module SXPG_DUMMY_COMMAND_CHECK, but instead work with a copy. You can freely define the name of the check module.
Only the interface has to be the same as for the check module SXPG_DUMMY_COMMAND_CHECK. The check module can only stop the execution of the command
by triggering the exception NO_PERMISSION.
See also:
Processing Illegal Changes to External Commands
Syslog Trace and System Alert Monitor
6.7
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 29 of 31
Use
When a CCMS administrator calls the command maintenance transaction, he or she is informed of any changes that were made to external commands by means
other than the maintenance transaction.
The administrator can then decide whether or not to accept these changes or to restore the old status. It is not possible to execute an illegally created or changed
external command. A corresponding entry is written in the system log.
Procedure
To accept or reset changes:
Illegal changes are displayed in two lists. You can switch between these two lists by selecting Show original values and Show changed values.
1. Select (in the appropriate list) the command that you want to accept or reset.
2. Choose Reset to orig. value or Accept ill. changes.
Caution
Note the list in which you are currently working:
If you are in the list of original commands, the changes will be reset in all of the commands selected.
If you are in the list of changed commands, the changes will be accepted.
In both cases, the corresponding commands are then removed from the lists of changed commands.
As soon as you exit the list, the system displays the list of all external commands defined in this system.
See also:
Check Modules
Syslog Trace and System Alert Monitor
6.7.1
Use
If a user tries to execute a command that was created or changed illegally, an entry is automatically made in the system log.
The syslog area 'LC' is reserved for external commands.
You can decide whether these events are displayed in the alert monitor.
To maintain the alert thresholds:
From the SAP Easy Access menu, choose Tools CCMS, Configuration Alert Monitor Threshold Values (3.x).
Alternatively, call Transaction RZ06.
See also:
Check Modules
Processing Illegal Changes to External Commands
Use
Use DB connection maintenance to maintain the SAP table DBCON. This table contains information about additional non-standard database connections (such as
database system, password, and so on).
Procedure
To call DB connection maintenance, choose Administration CCMS DB administration DB connections. Alternatively, use Transaction DBCO.
A table for DB connection maintenance appears. The table includes the following columns:
Name of connection
Logical name of database connection
DBS
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 30 of 31
Database system
Database user name
Database user
Database password
Password to create the connection to the database
Connection information
Database system-dependent information about the database connection.
Displaying Details about the Database Connection
1. Select the entry
2. Choose Details.
Adding New Information to Database Connections
1.
2.
3.
4.
5.
6.
7.
8.
9.
PUBLIC
2014 SAP AG or an SAP affiliate company. All rights reserved.
Page 31 of 31