Sun Java System Message Queue 4.1 Administration Guide

Service Administrator Utility

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

Table 13–17 Service Administrator Subcommands




Install service 


Remove service 


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 13–18).

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

Table 13–18 Service Administrator Options



-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). ]


imqsvcadmin install -vmargs "-Xms16m -Xmx128m"

-args arg1 [ [arg2] … ]

Additional command line arguments to pass to broker service


imqsvcadmin install -args "-passfile d:\\imqpassfile"

See Broker Utility for information about broker command line arguments.


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