Try OpenEdge Now
skip to main content
Administration
Command and Utility Reference : WSCONFIG
 

WSCONFIG

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. (WebSpeed only).

Syntax

Operating system
Syntax
UNIX
Windows
wsconfig [
[[ -name component-name]
[ -propfile path-to-properties-file]
[ -messenger ]
[ -validate ]
]| -help ]
-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 (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
Checks the syntax and values of property settings defined in the specified properties file.
-help
Displays command-line help.

Example

The following table shows several examples that use the WSCONFIG command. Assume the Transaction Server name is wsbroker1.
Table 107. 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.
wsconfig -propfile g:\other.properties
-validate