Configuration Properties

On startup Gems reads display configuration properties from the gems.props file. The list of available properties are shown in the table below:



Property Description
ServerConfigFile Name of the server connections configuration file. Default servers.xml
LookAndFeel Set UIManager Look and Feel class name (default:  javax.swing.plaf.metal.MetalLookAndFeel)
JGoodies L&F library is shipped with Gems in the lib directoy. JGoodies theme may be customized on command line, see rungems.cmd Available JGoodies look and feel classes: com.jgoodies.looks.plastic.Plastic3DLookAndFeel com.jgoodies.looks.plastic.PlasticLookAndFeel com.jgoodies.looks.windows.WindowsLookAndFeel
ViewOnlyMode Allow view operations only, default = true if property removed or no property file specified
AllowMsgReadInViewOnlyMode Allow message read operations, such as browse queue, subscribe to topic and browse durable in view only mode
DisplayRefresh Display auto refresh in seconds (also determines data collection frequency for charting).
Set to 0 to disable (note this will also disable auto-reconnections and charting)
DisplayWidth Main display width
DisplayHeight Main display height
QueueNamePattern Only show queues that match given pattern. The pattern may contain the wildcards "*" and ">"
TopicNamePattern Only show topics that match given pattern. The pattern may contain the wildcards "*" and ">"
UserNameFilter Only show connections, consumers etc for given user name
PermType Only show destinations with permanence type (EMS4.4 or higher); 4=All,3=No Tempories,2=Dynamic,1=Static
HideViews Comma separated list of views to hide (ACLs, Bridges, Channels, Clients, Connections, Consumers, Durables, Factories, Groups, Producers, Queues, Routes, Stores, Topics, Transactions, Transports, Users)
ShowTotals Show Totals on server monitor display
ShowPathInTitleBar Show the selection path in the title bar. Useful if you have many EMS servers to indicate which server is currently selected.
ShowRootInTitleBar When ShowPathInTitleBar is true determines if root node is displayed or not.
ShowExtendedProperties Show extended message properties; JMSExpiration, JMSPriority
ColourPendingMsgs Highlight when there are pending messages for topics, queues and durables
MsgReadDelay Message browser read delay in milliseconds
ViewOldMessagesFirst Message view order
MaxDisplayBytes Maximum display size for bytes messages
ConnectTimeout Sets the TCP connect timeout in milliseconds. If you are connecting to a remote EMS server you may need to increase this.
AdminTimeout Admin command timeout in milliseconds. If you are connecting to a remote EMS server you may need to increase this
AllowStandbyOperations Allow admin operations to standby server.
SSTimeout Sets the SubStation request timeout in milliseconds
UseServerTimestamps Sets default for use of sever timestamps for calculating response time in Request/reply monitor. When false timestamps from original messages are used ie timestamps as set by sending clients. When true timestamps from monitor messages are used ie timestamps set by the EMS server.
DetailPanelColWidths Comma separated list of column widths on details panel (eg: TopicName:200, QueueName:250)
LogDateTimeFormat DateTime format used for timestamp in server info logs (default: EEE MMM dd HH:mm:ss SSS zzz yyyy)
CSVFileDelimiter Delimiter used as separator between values in CSV file output
MaxQueues, MaxTopics Constantly retrieving 1000's of queues/topics can be slow. Test carefully before increasing changing these values. Alternatively use QueueNamePattern/TopicNamePattern to reduce the number of destinations being monitored. Disables the main queues/topics display when the EMS server reports more than this many queues/topics
MaxConsumers, MaxProducers Constantly retrieving 1000's of consumers/producers can be slow. Disables the main consumers/producers display when the EMS server reports more than this many consumers/producers
ServerInfoColPositions Columns positions for server info display (eg AsyncDBSize:5,SyncDBSize:6) Note; columns are moved to the specified position index, when specifying multiple columns previous columns may be moved from positions specified. You cannot move the Alias column.
DisableAutoConnectAfterTimeoutException Use to prevent auto reconnect after admin timeouts due to unresponsive EMS server.
AutoReconnectToPrimary When an FT URL is used and the 1st server in the URL is in standby mode, will attempt to auto reconnect to primary by swapping server names in the FT URL.
MaxMonitorBacklog Automatically stop destination monitors when max message backlog limit is reached.
DestCursorSize Cursor size for getTopics/getQueues queries. Retrieving a large number of Topics/Queues is done with several cursored calls, this defines max count of destinations to return for each call.
AppliancePollPeriod For EMS Appliance monitoring sets the poll period in seconds for monitoring appliance FT state (EMSA V2.0 only)
ApplianceSshTimeout For EMS Appliance monitoring sets the SSH connect timeout in seconds for monitoring appliance FT state (EMSA V2.0 only)
ShowApplFullyOp For EMS Appliance V2.1 and higher shows state as FULLY_OPERATIONAL instead of REPLICATING
AutoConnectOnStart When false delays the auto connect until after the main display is shown
HideTreeDests When true hides queues and topics lists from tree view