Technology Blogs by SAP
Learn how to extend and personalize SAP applications. Follow the SAP technology blog for insights into SAP BTP, ABAP, SAP Analytics Cloud, SAP HANA, and more.
Showing results for 
Search instead for 
Did you mean: 
Active Participant
Currently if you want to change the BO server parameter, such as adding “-trace”, you have to log on to CMC, open the Properties dialog and do the change there. In some cases, the users will limit the usage of CMC. It means sometimes they will want a way do to this changing without CMC. To achieve this, we can use BO SDK to create a program and use the program to change the command line.

Below is a simple java sample code. The logic is quite simple. First reading the input to get the user info to log on the system. And run a CMS query to get the infoobject of the Server. Then, using the interface IConfiguredContainer and IExecProps to read and write the command line parameter.

  • In this sample, the input from the command line is as the below format:
    -cms <cms> -username <username> -password <password> -serverid <serverid> -authentication <authentication>
    Parameter authentication is optional. If no input it will use secEnterprise. Parameter serverid is the SI_ID of the server which you want to perform the change.

package bosdk;

import java.util.HashMap;
import java.util.Map;

import com.businessobjects.sdk.plugin.desktop.common.IConfiguredContainer;
import com.businessobjects.sdk.plugin.desktop.common.IExecProps;
import com.crystaldecisions.sdk.framework.CrystalEnterprise;
import com.crystaldecisions.sdk.framework.IEnterpriseSession;
import com.crystaldecisions.sdk.framework.ISessionMgr;
import com.crystaldecisions.sdk.occa.infostore.IInfoStore;
import com.crystaldecisions.sdk.plugin.desktop.server.ExpectedRunState;
import com.crystaldecisions.sdk.plugin.desktop.server.IServer;

public class ChangeServerCommandLine {

@SuppressWarnings({ "unchecked", "rawtypes" })
public static void main(String[] args) {

// Process the input parameter
Map<String, String> m_args = null;
if (args.length > 0) {
m_args = new HashMap();
parseArgs(args, m_args);
} else {
"Arguments not passed. Usage:-cms <cms> -username <username> -password <password> -serverid <serverid> and -authentication <authentication> Note: authentication argument is optional");

String cms = (String) m_args.get("cms");
String username = (String) m_args.get("username");
String password = (String) m_args.get("password");
String serverid = (String) m_args.get("serverid");

if ((username == null) || (password == null) || (cms == null) || (serverid == null) || (username.length() == 0)
|| (password.length() == 0) || (cms.length() == 0) || (serverid.length() == 0)) {
"Arguments not passed. Usage:-cms <cms> -username <username> -password <password> -serverid <serverid> and -authentication <authentication> Note: authentication argument is optional");

String authentication = (String) m_args.get("authentication");
if ((authentication == null) || (authentication.length() <= 0)) {
authentication = "secEnterprise";

IEnterpriseSession enterpriseSession = null;
ISessionMgr enterpriseSessionMgr;
try {
// Login and get the server infoobject
enterpriseSessionMgr = CrystalEnterprise.getSessionMgr();
enterpriseSession = enterpriseSessionMgr.logon(username, password, cms, authentication);
IInfoStore infostore = (IInfoStore) enterpriseSession.getService("InfoStore");
String serverQuery = "select * from CI_SYSTEMOBJECTS where SI_ID = " + serverid;
IServer server = (IServer) infostore.query(serverQuery).get(0);

// Get the server command parameter
IConfiguredContainer cfgContainer = server.getContainer();
IExecProps execProps = cfgContainer.getExecProps();

// Print Current Server name and command line info
System.out.println("Server you want to change is: " + server.getTitle());
System.out.println("Command line before change: " + execProps.getArgs());

// Prompt user to input the new command line
System.out.println("Please input the new command line: ");

InputStreamReader is = new InputStreamReader(;
BufferedReader br = new BufferedReader(is);
String command = br.readLine();

// Change the command line

// Prompt user to input if server will be restarted now
System.out.println("Please tell us whether you want to restart the server: (yes or no)");

is = new InputStreamReader(;
br = new BufferedReader(is);
String restart = br.readLine();

// if yes, restart server
if (restart.toLowerCase().equals("yes")) {

// Save the change and print the process is done.;
System.out.println("Change is done! New command line after change: " + execProps.getArgs());

} catch (Exception e) {

private static void parseArgs(String[] args, Map<String, String> m_args) {
for (int i = 0; i < args.length; i++) {
if (args[i].startsWith("-")) {
String arg = trimArg(args[i]);
if (arg.length() != 0) {
String value = "";
if (i < args.length) {
value = args[i];
if (value.startsWith("-")) {
value = "";
m_args.put(arg, value);

private static String trimArg(String arg) {
if (arg == null) {
return arg;
int i = 0;
for (i = 0; i < arg.length(); i++) {
if (arg.charAt(i) != '-') {
String trimmedArg = arg.substring(i);
return trimmedArg;


To run this code, you will also need to include the basic jar files, such as: cecore.jar, celib.jar. cesdk.jar, cesession.jar and etc. All the jar files can be found in the BO installation folder as the following path in a windows installation:
<bo installation>\SAP BusinessObjects Enterprise XI 4.0\java\lib