Syntax Exceptions to the EMS Administration Tool

Experienced EMS Administration Tool (tibemsadmin) users will notice that most MSGMX EMS commands tend to generally follow the EMS Administration Tool structure with some exceptions to work within the MSGMX grammar and syntax. These exceptions are detailed below.

  • Use a space instead of an equal (=) sign in MSGMX EMS commands. A command containing an equal sign is invalid. Examples:

    • EMS Administration Tool command example:

      addprop topic topic1 maxmsgs=5
    • MSGMX EMS command example using a space rather than an equal sign:

      addprop topic topic1 max_messages 5
  • Use a space instead of a comma to separate properties in MSGMX EMS commands. MSGMX EMS property names and values are paired and a new property name can be typed after the previous property's value separated by a space. A comma is not a valid property separator in MXGMX syntax. Examples:

    • EMS Administration Tool command example:

      addprop topic mytopic import="FTL01", export="FTL02", maxbytes=1MB
    • MSGMX EMS command example, which omits commas:

      addprop topic mytopic import_transports FTL01 export_transports FTL02 max_bytes 1MB
    • In MSGMX EMS commands, commas are only used to separate a list of values assigned to a single property, rather than separating one property from another. The value is a single string and no spaces are inserted before or after the comma.

      In the following command, the import values to receive messages from two external systems are separated by a comma.

      addprop topic topic2 import_transports t3,t5 export_transports t3 max_bytes 1MB

  • To enter string values that contain space characters, you can use straight single quotes or double quotes. Examples:

    • EMS Administration Tool requires the string literal to be enclosed in single quotes not double quotes:

      add member 'agrawal a'
    • MSGMX EMS commands allows the literal string to be enclosed in double quotes or single quotes:

      add member "agrawal a"

      or

      add member 'agrawal a'
    • MSGMX EMS commands allow the string enclosed in double quotes where the string includes straight single quotes or vice versa:

      create durable topic3 dName3 selector "urgency in ('high','medium')"

      or

      create store '{"South":"Venue"}'