WebSpeed
Installation and
Configuration Guide


WSCONFIG Utility

Use the WSCONFIG utility to help validate existing WebSpeed Transaction Server or WebSpeed Messenger configurations defined in a properties file, such as the ubroker.properties file. This utility displays the property settings associated with a WebSpeed Transaction Server or Messenger configuration, and checks that the syntax and values are valid.

The WSCONFIG utility runs locally, on the machine where the WebSpeed components that you want to check are running. Because the utility does not run across the network and no AdminServer is installed during a Messenger-only install, you cannot use the WSCONFIG utility to check a Messenger-only install. The WSCONFIG utility uses the following syntax:

SYNTAX

Operating System

Syntax
UNIX
Windows
wsconfig
  [
      [
         [ -name component-name ]
         [ -propfile path-to-properties-file ]
         [ -messenger ]
         [ -validate ]
      ]
    | -help
  ] 

PARAMETERS
-name component-name

Specifies the name of an existing WebSpeed Transaction Server or Messenger configuration to examine. The name must match a name of an existing WebSpeed Transaction Server configuration defined in the specified properties file. Although you must specify a Transaction Server, you need not specify a Messenger. If you do not specify any name, the WSCONFIG utility analyzes all the WebSpeed Transaction Server and Messenger configurations defined in the properties file specified by the -propfile parameter.

-propfile path-to-properties-file

Specifies a filename or pathname to a file that contains the property settings to be validated, for example test.properties. If a filename or pathname is not specified, it defaults to the installation version of the ubroker.properties file, such as:

-messenger

Displays one or all of the Messengers for you to view. If -name refers to a Messenger and the -messenger parameter is used, then information appears for that one Messenger. If -name does not refer to a Messenger and the -messenger parameter is used, then information appears for all the Messengers.

The Messenger names on Windows NT are CGIIP, WSISA, WSNSA, and WSASP. The Messenger names on UNIX are CGIIP and WSNSA.

-validate

Checks the syntax and values of property settings defined in the specified properties file.

-help

Displays command-line help.

EXAMPLES

Table C–4 shows several examples that use the WSCONFIG command. Assume the Transaction Server name is wsbroker1.

Table C–4: WSCONFIG Command Examples 
Task
Commands
View a Transaction Server configuration.
wsconfig -name wsbroker1  
View a messenger configuration.
wsconfig -name CGIIP -messenger 
View all messenger configurations.
wsconfig -messenger 
Validate the syntax and view the configuration of all messengers defined within a different property file.
wsconfig -propfile 
g:\other.properties -validate 


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095