MATLAB Runtime Startup Options

Set Startup Options Using mcc -R

You can use the mcc command with the -R flag to provide MATLAB^® Runtime options that are passed to the application at initialization time. This option is only used when building standalone applications or Excel^® add-ins.

You can specify the following options using -R.

Option	Description	Target
'-logfile,filename'	Specify a log file name. The file is created in the application folder at runtime and contains information about MATLAB Runtime initialization and all text piped to the command window. Option must be in single quotes. Use double quotes when executing the command from a Windows® Command Prompt. If a file path is specified, the path must exist and must not include environment variables.	MATLAB Compiler™
-nodisplay	Suppress the MATLAB nodisplay run-time warning. On Linux®, open MATLAB Runtime without display functionality.	MATLAB Compiler
-nojvm	Do not use the Java® Virtual Machine (JVM).	MATLAB Compiler
'-startmsg,message'	Customizable user message displayed at initialization time.	MATLAB Compiler Standalone Applications
'-completemsg,message'	Customizable user message displayed when initialization is complete.	MATLAB Compiler Standalone Applications
-singleCompThread	Limit MATLAB to a single computational thread.	MATLAB Compiler
-softwareopengl	Use Mesa Software OpenGL® for rendering.	MATLAB Compiler

For full details, see mcc -R.

Display MATLAB Runtime Initialization Messages

You can display a console message for end users that informs them when MATLAB Runtime initialization starts and completes.

To create these messages, use the -R option of the mcc command.

You have the following options:

• Use the default startup message only (Initializing MATLAB runtime version x.xx)

• Customize the startup or completion message with text of your choice. The default startup message will also display prior to displaying your customized startup message.

When calling mcc in the MATLAB command window, place the comma inside the single quote.

mcc -m hello.m -R '-startmsg,"Message_Without_Space"'

If your initialization message has double quotes in it, escape each quote by preceding it with a backslash. If your initialization message has a space in it, call mcc from the system command window or use !mcc from MATLAB.

Some examples of different ways to invoke this option follow.

This command:	Displays:
mcc -R -startmsg	Default startup message Initializing MATLAB Runtime version x.xx
mcc -R -startmsg,'user customized message'	Default startup message Initializing MATLAB Runtime version x.xx and user customized message for startup
mcc -R -completemsg,'user customized message'	Default startup message Initializing MATLAB Runtime version x.xx and user customized message for completion
mcc -R -startmsg,'user customized message' -R -completemsg,'user customized message"	Default startup message Initializing MATLAB Runtime version x.xx and user customized message for both startup and completion by specifying -R before each option
mcc -R -startmsg,'user customized message',-completemsg,'user customized message'	Default startup message Initializing MATLAB Runtime version x.xx and user customized message for both startup and completion by specifying -R only once