Show TOC

Background documentationCommand Line Arguments for the Java Instance Controller Locate this document in the navigation structure

 

The command line arguments for the Java instance controller may occur in the developer trace of the Java instance controller or in the instance profile for a Java-only instance.

Command Line Arguments
SAP Instance Profile

The SAP instance profile that contains all properties related to the AS Java instance. This file is normally created by SAPinst and contains the SAP instance properties, such as SAPSYSTEM (system number) or SAPSYSTEMNAME (system ID), and so on.

  • Program argument: pf=<filename>

  • Internal default value: this parameter is mandatory; there is no default value

Bootstrap Mode

This option allows you to skip the offline deployment and bootstrap phases when the Java instance is started.

  • Program argument: -bootstrap=[yes/no]

  • SAP profile property: jstart/bootstrap = [yes/no]

  • Internal default value: yes

Trace Level

The trace level is configured in the instance profile; it can be overridden for the Java instance controller with this argument.

  • Program argument: -tracelevel=[0..3]

  • SAP profile property: jstart/TRACE = [0..3] or rdisp/TRACE = [0..3]

  • Internal default value: 1

Special Command Line Arguments

The following command line arguments are used by the JSTART processes to configure the runtime behavior or to tune some specific properties and options.

Caution Caution

You cannot use these command line arguments to configure the Java Startup Framework. These arguments are documented here for trace file analysis only.

End of the caution.
Shared Memory Node ID

The Java instance uses shared memory for administration, monitoring and session management. Each process that accesses this shared memory needs a node ID that identifies the process and assigns a part of the shared memory for status reporting.

  • Program argument: -nodeId=<shared memory ID>

  • Internal default value: -1 (no relation to a shared memory segment)

Java System Properties

The Java VM provides a set of system properties, which can be extended during Java VM initialization. This command line argument is added to the initial set of Java system properties. It may occur several times with different <name>=<value> pairs.

  • Program argument: -hostvm

  • Internal default value: —D<name>=<value>

Operation Mode

The JSTART program can operate in three different modes: Java instance controller, Java launcher, or host process for a Java VM. This argument assigns the Java VM host mode.

  • Program argument: -hostvm

  • Internal default value: depends on the presence of several other command line arguments if the mode is not explicitly assigned

Node Name

The node name specifies the section in the node definition file that defines the node. This (technical) name may differ from the (visible) name of the node in the trace file and the management UIs

  • Program argument: -nodeName=<node name>

  • Internal default value: none

Node Definition File

This file contains the parameters for the node being represented by the JSTART process.

  • Program argument: -file=<file name>

  • Internal default value: none

Java SDK Configuration File

When JSTART operates as a Java instance controller or Java launcher, it analyzes the Java SDK defined in the node definition and instance profile. It then stores the results in the Java SDK configuration file and shares them with the Java host processes.

  • Program argument: -jdkFile=<file name>

  • Internal default value: none

Developer Trace File

The name of the developer trace file. More information: Developer Trace and Log Files.

  • Program argument: -traceFile=<file name>

  • Internal default value: none, trace messages are written to the standard output stream

Detailed Protocol in the Trace File

This option controls the output of the command line options and arguments passed to the child processes, Java VM and Java main method.

  • Program argument: -protocol=[on/off]

  • Internal default value: jstart/protocol

Java VM Output Redirection

This option allows you to redirect the standard and error output of the Java VM to a specified file.

  • Program argument: -jvmOutFile=<file name> or -javaOutFile=<file name>

  • Internal default value: none

Activate Debug Mode

This option activates Java debugging with the debugging agent. It is used to enable debugging with Java VMs from other vendors

  • Program argument: -debugMode=[yes/no]

  • SAP profile property: jstart/debugMode

  • Internal default value: no

Additional Environment Settings

This option allows you to add environment settings to JSTART. The value has to be in the format: envvar1=value;envvar2=value;…

  • Program argument: -environment=<list of environment variables>

  • SAP profile property: jstart/environment

  • Internal default value: none

More Information

SAP Profile Parameters