| |
| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" |
| "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <html lang="en" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> |
| <head> |
| <meta name="copyright" content= |
| "Copyright (c) IBM Corporation and others 2000, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." /> |
| <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
| <meta http-equiv="Content-Style-Type" content="text/css" /> |
| <link rel="stylesheet" href="../book.css" charset="ISO-8859-1" type= |
| "text/css" /> |
| <title> |
| Setting execution arguments |
| </title> |
| <script language="JavaScript" src= |
| "PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"> |
| |
| </script> |
| </head> |
| <body> |
| <h1> |
| Setting execution arguments |
| </h1> |
| <p> |
| If you want to specify execution arguments for your program, you must |
| define a launch configuration that specifies the arguments. |
| </p> |
| <ol> |
| |
| <li>Select <a class="command-link" href= |
| 'javascript:executeCommand("org.eclipse.debug.ui.commands.OpenRunConfigurations")'> |
| <img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt= |
| "Opens the Run Launch Configurations dialog" /> <strong>Run > Run |
| Configurations...</strong></a> or <a class="command-link" href= |
| 'javascript:executeCommand("org.eclipse.debug.ui.commands.OpenDebugConfigurations")'> |
| <img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt= |
| "Opens the Debug Launch Configurations dialog" /> <strong>Run > |
| Debug Configurations...</strong></a> from the workbench |
| <strong>Run</strong> menu to open the list of launch |
| configurations. Launch configurations for Java programs are |
| shown underneath <strong>Java Application</strong> in this list. |
| |
| </li> |
| <li>Select an existing configuration or create a new launch configuration |
| by pushing the <strong>New</strong> button after selecting <strong>Java |
| Application</strong>. |
| </li> |
| <li>On the <strong>Arguments</strong> tab for the configuration, you can |
| specify the following fields as necessary: |
| <ul> |
| <li> |
| |
| <strong>Program Arguments</strong>: Application-specific values |
| that your code is expecting (a user name or a URL for locating help |
| files, for example). |
| </li> |
| <li> |
| <strong>VM Arguments</strong>: Values meant to change the behavior |
| of the Java virtual machine (VM). For example, you may need to tell |
| the VM whether to use a just-in-time (JIT) compiler, or you may |
| need to specify the maximum heap size the VM should use. Refer to |
| your VM's documentation for more information about the available VM |
| arguments. |
| </li> |
| <li> |
| <strong>Other options</strong>: This allows to set the option |
| <strong>-XX:+ShowCodeDetailsInExceptionMessages</strong> |
| when the checkbox is checked. This is selected by default for a launch configuration using Java 14 and above. |
| </li> |
| <li> |
| <strong>@argfile</strong>: When the list of application-specific and VM arguments become very long |
| this checkbox can be checked. All arguments will then be written into a file and the file is |
| passed to the VM as single argument. This is only supported for a launch configuration using Java 9 and above. |
| </li> |
| <li> |
| <strong>Working Directory</strong>: The working directory used for |
| the launched process. To change from using the default working |
| directory, select <strong>Other</strong> and specify the workspace |
| or local directory to use for the working directory of the launched |
| process. |
| </li> |
| |
| </ul> |
| </li> |
| <li>Click <strong>Apply</strong> or <strong>Close</strong> when you |
| are done. Every time you launch this configuration, these execution |
| arguments will be used. |
| </li> |
| </ol> |
| |
| <h3 class="related">Related tasks</h3> |
| <a href="../tasks/tasks-java-local-configuration.htm">Creating a Java |
| Application launch configuration</a><br /> |
| <a href="task-launching_java_program.htm">Launching a Java |
| program</a> |
| </body> |
| </html> |