Starting the administration tool

The administration tool has a command-line interface that you can use either interactively, or to start a batch process.

About this task

The interactive mode provides a command prompt where you can enter administration commands. In the batch mode, the command to start the tool includes the name of a file that contains an administration command script.

Procedure

Interactive mode

To start the tool in interactive mode, enter the following command:
```
JMSAdmin [-t] [-v] [-cfg config_filename]
```
where:

-t

Enables trace (default is trace off)

The trace file is generated in "%MQ_JAVA_DATA_PATH%"\errors ( Windows ) or /var/mqm/trace ( UNIX ). The name of the trace file is of the form:
mqjms_ PID.trc

where PID is the process ID of the JVM.

-v

Produces verbose output (default is terse output)

-cfg config_filename

Names an alternative configuration file. If this parameter is omitted, the default configuration file, JMSAdmin.config, is used. For more information about the configuration file, see Configuring the JMS administration tool.
A command prompt is displayed, which indicates that the tool is ready to accept administration commands. This prompt initially appears as:
```
InitCtx>
```
indicating that the current context (that is, the JNDI context to which all naming and directory operations currently refer) is the initial context defined in the PROVIDER_URL configuration parameter. For more information about this parameter, see Configuring the JMS administration tool.
As you traverse the directory namespace, the prompt changes to reflect this, so that the prompt always displays the current context.

Batch mode

To start the tool in batch mode, enter the following command:
```
JMSAdmin <test.scp
```
where test.scp is a script file that contains administration commands. For more information, see Using administration commands. The last command in the file must be the END command.