This parameter is optional. It specifies the name of an AppServer.
-all
This parameter is optional. This parameter informs the utility to apply the request to all AppServer entries in ubroker.properties. Using this parameter in combination with the -stop parameter, you can stop all the AppServers running at a particular time.
-kill
Stops and removes the AppServer from memory, no matter what it is doing.
-start
Starts an AppServer.
-stop
Tells the AppServer to stop itself.
Note: The AppServer stops only after completing any active client requests.
-query
Queries an AppServer for its status.
-addservers number-to-start
Specifies the number of additional servers to start.
-trimservers number-to-trim
Specifies the number of additional servers 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. 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 username and password.
Windows supports three different formats for user-name:
A user name as a simple text string, such as "mary", implies a local user whose user account is defined on the local Windows 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 Windows 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 Windows Server, including the one where the AdminServer is running.
-port port-number
Specifies the port number of the machine on which the AdminServer is running. If a port number is not specified, it defaults to 20931.
-help
Displays command-line help.
-agentdetail
Displays the procedure run by an AppServer agent. You can select the specific AppServer agent by specifying the process ID (PID) of an agent process.
-agentkill
Stops a specific AppServer agent forcefully. The PID specified to the asbman command must be an agent process for the specified AppServer. Use the kill command to stop a specific AppServer agent on UNIX. Use the taskkill command to stop a specific AppServer agent on Windows XP Professional Edition. This utility is not supported by the Windows Home Edition.
-agentstop
Stops an AppServer agent gracefully.
Example
Use the following command to display the .r procedure run by an AppServer agent. It displays the port and connection state of an AppServer agent:
asbman -name <name> -agentdetail <pid>
Example
Use the following command to stop an AppServer agent forcefully:
asbman -name <name> -agentkill <pid>
Example
Use the following command to stop an AppServer agent gracefully:
A user name as a simple text string, such as "mary", implies a local user whose user account is defined on the local Windows server machine, which is the same machine that runs the AdminServer.