Configuring an iASP Application Using the Command Line

You can use the java admin.AppTuner command to delete and create ASP applications, list the names of all ASPapplications, and list or edit ASP application properties from the command line (as an alternative to using the Remote Console Applet). You can edit global ASP application properties (application root settings) or properties of a specific application.

Usage

java admin.AppTuner [-options]

Options

-setrootpro property1=value1&property2=value2&...property(n)=value(n)

Defines the property value(s) of the application root so that you can make global changes to all ASP applications. In this case, property1~(n) is the name of the property you want to change and value1~(n) is a new valid value for that property. The ampersand (&) symbol separates the different property value settings.

For example, the following command sets the EnableSession and SessionTimeOut properties for the application root:

java admin.AppTuner -setrootpro EnableSession=true&SessionTimeOut=20

-setrootprofromfile filename="filename"

Defines the property value(s) of the application root (in order to make global changes to all ASP applications) by obtaining the property values from a specified file where filename is the name of the specified file.

For example, the following command references the "setpro.txt" file to set the EnableSession, SessionTimeOut, and MaximumSessions properties for the application root:

java admin.AppTuner -setrootprofromfile filename="setpro.txt"

The content of "setpro.txt" might be:

EnableSession=true
SessionTimeOut=20
MaximumSessions=100

...

-setapppro appname="name" property1=value1&property2=value2&...property(n)=value(n)

Defines the property value(s) of the specified application where name is the name of the application, property1~(n) is the name of the property you want to change and value1~(n) is a new valid value for that property. The ampersand (&) symbol separates the different property value settings.

For example, the following command sets the EnableSession and SessionTimeOut properties for the "appsample" application:

java admin.AppTuner -setapppro appname="appsample" EnableSession=true&SessionTimeOut=20

-setappprofromfile appname="name" filename="filename"

Defines the property value(s) of the specified application by obtaining the property values from a specified file where name is the name of the application and filename is the name of the specified file.

For example, the following command references the "setpro.txt" file to set the EnableSession, SessionTimeOut, and MaximumSessions properties for the "appsample" application:

java admin.AppTuner -setappprofromfile appname="appsample" filename="setpro.txt"

The content of "setpro.txt" might be:

EnableSession=true
SessionTimeOut=20
MaximumSessions=100
...

-deleteapp appname="name"

Deletes the specified applicationwhere name is the name of the application.

For example, the following command deletes the "appsample" application:

java admin.AppTuner -deleteapp appname="appsample"
-addapp appname="name" path="path"

Creates a new application under the current application root, where name is the name of the application you want to create and path is the path to the new application.

For example, the following command adds an application named "appsample:"

java admin.AppTuner -addapp appname="appsample" path="d:\myapps\sample"
-listrootpro [filename="filename"]

Lists the property values that are set for the application root (that is, the global ASP application root properties). If you do not specify a filename (the name of the file in which you want to save the listing of the properties), the output displays on the screen.

For example, the following command displays all the properties of the application root on the screen:

java admin.AppTuner -listrootpro

Alternatively, you can write the current properties of the application root to a file, as the following command shows:

java admin.AppTuner -listapppro filename="apppro.txt"

-listapppro appname="name" [filename="filename"]

Lists the property values for the specified application where name is the name of the application and filename is the name of the file in which you want to save the listing of the properties. (If you do not specify a filename, the output displays on the screen.)

For example, the following command displays all the properties of the "appsample" application on the screen:

java admin.AppTuner -listapppro appname="appsample"

Alternatively, you can write the current properties of an application to a file, as the following command shows:

java admin.AppTuner -listapppro appname="appsample" filename="apppro.txt"

-listallappname [filename="filename"]

Lists the name(s) of all existing application(s) and their corresponding paths under the current application root. If you do not specify a filename (the name of the file in which you want to save the list of applications), the output displays on the screen.

For example, the following command displays a list of all ASP applications on the screen:

java admin.AppTuner -listallappname

Alternatively, you can write the list of applications to a file, as the following command shows:

java admin.AppTuner -listallappname filename="appsname.txt"

Appendix

Property

Description

EnableSession Used to turn on/off session tracking for a page. Session tracking maintains information about a set of requests that are issued by a single client. If True, turn on the session tracking, False to turn it off.
SessionTimeOut Specifies the timeout period of the Session for the application, in minutes. If the user does not refresh or request a page within the timeout period, the session ends.
MaximumSessions Specifies the maximum number of sessions in memory.
EnableBuffering Used to enable of disable buffer the output to the browser or not. If True, all output generated by an ASP program is collected before it is sent to the browser. If False, output is returned to the browser as the page is processed. Buffering output enables you to set HTTP headers from anywhere in an ASP script.
EnableParentPaths Enable or disable to make ASP scripts use relative paths to the parent directory of the current directory (i.e. paths using the .. syntax). If you enable this option, do not allow execute access to the parent directories, otherwise a script could attempt to run an unauthorized program in a parent directory.
DefaultASPLanguage Specifies the primary script language used in the application. Instant ASP comes with two ActiveX script engines: Microsoft Visual Basic Scripting Edition (VBScript) and JScript. The default is VBScript.
ASPScriptTimeout Specifies the length of time Instant ASP will allow a script to run. If the script does not finish running by the end of the timeout period, Instant ASP stops the script and writes an event to the event log. You can set the timeout period to a value between 1 and 2147483647.
Pooling Size

Specifies the number of ASP applications which will be stored on server after finishing execution. The maximum is 50.

SecurityFileName Specifies the physical path and name of the file which contains all security properties.
UnrestrictedAccess Allows or denies all ASP pages and applications to have all accesses/permissions. True for allow and False for deny.
AllowsexecutiontoallScripts Allows or denies to grant execution to unregistered scripts. True for allow and False for deny. This property only works for Application Root.
AllowSubProcess Allows or denies executing sub-process. True for allow and False for deny.
AllowDatabase Allows or denies access to database. True for allow and False for deny.
AllowFileWrite Allows or denies writing any file in the local file system at specified directories. True for allow and False for deny.
AllowFileWriteFileNames List all directories that allow to write any file.
AllowFileRead Allows or denies reading any file in the local file system at specified directories. True for allow and False for deny. 
AllowFileReadFileNames List all directories that allow to read any file.
AllowNetwork Allows or denies establishing network connection. True for allow and False for deny.
AllowJavaClass Allows or denies dynamically accessing to Java classes at run-time. True for allow and False for deny. 
EngineType Specifies the Engine type, there are two types: Interpreter and PreCompiler.
PreCompilerPath Specifies the path for output of PreCompiler.
PreCompilerUpdateSetting Allows or denies to dynamically update the Java source code when ASP changes in the application. Dynamic for allow and Static for deny.
PreCompilerDirectionSetting Specifies to convert ASP to Java or JSP. There are 2 settings: ASPtoJava and ASPtoJSP.
MaximumApplications Specifies the maximum number of applications. "0" represents unlimited number. This property only works for Application Root. 


If you encounter any problems or errors, please contact support@halcyonsoft.com


Copyright © 1998-2002, Halcyon Software Inc. All rights reserved.