Show TOC

Background documentationSAP Profile Parameters Locate this document in the navigation structure

 

The instance profile contains the important SAP profile parameters used by the JSTART program. These parameters apply to the whole AS Java instance. The file is located in /usr/sap/<SID>/SYS/profile/<SID>_<instance name>_<hostname>.

You can edit this file by using a text editor (if you have a Java-only installation) or by using transaction RZ10 (if you have a double-stack system).

Note Note

When editing this file, make sure that there is an empty line at the end of the file.

End of the note.

Structure

The following table contains the description of the instance profile parameters.

Recommendation Recommendation

For normal operation, you will not need to change the default parameter settings. Use the following list if you really need to change settings.

End of the recommendation.

Profile Parameter

(old name in parantheses)

Description

Unit

Default Value

jstart/bootstrap

(jstartup/bootstrap)

Controls whether the initial offline deployment and bootstrap phases happen when an AS Java instance starts.

Logical value

True

jstart/protocol

(jstartup/protocol)

Activates additional protocol output in the developer trace file.

Logical value

True

jstart/debuggable

(jstartup/debuggable)

Protects an instance against debugging, e.g. for productive use.

Logical value

True

jstart/debug_mode

(jstartup/debug_mode)

Activates Java debugging for all server processes. A Java VM in debugging mode is extremely slow. When using the SAP JVM, debugging can be activated if necessary, i.e. “on the fly”.

Logical value

false

jstart/environment

(jstartup/environment)

May contain additional environment variables that are passed by the instance controller to the Java processes.

Character string

jstart/startupNodeFile

(jstartup/startup_properties)

Specifies the name of the file that contains the node definitions for the bootstrap and offline deployment phases.

Note Note

Do not change the value of this parameter.

End of the note.

Character string

$(DIR_EXECUTABLE)/startup.properties

jstart/instanceNodeFiles

(jstartup/instance_properties)

Provides the list of files defining the nodes that build the instance.

Note Note

Do not change the value of this parameter.

End of the note.

Character string

<computed at runtime>

jstart/stackSize

(jstartup/native_stack_size)

Stack size (in bytes) for the Java VM thread.

Whole number; may contain k, m or g as scaling factors.

The value is platform-dependent. It is 256k on 32-bit platforms, 1m on 64-bit Unix platforms, and 2m on 64-bit Windows platforms.

jstart/vm/home

(jstartup/vm/home)

Path to the root directory of the Java SDK

Character string

$(DIR_SAPJVM)

jstart/vm/type

jstartup/vm/type

Java VM type (for example, server, classic, or client).

The values are vendor-specific – refer to the Java VM vendor’s documentation.

Character string

jstart/vm/args

(jstartup/vm/parameters)

Additional VM parameters for all nodes (for example, DsomeName=someValue)

Character string

jstart/vm/libPath

(jstart/vm/libpath)

Specifies a list of directories containing shared libraries.

If this parameter is set, its value overrides the directories found during Java SDK detection.

Character string

jstart/vm/dllname

(jstartup/vm/dllname)

File name of the Java VM shared library (if the library name is not “jvm”).

This parameter can be used to run a debug version of the Java VM that has a different file name.

Character string

jstart/nice

(jstartup/nice)

Allows you to run the node processes at lower priority, e.g. on desktop systems.

This feature is available only on Windows.

Logical value

false

DIR_EXECUTABLE

Directory where the executable files for the startup framework are located.

Character string

SAPSYSTEMNAME

SAP system name. (SID)

Character string with three characters

SAPSYSTEM

SAP instance number.

Whole number (between 00 and 97)

jstart/TRACE

Specifies the trace level for the information logged in the developer trace files.

More information: Incrementing/Decrementing the Trace Level.

Whole number (between 0 and 3)

Value of the rdisp/TRACE parameter.

jstart/TRACE_COMPS

Specifies the trace components that may trace at a higher trace level.

Character string consisting of letters for the trace components and the strings All or all.

Value of the rdisp/TRACE_COMPS parameter

jstart/TRACE_LOGGING

Restricts the size of the developer traces.

Character string with the following syntax: off | on, <n> [ k | m ]

The value of the rdisp/TRACE_LOGGING parameter

jstart/traceVersions

(jstartup/keep_old_logfiles)

Specifies the number of backup versions for trace and log files.

The JSTART program replaces the last one or two digits of the extension with the backup generation or appends an “.n” extension to files that have no extension.

Whole number (between 0 and 99)

5

jstart/shutdownTimeout

(jstartup/shutdown_timeout)

Specifies the shutdown timeout, i.e. the grace period for the AS Java instance to shut down before the Java process terminates itself.

Seconds

120

j2ee/ms/connectTimeout

(jstartup/wait_for_scs)

Specifies the timeout for the first connection to the message server.

The AS Java instance fails to start if this timeout expires.

Seconds

60

j2ee/ms/reconnectTimeout

(jstartup/wait_for_reconnect)

Specifies the timeout for the reconnecting to the message server.

The AS Java instance shuts down when this timeout expires.

Seconds

3600 (one hour)