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. Table shows the WSCONFIG utility's syntax.
Specifies the name of an existing WebSpeed Transaction Server or Messenger configuration to examine. The name must match the 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 (install-path/properties/ubroker.properties).
-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 in Windows are CGIIP, WSISA, WSNSA, and WSASP. The Messenger names on UNIX are CGIIP and WSNSA.
-validate
Displays command-line help.
-help
Checks the syntax and values of property settings defined in the specified properties file.
Examples
The following table shows several examples that use the WSCONFIG command. Assume the Transaction Server name is wsbroker1.
Table 10. WSCONFIG command examples
Task
Command
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
