Sun Java System Message Queue 4.3 Administration Guide

Service Administrator Utility

The Service Administrator utility (imqsvcadmin) installs a broker as a Windows service. Table 15–17 lists the available subcommands.

Table 15–17 Service Administrator Subcommands


Subcommand	Description
`install`	Install service
`remove`	Remove service
`query`	Display startup options Startup options can include whether the service is started manually or automatically, its location, the location of the Java runtime, and the values of arguments passed to the broker on startup (see Table 15–18).

Table 15–18 lists the options to the imqsvcadmin command.

Table 15–18 Service Administrator Options


Option	Description
`-javahome` `path`	Location of alternative Java runtime Default behavior: Use runtime installed on system or bundled with Message Queue.
`-jrehome` `path`	Location of alternative Java Runtime Environment (JRE)
`-vmargs` `arg1` [ [`arg2`] … ]	Additional arguments to pass to Java Virtual Machine (JVM) running broker service [These arguments can also be specified in the Start Parameters field under the General tab in the service’s Properties window (reached by way of the Services tool in the Windows Administrative Tools control panel). ] Example: `imqsvcadmin install -vmargs "-Xms16m -Xmx128m"`
`-args` `arg1` [ [`arg2`] … ]	Additional command line arguments to pass to broker service Example: `imqsvcadmin install -args "-passfile` `d:\\imqpassfile"` See Broker Utility for information about broker command line arguments.
`-h`	Display usage help [Any other options specified on the command line are ignored. ]

Any information you specify using the -javahome, -vmargs, and -args options is stored in the Windows registry under the keys JREHome, JVMArgs, and ServiceArgs in the path

   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\iMQ_Broker\Parameters