MQ
11.0 10.3 10.2
MQ
11.0 10.3 10.2
Breadcrumbs

Using the FMQTerminal

The FMQTerminal uses a third-party library Jline http://jline.sourceforge.net/. It is not a pure Java library as it ships with some native code. The FMQTerminal works perfectly on the following platforms:

  • Microsoft Windows

  • RedHat Linux 9.0

  • Debian Linux 3.0

  • Macintosh OS X 10.3

Logging in

  1. Navigate to %FIORANO_HOME%\fmq\terminal\FMQConsole.bat for Windows platform and $FIORANO_HOME/fmq/terminal/FMQConsole.sh for UNIX systems.

  2. This command, without any arguments, connects to the FioranoMQ Server running on localhost. A request for login and password appears. Enter login and password details.

The password’s characters (typed) are not visible on the screen.

worddave7d8462cb33bb08d205cbb2394b96849.png
The FMQTerminal works similar to normal telnet emulators like PuTTYtel and others.

You can choose the specific FioranoMQ Server to connect to by passing the parameter mars to the executable fmq-terminal.bat (fmq-terminal.sh for Unix)

FMQConsole mars

This command searches for mars.properties in the %FIORANO_HOME%\fmq\terminal directory. If no argument is specified, then the default the localhost.properties file in the %FIORANO_HOME%\fmq\terminal directory is used.

localhost.properties is shown below:

jmx.service.url=service:jmx:rmi://localhost/jndi/fmq
java.naming.factory.initial=com.sun.jndi.rmi.registry.RegistryContextFactory 
java.naming.provider.url=rmi://localhost:1858  
java.naming.security.principal=admin  
java.naming.security.credentials=passwd

It is possible to create a properties file for each FioranoMQ Server of interest and use it by passing the file name without the extension as an argument.

worddav4b64b7a2c32e6f097760e3740b510fa1.png

worddav6e5334c554e0a7618a51fa1b8a35082c.png
If multiple servers need to be administered from a single location, the prompt can be customized to identify the Target Server.

FMQConsole localhost Mars

Here, the third argument specifies the prompt name.

Commands List

worddava6ab2717fef971492abba0a8d109211a.png
Type a few characters and press the <tab> key for auto completion.

worddavf7e3dd5a6093d42234ef154af460ed66.png

Help Command to Print Command and their Help

worddav181ee7e747f5c5875972f6f45ed68921.png

Description and Example for Command

worddavca00313859af627d2c6f8c874cfadade.png
The examples above show how arguments can be passed.

Print Usage on Parameter Mismatch

worddav91e855acd1ff8cc8fd9453b5a8c58562.png
 Invalid commands are displayed as 'not recognized':
  worddavb9981f567f59855a6d30da1726449d31.png

Comment Command

All lines starting with # (a Hash or Pound sign) are treated as a comments: they and do not perform any actions.

worddav0d698afc6baabe2b4e1beaf059c2c8ee.png

Run List of Commands from File

If there is a file named mysetup.cmds with the following contents:   

# Some commands on QCF   

createQCF myQCF http://localhost:8090   
deleteQCF myQCF


# Commands continued    

createXAQCF myXAQCF http://localhost:8090
deleteXAQCF myXAQCF    
createQueue myQueue 0

Then, it is possible to run the following commands on this file:

worddav541993187501966a0a7d8740e7043175.png
In the above example, -quiet can be specified as a second argument if commands are not to be echoed.

Adding more Commands to a Terminal

 All available commands can be viewed in the commands.xml file:

%FIORANO_HOME%\fmq\terminal\commands.xml

A snippet of commands.xml is shown below:

  worddav57988468973d8fa175d22062df7c8c86.png

The Mbean operations are found in the eStudio, and they can be added to the commands.xml file. This function ensures that users are not limited to the built-in commands that ship with the installer.

Exiting the Terminal

To exit the FMQTerminal, any of the following commands can be used:

  • exit

  • quit

  • bye

  • Ctrl+D

worddavc720a91241feb93b78f7abb6fe883a48.png
 This returns you to the standard command prompt.