The Run page of the Runtime Properties dialog box lets you set parameters to pass to your application, applet, server, and JUnit test suites at runtime. Available features vary by JBuilder edition.
There are several ways to display the Runtime Properties dialog box:
The Configuration Name field is displayed at the top of the dialog box:
Each tab represents a type of process. The Run Process icon is displayed on the selected tab, showing the currently active process type.
This is a feature of JBuilder Personal:
JBuilder supports a single configuration only, but you can edit that one configuration to suit your needs for each run/debug/optimize task and type of runner needed.
This is a feature of JBuilder SE and Enterprise:
JBuilder supports multiple configurations for each type of runner. You can edit each configuration individually.
Important: Many wizards that create runnable files, such as the Application wizard and Applet wizard, allow you to create a runtime configuration for that file if one does not already exist. In JBuilder Personal, this wizard-created runtime configuration replaces any existing configuration, since only one runtime configuration of any type can exist at a time. The runtime configuration creation page is usually the last page of the wizard.
See also
Use the Application tab to change options for running applications.
The name of the main class to use when running this application. By definition, a main class must have a public static void main( String [])
method. To select a main class,
The Select Main Class For Project dialog box appears.
When you run a single application file, it's automatically used as its own main class.
Parameters to pass to the Java Virtual Machine (VM). Examples include -classic
, -native
, and -server
.
See also
Command-line arguments to pass to the application, so it can run as required. These are passed as strings and separated by spaces. If any particular parameter contains spaces itself, then it must be in quotes.
The build target to use when running this configuration. Build targets are preconfigured sets of tasks and dependencies.
See also
Use the Applet tab to set options for running applets. There are two ways to run an applet in JBuilder:
For more information, see "JBuilder's AppletTestbed and Sun's appletviewer" in "Working with applets" in the Web Application Developer's Guide.
The name of the applet main class to run. Click the ellipsis button to display the Select Main Class For Project dialog box, where you choose the main class to run. The selected class must subclass java.applet.Applet
.
Note: When this option is selected, choosing Run|Run Project runs the applet in JBuilder's applet viewer, AppletTestbed.
The name of the HTML file containing the <applet>
tag. Click the ellipsis button to display the Choose HTML File To Run dialog box, where you choose the HTML file with the <applet>
tag. The HTML file's code
attribute must contain the fully qualified class name. If the class file is not located in the same directory as the HTML file, the codebase
attribute must specify the location of the class file in relation to the HTML file.
Note: When this option is selected, choosing Run|Run Project runs the applet in Sun's appletviewer.
Parameters to pass to the Java Virtual Machine (VM). Examples include -classic
, -native
, and -server
.
See also
The initial width of AppletTestBed. This is a required field. (Disabled for AppletViewer, which gets it dimensions from the <applet> tag in the applet's HTML file.
The initial height of AppletTestBed. This is a required field. (Disabled for AppletViewer, which gets it dimensions from the <applet> tag in the applet's HTML file.
For applets running in AppletTestBed. Optional parameters to pass to the applet. Examples of optional parameters are CODEBASE
, ARCHIVE
, NAME
, HSPACE
, VSPACE
and PARAM
. The AppletViewer uses the corresponding <param> elements in the <applet> tag. Note that these parameters are applet specific.
Adds a parameter and value to the Applet Parameters list.
To set an applet parameter, click the Add button. Enter the name of the parameter in the Parameter column. Enter the value in the Value column.
Removes the selected parameter and value from the Applet Parameters list.
This page is a feature of JBuilder Enterprise.
Set the options on this page to configure the selected server and select the servlet or JSP file to run.
The target server selected on the Server page of the Project Properties dialog box. Available services depend on the selected server. If the project uses more than one server, this option is a combobox with the servers listed as options.
Choosing a server changes the available categories on the page and selects the server that is actually launched for this run configuration. If you have two different servers in the same project, you will need two separate runtime configurations, one for each server.
The category of the selected server or service to configure. Categories are server dependent. When you select a category, you see fields appear on the panel on the right if there are any.
Note that the information on the right panel can be different for every category for each server. For example, the JSP/Servlet panel for BES is slightly different than the one for Tomcat.
Choose a server from the list below for information on server and service categories that can be configured:
Note: Unchecking a service here disables that service when launching the server. This should make the server start and stop faster. If you do not want to include a service in your project, uncheck it on the Server page of the Project Properties dialog box. That will prevent extra libraries from being included in your project.
Borland Enterprise Server AppServer Edition 5.0.2+
Category | Description | |
---|---|---|
Server: Command Line | VM Parameters | Parameters to pass to the Java Virtual Machine (VM). For more information on the Java VM and the options you can pass to it, see "Basic Tools: java - The launcher for Java technology applications". |
Server Parameters | Parameters to pass to the BES partition executable, primarily the server and the partition names. | |
Make Project Output Path Available On Run | Makes classes in the project's classes directory available when running the selected server. JBuilder adds the directory to the classpath of the generated command line. |
|
Make Project Libraries Available On Run | Adds the libraries' classpath to the generated classpath. | |
Disable Tracing Into Server Classes | Choose the Disable Tracing Into Server Classes option to prevent tracing into server-side classes. For more information about tracing, see "Controlling which classes to trace into" in the "Debugging Java programs" chapter of Building Applications with JBuilder. | |
Server: Libraries | Server Library Directory | The location of the server's libraries. |
Libraries To Deploy At Runtime | The project libraries to deploy at runtime. Check the libraries to deploy. | |
Server: Archives | Archive Types Supported | The types of archives supported by this server. This read-only field displays the server's current classloader policy: container-wide or per module. For more information, see the Borland Enterprise Server documentation. |
Project Archives To Deploy At Runtime | The fully-qualified names of the archive files that will be deployed to the specified server instance. Archives are listed in the order of deployment. The archive name is listed in red if the archive doesn't exist. Make sure the build target for the runtime configuration creates the archive. | |
Remove Archives Already Deployed To Server | Checking this check box allows the clearing of the existing archives already deployed to the current partition. After the existing archives are removed, archives you have selected to deploy are deployed to the partition. | |
Move Up | Moves the selected archive up in the list. | |
Move Down | Moves the selected archive down in the list. | |
Services: Connector | N/A | |
Services: EJB | N/A | |
Services: JDataStore | N/A | |
Services: JSP/Servlet | Uses the standard JSP/Servlet panel. See the Tomcat 3.3 or 4.0 table. | |
Services: Naming/Directory | N/A | |
Services: Session | N/A | |
Services: Transaction | N/A |
Borland AppServer 4.5
Category | Description | |
---|---|---|
Server: Command Line | VM Parameters | Parameters to pass to the Java Virtual Machine (VM). For more information on the Java VM and the options you can pass to it, see "Basic Tools: java - The launcher for Java technology applications". |
Server Parameters | Parameters to pass to the server, including the port number, the lib and bin directory locations, and the location of the license file. |
|
Server Instance Name | The name of the application server instance that will be running the selected server. | |
Make Project Output Path Available On Run | Makes classes in the project's classes directory available when running the selected server. JBuilder adds the directory to the classpath of the generated command line. |
|
Make Project Libraries Available On Run | Adds the libraries' classpath to the generated classpath. | |
Disable Tracing Into Server Classes | Choose the Disable Tracing Into Server Classes option to prevent tracing into server-side classes. For more information about tracing, see "Controlling which classes to trace into" in the "Debugging Java programs" chapter of Building Applications with JBuilder. | |
Server: Archives | Archive Types Supported | Displays the archive types that this server supports. |
Project Archives To Deploy At Runtime | Displays the list of archives in the project. Check the check box of each archive you want to deploy, unchecking any you do not want to deploy. | |
Move Up | Moves the selected archive up in the list. | |
Move Down | Moves the selected archive down in the list. | |
Service: EJB | N/A |
iPlanet Application Server 6.x+
Category | Description | |
---|---|---|
Server: Command Line | VM Parameters | Parameters to pass to the Java Virtual Machine (VM). For more information on the Java VM and the options you can pass to it, see "Basic Tools: java - The launcher for Java technology applications". |
Server Parameters | Parameters to pass to the server, including the port number, the lib and bin directory locations, and the location of the license file. |
|
Make Project Output Path Available On Run | Makes classes in the project's classes directory available when running the selected server. JBuilder adds the directory to the classpath of the generated command line. |
|
Make Project Libraries Available On Run | Adds the libraries' classpath to the generated classpath. | |
Disable Tracing Into Server Classes | Choose the Disable Tracing Into Server Classes option to prevent tracing into server-side classes. For more information about tracing, see "Controlling which classes to trace into" in the "Debugging Java programs" chapter of Building Applications with JBuilder. | |
Server: Archives | Archive Types Supported | Displays the archive types that this server supports. |
Project Archives To Deploy At Runtime | Displays the list of archives in the project. Check the check box of each archive you want to deploy, unchecking any you do not want to deploy. | |
Move Up | Moves the selected archive up in the list. | |
Move Down | Moves the selected archive down in the list. | |
Service: EJB | N/A | |
Service: JSP/Servlet | Launch URI | Click the ellipsis button to the right of the Launch URI field to choose the JSP or servlet to run. The Type Or Choose URI To Launch dialog box is displayed. |
Query String | Enter any user parameters in the Query String field. User parameters are a series of name/value pairs separated by an ampersand, for example, a=1&b=2. You can also enter a query string if the client is using the doGet() method to read information from the servlet or JSP. This string is appended to any URL generated for a web run, and usually includes parameters for the servlet or JSP. |
|
Host Name | Enter the name of the running web server. localhost is the default. |
|
Port Number | Enter the port number the running web server is listening to. Use the default port number, 8080. Change this value only if the default value is in use. |
Tomcat 3.3
Category | Description | |
---|---|---|
Server: Command Line | VM Parameters | Parameters to pass to the Java Virtual Machine (VM). For more information on the Java VM and the options you can pass to it, see "Basic Tools: java - The launcher for Java technology applications". |
Server Parameters | Extra parameters, if any, to pass to Tomcat's starter class. | |
Make Project Output Path Available On Run | Makes classes in the project's classes directory available when running the selected server. JBuilder adds the directory to the classpath of the generated command line. |
|
Make Project Libraries Available On Run | Adds the libraries' classpath to the generated classpath. | |
Disable Tracing Into Server Classes | Choose the Disable Tracing Into Server Classes option to prevent tracing into server-side classes. For more information about tracing, see "Controlling which classes to trace into" in the "Debugging Java programs" chapter of Building Applications with JBuilder. | |
Server: Libraries | Server Library Directory | The location of the server's libraries. |
Libraries To Deploy At Runtime | The project libraries to deploy at runtime. Check the libraries to deploy. | |
Service: JSP/Servlet | Launch URI | Click the ellipsis button to the right of the Launch URI field to choose the JSP or servlet to run. The Type Or Choose URI To Launch dialog box is displayed. |
Query String | Enter any user parameters in the Query String field. User parameters are a series of name/value pairs separated by an ampersand, for example, a=1&b=2. You can also enter a query string if the client is using the doGet() method to read information from the servlet or JSP. This string is appended to any URL generated for a web run, and usually includes parameters for the servlet or JSP. |
|
Host Name | Enter the name the web server should assume in the Host Name field. Do not choose a name already in use in your sub-net. localhost is the default. |
|
Port Number | Enter the port number the web server should listen to in the Port Number field. Use the default port number, 8080. Change this value only if the default value is in use. |
|
Search For Unused Port | Choose the Search For Unused Port option to tell JBuilder to choose another port if the specified one is in use. (The port is only searched for the first time a web run is requested.) It is useful to select this option when you are running more than one servlet or JSP, as otherwise you might get a message that the port is busy. It is also useful to check this option in the event that a user problem brings the web server down. With this option selected, you will be protected if the web server is not shut down properly. This option works in conjunction with the Launch options on the Web page of the IDE Options dialog box when the specified port is in use by a non-web process. |
Tomcat 4.0
Category | Description | |
---|---|---|
Server: Command Line | VM Parameters | Parameters to pass to the Java Virtual Machine (VM). For more information on the Java VM and the options you can pass to it, see "Basic Tools: java - The launcher for Java technology applications". |
Server Parameters | Extra parameters, if any, to pass to Tomcat's starter class. For Tomcat 4.0, use -nonaming to disable Tomcat's internal naming service, which might conflict with another naming service you are using. |
|
Make Project Output Path Available On Run | Makes classes in the project's classes directory available when running the selected server. JBuilder adds the directory to the classpath of the generated command line. |
|
Make Project Libraries Available On Run | Adds the libraries' classpath to the generated classpath. | |
Disable Tracing Into Server Classes | Choose the Disable Tracing Into Server Classes option to prevent tracing into server-side classes. For more information about tracing, see "Controlling which classes to trace into" in the "Debugging Java programs" chapter of Building Applications with JBuilder. | |
Server: Libraries | Server Library Directory | The location of the server's libraries. |
Libraries To Deploy At Runtime | The project libraries to deploy at runtime. Check the libraries to deploy. | |
Service: JSP/Servlet | Launch URI | Click the ellipsis button to the right of the Launch URI field to choose the JSP or servlet to run. The Type Or Choose URI To Launch dialog box is displayed. |
Query String | Enter any user parameters in the Query String field. User parameters are a series of name/value pairs separated by an ampersand, for example, a=1&b=2. You can also enter a query string if the client is using the doGet() method to read information from the servlet or JSP. This string is appended to any URL generated for a web run, and usually includes parameters for the servlet or JSP. |
|
Host Name | Enter the name the web server should assume in the Host Name field. Do not choose a name already in use in your sub-net. localhost is the default. |
|
Port Number | Enter the port number the web server should listen to in the Port Number field. Use the default port number, 8080. Change this value only if the default value is in use. |
|
Search For Unused Port | Choose the Search For Unused Port option to tell JBuilder to choose another port if the specified one is in use. (The port is only searched for the first time a web run is requested.) It is useful to select this option when you are running more than one servlet or JSP, as otherwise you might get a message that the port is busy. It is also useful to check this option in the event that a user problem brings the web server down. With this option selected, you will be protected if the web server is not shut down properly. This option works in conjunction with the Launch options on the Web page of the IDE Options dialog box when the specified port is in use by a non-web process. |
WebLogic Application Server 5.1
Category | Description | |
---|---|---|
Server: Command Line | VM Parameters | Parameters to pass to the Java Virtual Machine (VM). For more information on the Java VM and the options you can pass to it, see "Basic Tools: java - The launcher for Java technology applications". |
Server Parameters | Parameters to pass to the server, including the port number, the lib and bin directory locations, and the location of the license file. |
|
Server Instance Name | The name of the application server instance that will be running the selected server. | |
Make Project Output Path Available On Run | Makes classes in the project's classes directory available when running the selected server. JBuilder adds the directory to the classpath of the generated command line. |
|
Make Project Libraries Available On Run | Adds the libraries' classpath to the generated classpath. | |
Disable Tracing Into Server Classes | Choose the Disable Tracing Into Server Classes option to prevent tracing into server-side classes. For more information about tracing, see "Controlling which classes to trace into" in the "Debugging Java programs" chapter of Building Applications with JBuilder. | |
Server: Archives | Archive Types Supported | Displays the archive types that this server supports. |
Project Archives To Deploy At Runtime | Displays the list of archives in the project. Check the check box of each archive you want to deploy, unchecking any you do not want to deploy. | |
Move Up | Moves the selected archive up in the list. | |
Move Down | Moves the selected archive down in the list. | |
Service: EJB | N/A | |
Service: JSP/Servlet | Launch URI | Click the ellipsis button to the right of the Launch URI field to choose the JSP or servlet to run. The Type Or Choose URI To Launch dialog box is displayed. |
Query String | Enter any user parameters in the Query String field. User parameters are a series of name/value pairs separated by an ampersand, for example, a=1&b=2. You can also enter a query string if the client is using the doGet() method to read information from the servlet or JSP. This string is appended to any URL generated for a web run, and usually includes parameters for the servlet or JSP. |
|
Host Name | Enter the name the web server should assume in the Host Name field. Do not choose a name already in use in your sub-net. localhost is the default. |
|
Port Number | Enter the port number the web server should listen to in the Port Number field. Use the default port number, 8080. Change this value only if the default value is in use. |
|
Search For Unused Port | Choose the Search For Unused Port option to tell JBuilder to choose another port if the specified one is in use. (The port is only searched for the first time a web run is requested.) It is useful to select this option when you are running more than one servlet or JSP, as otherwise you might get a message that the port is busy. It is also useful to check this option in the event that a user problem brings the web server down. With this option selected, you will be protected if the web server is not shut down properly. This option works in conjunction with the Launch options on the Web page of the IDE Options dialog box when the specified port is in use by a non-web process. |
WebLogic Application Server 6.x+
Category | Description | |
---|---|---|
Server: Command Line | VM Parameters | Parameters to pass to the Java Virtual Machine (VM). For more information on the Java VM and the options you can pass to it, see "Basic Tools: java - The launcher for Java technology applications". |
Server Parameters | Parameters to pass to the server, including the port number, the lib and bin directory locations, and the location of the license file. |
|
Server Instance Name | The name of the application server instance that will be running the selected server. | |
Make Project Output Path Available On Run | Makes classes in the project's classes directory available when running the selected server. JBuilder adds the directory to the classpath of the generated command line. |
|
Make Project Libraries Available On Run | Adds the libraries' classpath to the generated classpath. | |
Disable Tracing Into Server Classes | Choose the Disable Tracing Into Server Classes option to prevent tracing into server-side classes. For more information about tracing, see "Controlling which classes to trace into" in the "Debugging Java programs" chapter of Building Applications with JBuilder. | |
Server: Archives | Archive Types Supported | Displays the archive types that this server supports. |
Project Archives To Deploy At Runtime | Displays the list of archives in the project. Check the check box of each archive you want to deploy, unchecking any you do not want to deploy. | |
Move Up | Moves the selected archive up in the list. | |
Move Down | Moves the selected archive down in the list. | |
Service: Connector | N/A | |
Service: EJB | N/A | |
Service: JSP/Servlet | Launch URI | Click the ellipsis button to the right of the Launch URI field to choose the JSP or servlet to run. The Type Or Choose URI To Launch dialog box is displayed. |
Query String | Enter any user parameters in the Query String field. User parameters are a series of name/value pairs separated by an ampersand, for example, a=1&b=2. You can also enter a query string if the client is using the doGet() method to read information from the servlet or JSP. This string is appended to any URL generated for a web run, and usually includes parameters for the servlet or JSP. |
|
Host Name | Enter the name the web server should assume in the Host Name field. Do not choose a name already in use in your sub-net. localhost is the default. |
|
Port Number | Enter the port number the web server should listen to in the Port Number field. Use the default port number, 8080. Change this value only if the default value is in use. |
|
Search For Unused Port | Choose the Search For Unused Port option to tell JBuilder to choose another port if the specified one is in use. (The port is only searched for the first time a web run is requested.) It is useful to select this option when you are running more than one servlet or JSP, as otherwise you might get a message that the port is busy. It is also useful to check this option in the event that a user problem brings the web server down. With this option selected, you will be protected if the web server is not shut down properly. This option works in conjunction with the Launch options on the Web page of the IDE Options dialog box when the specified port is in use by a non-web process. |
WebSphere Application Server 3.5
Category | Description | |
---|---|---|
Server: Command Line | VM Parameters | Parameters to pass to the Java Virtual Machine (VM). For more information on the Java VM and the options you can pass to it, see "Basic Tools: java - The launcher for Java technology applications". |
Server Parameters | Parameters to pass to the server, including the port number, the lib and bin directory locations, and the location of the license file. |
|
Make Project Output Path Available On Run | Makes classes in the project's classes directory available when running the selected server. JBuilder adds the directory to the classpath of the generated command line. |
|
Make Project Libraries Available On Run | Adds the libraries' classpath to the generated classpath. | |
Disable Tracing Into Server Classes | Choose the Disable Tracing Into Server Classes option to prevent tracing into server-side classes. For more information about tracing, see "Controlling which classes to trace into" in the "Debugging Java programs" chapter of Building Applications with JBuilder. | |
Server: Archives | Archive Types Supported | Displays the archive types that this server supports. |
Project Archives To Deploy At Runtime | Displays the list of archives in the project. Check the check box of each archive you want to deploy, unchecking any you do not want to deploy. | |
Move Up | Moves the selected archive up in the list. | |
Move Down | Moves the selected archive down in the list. | |
Service: EJB | N/A |
WebSphere Application Server Advanced Edition 4.0
Category | Description | |
---|---|---|
Server: Command Line | VM Parameters | Parameters to pass to the Java Virtual Machine (VM). For more information on the Java VM and the options you can pass to it, see "Basic Tools: java - The launcher for Java technology applications". |
Server Parameters | Parameters to pass to the server, including the port number, the lib and bin directory locations, and the location of the license file. |
|
Make Project Output Path Available On Run | Makes classes in the project's classes directory available when running the selected server. JBuilder adds the directory to the classpath of the generated command line. |
|
Make Project Libraries Available On Run | Adds the libraries' classpath to the generated classpath. | |
Disable Tracing Into Server Classes | Choose the Disable Tracing Into Server Classes option to prevent tracing into server-side classes. For more information about tracing, see "Controlling which classes to trace into" in the "Debugging Java programs" chapter of Building Applications with JBuilder. | |
Server: Archives | Archive Types Supported | Displays the archive types that this server supports. |
Project Archives To Deploy At Runtime | Displays the list of archives in the project. Check the check box of each archive you want to deploy, unchecking any you do not want to deploy. | |
Move Up | Moves the selected archive up in the list. | |
Move Down | Moves the selected archive down in the list. | |
Service: EJB | N/A | |
Service: JSP/Servlet | Launch URI | Click the ellipsis button to the right of the Launch URI field to choose the JSP or servlet to run. The Type Or Choose URI To Launch dialog box is displayed. |
Query String | Enter any user parameters in the Query String field. User parameters are a series of name/value pairs separated by an ampersand, for example, a=1&b=2. You can also enter a query string if the client is using the doGet() method to read information from the servlet or JSP. This string is appended to any URL generated for a web run, and usually includes parameters for the servlet or JSP. |
|
Host Name | Enter the name of the running web server. localhost is the default. |
|
Port Number | Enter the port number the running web server is listening to. Use the default port number, 8080. Change this value only if the default value is in use. |
WebSphere Application Server Single Server 4.0
Category | Description | |
---|---|---|
Server: Command Line | VM Parameters | Parameters to pass to the Java Virtual Machine (VM). For more information on the Java VM and the options you can pass to it, see "Basic Tools: java - The launcher for Java technology applications". |
Server Parameters | Parameters to pass to the server, including the port number, the lib and bin directory locations, and the location of the license file. |
|
Make Project Output Path Available On Run | Makes classes in the project's classes directory available when running the selected server. JBuilder adds the directory to the classpath of the generated command line. |
|
Make Project Libraries Available On Run | Adds the libraries' classpath to the generated classpath. | |
Disable Tracing Into Server Classes | Choose the Disable Tracing Into Server Classes option to prevent tracing into server-side classes. For more information about tracing, see "Controlling which classes to trace into" in the "Debugging Java programs" chapter of Building Applications with JBuilder. | |
Server: Archives | Archive Types Supported | Displays the archive types that this server supports. |
Project Archives To Deploy At Runtime | Displays the list of archives in the project. Check the check box of each archive you want to deploy, unchecking any you do not want to deploy. | |
Move Up | Moves the selected archive up in the list. | |
Move Down | Moves the selected archive down in the list. | |
Service: EJB | N/A | |
Service: JSP/Servlet | Launch URI | Click the ellipsis button to the right of the Launch URI field to choose the JSP or servlet to run. The Type Or Choose URI To Launch dialog box is displayed. |
Query String | Enter any user parameters in the Query String field. User parameters are a series of name/value pairs separated by an ampersand, for example, a=1&b=2. You can also enter a query string if the client is using the doGet() method to read information from the servlet or JSP. This string is appended to any URL generated for a web run, and usually includes parameters for the servlet or JSP. |
|
Host Name | Enter the name of the running web server. localhost is the default. |
|
Port Number | Enter the port number the running web server is listening to. Use the default port number, 8080. Change this value only if the default value is in use. |
This is a feature of JBuilder Enterprise.
Use the test tab to set up a runtime configuration for unit testing.
The name of the main test case or test suite class to run. Click the ellipsis button to display the Select Main Class For Project dialog box, where you choose a class to run.
The selected class will be run using the selected test runner.
Parameters to pass to the Java Virtual Machine (VM). For more information on the Java VM compiler and the options you can pass to it, see "Basic Tools: java - The launcher for Java technology applications" at http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html.
The test runner to use for running the tests. There are three test runners to choose from: