listserv - The Server Listing Utility

listserv is used to list the registered and active servers. It can also be used to list the deployment descriptor of a server.

SYNOPSIS

listserv <option>

where options include:
    -J<runtime flag>  Pass argument to the java interpreter
    -registered       Display servers that are registered
    -active           Display servers that are currently running
    -alias <name>     Display deployment descriptor for this server

DESCRIPTION

The ORB supports automatic server activation for persistent objects via its ActivationSystem API. For convenience several utilities are provided. The listserv utility is used to list the active and registered servers. It can also be used to list a server deployment descriptor.

OPTIONS

-JruntimeFlag
Used to pass runtime flags to the Java interpreter/runtime. For example, in conjunction with the -D option, it sets a Java System property. Muliple -J arguments can be used to specify more than one runtime flags.
-alias serverAlias
Specifies the alias of the server whose deployment descriptor should be listed.
-registered
Specifies that the aliases of all the registered servers should be displayed.
-active
Specifies that only the aliases of the active servers should be displayed.

ENVIRONMENT

If the JBROKER_INITIAL_URL environment variable is set, then its value is used to locate the ActivationSystem. For example on Win32:
set JBROKER_INITIAL_URL=iiopboot://hubble:2506
will make the listserv utility list servers registered with the jorbd running on host hubble instead of the local host.

Note: This can also be achieved by using -J-DORBDefaultInitRef=iiopboot://hubble as one of the parameter to chngserv and is actually preferred to setting an environment property.

EXAMPLES

SEE ALSO

regserv, unregserv, chngserv, startserv, stopserv

Copyright © 1998-2003, Novell, Inc. All rights reserved.