Chapter 8: Using wstool, wstkeytool, wstant, and wstkeytoolant

wstool and wstkeytool syntax

The syntax for wstool and wstkeytool is:

wstool or wstkeytool [connection-arguments] [command]

Where:

connection-arguments specify optional parameters required to connect to the server, including:

Flag	To specify
`-h` or `-host`	Server host name; default is the value of JAGUAR_HOST_NAME (localhost)
`-n` or `-port`	Web services host port number; default is 8080
`-u` or `-user`	User name; default is “jagadmin”
`-p` or `-password`	Password; default is “” (no password)
`-k` or `-protocol`	Communication protocol; default is “http”
`-l` or `-logfile`	Log file name; default is “System.out”
`-r` or `-pin` (wstkeytool only)	Keystore PIN of EAServer’s PKCS#11 token; default is “sybase”
`-s` or `-provider` (wstkeytool only)	The keytool provider. This option is not used with EAServer.

command is a wstool or wstkeytool command.

For example, to connect to the server running on “paloma” at HTTP port “9005”, using account “jagadmin” with password “secret” enter:

wstool -h paloma -n 9005 -p secret or wstkeytool -h paloma -n 9005 -p secret

You can omit the -u flag because jagadmin is the default user name.

wstool and wstkeytool command options are not case sensitive.

Return codes

wstool and wstkeytool commands return the following codes:

0 – if the command runs successfully, and the result is true/success

1 – if the command runs successfully, and the result is false/failure

2 – if an exception is thrown during the running of the command

Help

You can display usage for any wstool or wstkeytool command by using the help option. For example to display all of the wstool or wstkeytool commands, enter:

wstool help or wstkeytool help

You can also display individual command help. For example, to display options and valid usage for the wstool delete command, enter:

wstool help delete

To display options and valid usage for the wstkeytool deleteCert command, enter:

wstkeytool help deleteCert

Verbose

All wstool and wstkeytool commands include the verbose option, which displays stack trace information, if any is generated, when you run the command. The default value is false. For example, to display stack trace information for the wstool delete command, enter:

wstool delete -verbose true Service:CollectionName/WebServiceName

View this book as PDF