servertool



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      alternate-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 registered
              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  command,
               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 running,
              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  initializes
              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 appropriately.
              
       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
CLASSPATH
              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)