Release 10.1A: OpenEdge Getting Started:
Installation and Configuration

> ## ASBMAN

> Starts, stops, adds AppServer agents, trims AppServer agents, and queries the status for an AppServer instance and its AppServer agent.

> Operating system | Syntax
> --- | ---
> UNIX Windows |
>     asbman {
>       { -name AppServer-name
>         { -kill | -start | -stop | -query |
>           -addservers number-to-start |
>           -trimservers number-to-trim }
>         [ -host host-name -user user-name | -user user-name ]
>         [ -port port-number ]
>       } | -help }

> `-name `AppServer-name``

> This parameter is required. It specifies the name of an AppServer.

> `-kill`

> Stops and removes the AppServer from memory, no matter what it is doing.

> `-start`

> Starts an AppServer.

> `-stop`

> Tells the NameServer 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.

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095