Instant ASP Logo

Configuring Application with Command Line

This section explains how to configure the Properties of the application root's or application with command line.

Usage

java admin.AppTuner [-options]

Description

The java admin.AppTuner command line lists the usage message of all options for configuring application root or applications with this command line. 

Options

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

Defines the property value of application root, porperty1~(n) is the name of the property and value1~(n) is the value you want to change, & symbol is used to separate the different property value settings.

For example:

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

Defines the property value of application root by obtaining the preset or saved parameter(s) from the specified file, the "filename" is the name of the specified file.

For example:

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

The content of "setpro.txt":
EnableSession=true
SessionTimeOut=20
MaximumSessions=100
...

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

Defines the property value of the specified application, "name" is the name of the application, the porperty1~(n) is the name of the property and value1~(n) is the value you want to change, & symbol is used to separate the different property value settings.

For example:

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

Defines the property value of the specified application by obtaining the preset or saved parameter(s) from the specified file, the "name" is the name of the application, the "filename" is the name of the specified file.

For example:

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

The content of "setpro.txt":
EnableSession=true
SessionTimeOut=20
MaximumSessions=100
...

-deleteapp appname="name"

Deletes the specified application, the "name" is the name of the application.

For example:

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

Creates a new application under the current application root, the "name" is the name of the application you want to specify, the "path" is the physical path where the new application maps to.

For example:

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

Lists all properties and their values of the application on the screen if not output to a specified file. If you want to save those properties and their values to a specified file, you should specify the "filename".

For example:

java admin.AppTuner -listrootpro

This command line will list all properties and their values of the application root on the screen.

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

This command line will write all properties and their values of the current application root to the file "apppro.txt".

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

Lists all properties and their values of the specified application on the screen if not output to a specified file, "name" is the name of the application. If you want to save those properties and their values to a specified file, you should specify the "filename".

For example:

java admin.AppTuner -listapppro appname="appsample"

This command line will list all properties and their values of the application "appsample" on the screen.

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

This command line will write all properties and their values of the application "appsample" to the file "appro.txt".

-listallappname [filename="filename"]

Lists the name(s) of all existing application(s) and their corresponding physical paths under the current application root on the screen if not output the result to a specified file If you want to save the result to a specified file, you should specify the "filename".

For example:

java admin.AppTuner -listallappname

This command line will list the names of all existing applications and their corresponding physical paths under the current application root on the screen.

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

This command line will write the names of all existing applications and their corresponding physical paths under the current application root to the file "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-2000, Halcyon Software Inc. All rights reserved.