WebSpeed
Installation and
Configuration Guide
WTBMAN Utility
Use the WTBMAN utility to control the operation of a configured WebSpeed Transaction Server. The utility allows you to start a Transaction Server, query its status, start and stop additional WebSpeed Agents, trim by a certain number of agents, and shut down the Transaction Server.
SYNTAX
PARAMETERS
-name
transaction server-nameSpecifies the name of a Transaction Server.
-kill
Stops and removes the NameServer from memory, no matter what it is doing.
-start
Starts the Transaction Server.
-stop
Tells the NameServer to stop itself.
-query
Queries the Transaction Server for its status.
-addagents
number-to-startSpecifies the number of additional agents to start.
-trimagents
number-to-trimSpecifies the number of additional agents to trim.
-host
host-nameSpecifies the name of the machine where the AdminServer is running. If a host name is not specified, it defaults to the local host name.
-user
user-nameSpecifies a user name and prompts for a password when logging into a remote machine. A user name and password are required only when you use the
-host
parameter and specify a remote host name. If you specify a remote host name with the-host
parameter, but do not specify a user name with the-user
parameter, you receive a prompt for a user name and password.
-port
port-numberSpecifies the port number of the machine on which the AdminServer controlling the WebSpeed Transaction Server is running. If a port number is not specified, it defaults to 20931.
-help
Displays command-line help.
EXAMPLES
Table C–5 shows several examples that use the
wtbman
command. Assume that the Transaction Server name iswsbroker1
; the user name istom
; and the AdminServer is on the remote hostfinance
at port9999.
Table C–5: WTBMAN Command Examples Task Commands Start a local Transaction Server. Start a remote Transaction Server.1 Query a local Transaction Server. Query a remote Transaction Server.1 Add agents (for example, 2) to a local Transaction Server. Add agents (for example, 2) to a remote Transaction Server.1 Trim agents (for example, 3) from a local Transaction Server. Trim agents (for example, 3) from a remote Transaction Server.1 Stop a local Transaction Server. Stop a remote Transaction Server.1
NOTE
When you specify a user name with the
-user
parameter, Windows NT supports three different formats:
- A user name as a simple text string, such as “
mary
,” implies a local user whose user account is defined on the local NT server machine, which is the same machine that runs the AdminServer.- A user name as an explicit local user name, in which the user account is defined on the same machine that runs the AdminServer except the user name explicitly references the local machine domain, for example “
.\mary
”.- A user name as a user account on a specific NT domain. The general format is Domain\User, in which the User is a valid user account defined within the domain, and the Domain is any valid NT Server, including the one where the AdminServer is running.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |