Starting the administration tool

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


The interactive mode provides a command prompt where we 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 Configure 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 Configure 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 Use administration commands. The last command in the file must be the END command.

Parent topic: Configure JMS objects using the administration tool