6.5.1 HCSC-Manager command definition file for Java VM start options
- Organization of this subsection
(1) Format
- In Windows
-
Specify the file in the Win32 batch file format. Δ indicates a halfwidth space.
setΔ cscjvmopt_command-name=Java-VM-start-option-1[ΔJava-VM-start-option-2][Δ...]
- In UNIX
-
Specify the file in the shell script file format. Δ indicates a halfwidth space.
cscjvmopt_command-name="Java-VM-start-option-1[ΔJava-VM-start-option-2[Δ...]"
(2) Function
Specifies the Java VM start options that are applied to each command. You can use this file for the commands whose name begins with csc and which are used in the operating environment or execution environment. For details about the commands used in the operating environment or execution environment, see 5. Commands (Operating and Execution Environments).
The specified Java VM start options are used as the values of environment variables (or variables in UNIX) of the command. Therefore, when you set up or change the file, the settings in the file will be applied when the command is executed the next time.
Note the following when creating the file:
-
In UNIX, enclose the entire option in double quotation marks (").
-
Do not enter a space before or after =.
-
If an invalid value such as a spelling error is specified for a Java VM start option, the system behavior depends on Java VM.
Note that when the Java VM start options are specified, the operation follows the Java VM specification. If an unexpected operation occurs, such as a Java VM error during execution of a command, modify the file and then re-execute the command.
If you specify the following for an argument of a Java VM start option, operations are not guaranteed:
-
A file path containing spaces
-
A file path enclosed in double quotation marks (") or single quotation marks (')
- Example of invalid specification (in UNIX)
cscjvmopt_cscpiselect=-XX:HitachiJavaLog:"/opt/ProgramΔFiles"
(3) File storage location
- In Windows
-
- Template file:
-
service-platform-installation-directory\CSC\config\manager\templates\cscjvmopt.bat
- Storage location of the created file and the file name:
-
service-platform-installation-directory\CSC\config\manager\cscjvmopt.bat
- In UNIX
-
- Template file:
-
/opt/Cosminexus/CSC/config/manager/templates/cscjvmopt
- Storage location of the created file and the file name:
-
/opt/Cosminexus/CSC/config/manager/cscjvmopt
(4) Specifiable Java VM start options
For details such as the range of arguments that can be specified for Java VM start options, see 14. Options for Invoking Java VM in the Application Server Definition Reference Guide. If you specify a Java VM start option that is not described here, operations cannot be guaranteed.
-Xms
Specifies the initial value of the heap area (New area + Old area).
-Xmx
Specifies the maximum value of the heap area (New area + Old area).
-Xss
Specifies the stack size of the thread.
-XX:MetaspaceSize
Specifies the initial value of the Metaspace area.
-XX:MaxMetaspaceSize
Specifies the maximum value of the Metaspace area.
-XX:HitachiJavaLog
Specifies the prefix of the Java VM log file and the directory to output the log files.
- Specification of the log file output destination when multiple HCSC-Manager environments are set up
-
If you set up multiple HCSC-Manager environments on a single machine by specifying multiple CSCMNG_HOME environment variables, make sure that duplicate destinations are not specified for log file output. If duplicate destinations are specified, operations cannot be guaranteed. For details about the CSCMNG_HOME environment variable, see 2.9.2 Procedure for configuring multiple environments on one machine in the Service Platform Setup and Operation Guide.
To switch the log file output destination for each HCSC-Manager environment, we recommend that you have the CSCMNG_HOME environment variable included in the argument (example: XX:HitachiJavaLog:%CSCMNG_HOME%\log).
In this case, the log file output destination changes for each HCSC-Manager environment as follows:
- Setting of the CSCMNG_HOME environment variable (HCSC-Manager environment 1)
set CSCMNG_HOME=C:\WorkPri
This sets the following log file output destination:
C:\WorkPri\log\javalog01.log
- Setting of the CSCMNG_HOME environment variable (HCSC-Manager environment 2)
set CSCMNG_HOME=C:\WorkSec
This sets the following log file output destination:
C:\WorkSec\log\javalog01.log
- Important note
-
If the path specified in the CSCMNG_HOME environment variable contains spaces, you cannot use the CSCMNG_HOME environment variable to specify the path of the log output destination. In this case, switch the output destination by using the CSCMNG_HOME environment variable and another environment variable that specifies a path not containing a space.
-XX:HitachiJavaLogFileSize
Specifies the upper limit of the size of one Java VM log file.
-XX:HitachiJavaLogNumberOfFile
Specifies the maximum number of Java VM log files that can be created.
-XX:[+|-]HitachiVerboseGC
Specifies whether to output extended verbosegc information if a GC occurs.
(5) Example of coding
The following shows examples of coding to specify Java VM start options for the cscpiselect command.
In Windows
set cscjvmopt_cscpiselect=-Xmx512m -Xms512m
In UNIX
cscjvmopt_cscpiselect="-Xmx512m -Xms512m"