Formating Configuration Values for editJTI or -set

The following table indentifies the types of questions supported by the JavaTest harness configuration interview and a description of the format of required to set the value in the command line.

Question Type Description and Example of Format
Integer questions

Example:

set mytck.port 5000

Note: Localized values can be used in the value. For example, 5,000 is acceptable in a US locale.

Floating point questions

Example:

set mytck.delay 5.0

Note: The value is evaluated using the current locale (e.g. European locales should enter 5,0).

String questions

Example:

set mytck.url http://machine/item

String ListQuestion Newline-separated list of values.
File Question

Example:

set mytck.file1 /tmp/bundle.jar

File List Question If none of the filenames have embedded spaces, you can give a space-separated list of filenames. If any of the filenames in the list have embedded spaces, use a newline character to terminate or separate all of the filenames.
StringListQuestion See String ListQuestion above.
Choice Question

Example:

set mytck.cipher 3DES


Note: The value supplied is case sensetive. This type of question appears in the Configuration Editor as a set of radio buttons or single-selection list of choices.

ChoiceArrayQuestion Note: This type of question is rendered in the Configuration Editor as either a list that accepts multiple selections or a series of checkboxes.
InetAddressQuestion The standard textual representation of the IP Address, as defined by Internet Engineering Task Force (IETF).
YesNoQuestion

Examples:

set mytck.needStatus Yes
set mytck.needStatus No


Note: The values are case sensitive, no is not acceptable.

Using Newlines Inside Strings

When setting values of configuration questions in the command line, The internal command parser will accept newlines inside strings if they are preceded by a backslash.

Depending on the shell you use, this may or may not be possible to enter directly on the command line.

If you want to set values with embedded newlines, create a JavaTest harness batch command file, and put the set commands (and any other commands) in that file. In the batch file, you can enter strings with embedded escaped newlines, as in the following example:

# switch on verbose mode for commands
verbose:commands
# open a jti file
open /home/user1/tmp/idemo.11mar04.jti
# set a list of files
set demo.file.simpleFileList /tmp/aaa\
/tmp/bbb\
/tmp/ccc
# set a list of strings
set demo.stringList 111\
2222\
3333

On Solaris, using the Korn shell, you can simply put newline characters into strings and the right thing will happen.

Example:

$JAVA \
-jar image/lib/javatest.jar \
-verbose:commands \
-open /home/user1/tmp/idemo.11mar04.jti \
-set demo.file.simpleFileList /tmp/aaa
/tmp/bbb
/tmp/ccc