servertool(1) servertool(1)
NAME
servertool - Java IDL Server Tool
SYNOPSIS
servertool [ options]
DESCRIPTION
The Java(tm) IDL Server Tool, servertool, provides the ease-of-use
interface for the application programmers to register, unregister,
startup, and shutdown a server. In addition to these four commands,
other commands are provided to obtain various statistical information
about the server.
When the server tool starts, enter one of the options at the servertool
>> prompt.
OPTIONS
The following options are supported:
register -server server-class-name -applicationName alter-
nate-server-name -classpath classpath-to-server -args args-to-server
-vmargs flags-to-be-passed-to-Java-VM
Registers a new server with the Object Request Broker Daemon
(ORBD). If the server is not already registered, it is regis-
tered and activated.
unregister [ -serverid server-ID -applicationName name ]
Unregisters a server from the ORBD.
getserverid -applicationName name
Returns the server id from the ORBD that is associated with a
server.
list Lists all information about all servers registered with the
Object Request Broker Daemon (ORBD). In response to this com-
mand, the server id, server name, and the corresponding server
application name for each server in the ORBD is retrieved and
displayed to the user.
listappnames
Lists the application names for all servers currently registered
with the ORBD.
listactive
Lists all information about all currently active servers on a
machine. The active servers have been launched by the ORBD and
are currently running. In response to this command, the server
id, server name, and the corresponding server application name
for each active server is retrieved and displayed to the user.
locate [ -serverid server-id -applicationName name ] [ -endpointType
endpointType ]
Locates the endpoints (ports) of a specific type for all ORBs
created by a registered server. If a server is not already run-
ning, it is activated. If an endpoint type is not specified,
then the plain/non-protected endpoint associated with each ORB
in a server is returned.
locateperorb [ -serverid server-id -applicationName name ] [ -orbid
ORB-name ]
Locates all the endpoints (ports) registered by a specific ORB
of registered server. If a server is not already running, then
it is activated. If an orbid is not specified, the default value
of "" is assigned to the orbid. If any ORBs are created with an
orbid of empty string, all ports registered by it are returned.
orblist [ -serverid server-id -applicationName name ]
Lists the integer mapping for the ORBIds. An ORBId is the string
name for the ORB created by the server. When a server initial-
izes an ORB with a particular ORBId, an integer mapping for that
particular ORBId is obtained. This integer mapping is put into
the object key to help in locating the correct ORB in the server
during requests on the Object Request Broker Daemon (ORBD). If
the server is not already running, it is activated.
shutdown [ -serverid server-id -applicationName name ]
Shuts down a registered, active server. During execution of this
command, the shutdown() method defined in the server application
program is also invoked to shutdown the server process appropri-
ately.
startup [ -serverid server-id -applicationName name ]
Starts up or activates a registered server. If the server is not
running, this command launches the server. If the server is
already running, an error message is returned to the user.
help Lists all the commands available to the server through the
server tool.
quit Exits the server tool.
ENVIRONMENT VARIABLES
CLASPATH
Used to provide the system with a path to user-defined classes.
Directories are separated by colons. For example:
.::/Users/vlh/classes::/Library/Java/Home/Extensions
SEE ALSO
orbd(1)
See (or search java.sun.com) for the following:
Setting the Classpath @
http:/java.sun.com/j2se/1.4/docs/tooldocs/solaris/classpath.html
23 Apr 2001 servertool(1)
|
