Try OpenEdge Now
skip to main content
Installation and Configuration
Command and Utility Reference : Administering and configuring Unified Broker products : WTBMAN
 

WTBMAN

Controls the operation of a configured WebSpeed Transaction Server. The utility allows you to start one or more than one Transaction Servers, query their status, start and stop additional WebSpeed Agents, trim by a certain number of agents, and shut down the Transaction Server (WebSpeed only).
Operating system
Syntax
UNIX
Windows
wtbman {
{ -name transaction-server-name
{ -kill | -start | -stop | -query
| -addagents number-to-start
| -trimagents number-to-trim }
[ -host host-name -user user-name| -user user-name]
[ -port port-number]
}| -help }
-name transaction-server-name
Specifies the name of one or more than one Transaction Servers, you want to modify. You can specify multiple servers by separating them with a colon (:).
-kill
Stops and removes the Transaction Server from memory, no matter what it is doing.
-start
Starts the Transaction Server.
-stop
Stops the Transaction Server.
-query
Queries the Transaction Server for its status.
-addagents number-to-start
Specifies the number of additional agents to start.
-trimagents number-to-trim
Specifies the number of additional agents to trim.
-host host-name
Specifies 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-name
Specifies a user name and prompts for a password when logging in to 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-number
Specifies 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
-agentdetail
Displays the procedure run by a WebSpeed agent. You can select the specific WebSpeed agent by specifying the process ID (PID) of an agent process.

Example

Use the following command to display the .r procedure run by the WebSpeed agent. It displays the port and connection state of a WebSpeed agent:
wtbman -name <name> -agentdetail <pid>
-agentkill
Stops a specific WebSpeed agent forcefully. The PID specified to the wtbman command must be an agent process for the specified WebSpeed. Use the kill command to stop a specific WebSpeed agent on UNIX. Use the taskkill command to stop a specific WebSpeed agent on Windows XP Professional Edition. This utility is not supported by the Windows Home Edition.
wtbman -name <name> -agentdetail <pid>

Example

Use the following command to stop a WebSpeed agent forcefully:
wtbman -name <name> -agentkill <pid>

Example

Use the following command that stops the WebSpeed servers, a, b, and c, leaving the remaining servers unaffected:
wtbman -name a:b:c -stop