Sending Messages with RTmon GDI

To build and send a message to a subject, press the Send button from the Main RTmon window. The Send Message window appears.

	The RTmon GDI has been deprecated and may be removed in a future release.

There are many built-in attributes in the Send Message window. Figure 46 highlights the features built into this window.

Select a message type. The Search box speeds access to the Select Message Type list by scrolling to the place in the Message Type list that corresponds to the characters you type.

When a message type is selected and there is a grammar specified for that message type, it is displayed in the top line of the Message Type Grammar field. Additionally, one or more fields appear in the bottom portion of the window, prompting you for more information. Depending on the message type, the required information may be a simple text entry prompt, an editor of the appropriate type, or a list of legal values. The types of prompts and editors are defined in the table. If desired, set the priority of the message. The default is zero.

Optionally, specify a delivery mode. The options are Best_Effort (the default), Ordered, Some, and All. If Best_Effort is specified, a network failure might cause the message to be lost or delivered out of order. If Ordered is specified, a network failure might cause the message to be lost, but all delivered messages are in the order they were published. This is critical if some of the receiving clients are JMS clients because they cannot handle messages out of order. The modes Some or All trigger GMD messaging, which guarantees delivery to subscribers even during failures in addition to maintaining order during recovery. If Some is selected, it means that the message is guaranteed to be delivered to at least one subscriber. If All is selected, it means that the message is guaranteed to be delivered to all subscribers.

Optionally, set the delivery timeout of the message.

Optionally, specify the load balancing mode to be used to deliver the message. The load balancing options are None (the default), Round_Robin, Weighted, and Sorted.


Prompts	Editors
Simple Entry Prompt	Most of the prompts for fields in the Send Message window are simple entry boxes (INT2, INT4, Identifier, REAL4 and REAL8). Enter the value and press the Return key. The value must be of the type specified in brackets above the box. If it is not, you are notified of an error.
Group Entry Prompt	Groups entry prompts ([Group]) have a slightly different function from Simple entry prompts. This entry prompt accepts an integer that specifies how many entry prompts to provide of the types listed inside the curly braces { 1..3 } in the Message Type Grammar field. When an integer is typed into this box and the Return key is pressed, that number of entry prompts appears below the group entry prompt. See the discussion of groups in the section Grammar.
Message Entry Prompt	Message entry prompts ([Message]) provide a Build Message window. This window is similar to the Send Message window, except that it does not provide as many sending options for the message. A message built with the Build Message window is a message within a message.
String Entry Prompt	String entry prompts ([String]) are similar to the simple entry prompt, with the addition of a More button, invoking a String Editor. The String Editor offers more capabilities than the string entry prompt. In the String Editor, you can: enter new line characters view multiple lines of a string at once scroll through long strings with scroll bars Once a multi-line string has been entered using the String Editor, it is viewable in the string entry prompt by using the arrow keys.
Boolean Entry Prompt	Boolean entry prompts ([BOOL]) allow you to choose among the values Unknown, True, and False.
Array and Binary Entry Prompts (INT2, INT4, STR, REAL4, REAL8)	If an entry prompt shows [INT2_ARRAY], [INT4_ARRAY], [STR_ ARRAY], [REAL4_ARRAY], [REAL8_ARRAY], or [BINARY] as its type, left click on the box labeled <Empty> brings up an Item List Entry editor. This editor allows you to build lists of values of the particular type displayed on the entry prompt you selected: To add a value to the list, left click on the Add button. An empty item box is displayed with the cursor already positioned in it. Enter the value and press the Return key. To delete an item, left click on the Del button to the right of the item you want to delete. For some types of items, an additional button labeled More... is associated with each item in the list. Left click on this button to bring up a String Editor. When the list is complete, left click on the OK button.