chngserv - Change the Server Deployment Descriptor

chngserv is used to change the deployment descriptor of a server already registered with the ORB.

SYNOPSIS

chngserv [options1] -desc <properties filename>

chngserv [options2] -alias <server alias>

where options1 include:
    -J<runtime flag>       Pass argument to the java interpreter

where options2 include:
    -J<runtime flag>       Pass argument to the java interpreter
    -main <class name>     Name of a class with the main method
    -args <arg list>       Arguments to the server main
    -vmflags <flag list>   Arguments to the server Java VM
    -classpath <path list> Specify where to find server classes
    -logdir <dir>          Specify where to write server logs

DESCRIPTION

The ORB supports automatic server activation for persistent objects via its ActivationSystem API. For convenience several utilities are provided. The chngserv utility is used to change the deployment descriptor of an already registered servers. A server is described by a Server Deployment Descriptor (see ServerDesc), which gives all the information to the ORB to start a Java VM. It includes the name of the main class, arguments to the Java VM, command line arguments to your main, and classpath. The classpath need not contain the JDK or ORB classes. The server deployment descriptor can also contain a directory name where server's System.out and System.err streams are automatically redirected.

OPTIONS

-desc propertiesFile
Specifies the name of the file that contains the server deployment descriptor specified as a properties file.
 
Property Name
Property Description
server.main
 This property specifies a fully qualified name of the class with a public static void main(Sting[]) method. This method is given control by the ORB when the server is activated. [REQUIRED]
server.alias
 This property specifies a user choosen name that is unique within the Activation System. This name can later be used on several activation utilities and as parameter to the ORB. [REQUIRED]
server.classpath
  This property specifies a space separated list of classpath elements that are needed by the server to run. A full classpath is constructed by jorbd by prefixing the path with ORB and JDK classes.
server.args
 This property specifies a space separated list of arguments to be passed on the command line to the server. The main method of the server will get the argument list as parameters when the server starts up.
server.vmflags This property specifies a space separated list of flags to be passed to the Java VM that is started by the server. You can specify flags like -D, -ms, -mx, etc.
server.logdir
 The ORB automatically redirects the System.out and System.err streams of the ORB started servers to files under the db/logs directory. This directory can be over-ridden by specifying a fully qualified path to a directory of your choice. 
-alias serverAlias
Specifies a name that uniquely identifies this server within the ActivationSystem.
-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.
-main mainClass
Specifies a fully qualified class name with a public static void main(String[]) method. This method is given control by the started Java VM when the server is started.
-args arg1 arg2 ... argn
Specifies the arguments to be passed on the command line to the started server. If an argument starts with a dash ('-'), then, use two dashes instead ('--').
-vmflags flag1 flag2 ... flagn
Specifies the flags to be passed to the started Java VM. If an flag starts with a dash ('-'), then, use two dashes instead ('--').
-classpath path1 path2 ... pathn
Specifies the path to the classes that the server depends on. The user specified classpath is appended to the JDK classpath and the ORB classpath to construct the full classpath for the started Java VM.
-logdir directoryName
The ORB automatically redirects the System.out and the System.err streams of started servers to the db/logs directory. The out stream is named <server alias>.out and the err stream is names <server alias>.err. This argument specifies the override for the log directory name.

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
will make the chngserv utility change the deployment descriptor of  server 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, listserv, startserv, stopserv
Copyright © 1998-2003, Novell, Inc. All rights reserved.