How to use the Pager samples applications

To run the Pager samples, use the supplied graphical applications to receive messages. The following sections describe how to use each of the graphical applications:

• Text Messenger application
• Surf Report Publisher application
• Pager application

Text Messenger application

Use the Text Messenger application to send messages to the Pager application. The Text Messenger application communicates indirectly with the Pager application by putting messages on WebSphere MQ queues. If you close the Pager application and continue sending messages to it, the messages are held on the queues until you start the Pager application again. When you start the Pager application again, it receives the queued messages. This example demonstrates asynchronous messaging.

To send a message to the Pager application:

1. In the message input box, type your message text.
2. Click Send to send the message.

To clear the message input box without sending a message and without closing the Text Messenger application, click Clear.

To close the Text Messenger application without sending any messages, click Cancel.

Surf Report Publisher application

Use the Surf Report Publisher to manage your subscriptions to surf reports that you can receive on the Pager application. The Surf Report Publisher application communicates indirectly with the Pager application by publishing messages to WebSphere MQ queues. If you close the Pager application and the Surf Report Publisher continues publishing messages to which the Pager application is subscribed, the messages are held on the queues until you start the Pager application again. When you start the Pager application again, it receives the queued messages to which it is subscribed. This example demonstrates asynchronous messaging.

However, if you close the Surf Report Publisher application, your subscriptions are deleted and no new surf reports are sent to the Pager application.

The surf report publisher application consists of two windows:

• the Surf Report Publisher window
• the Surf Report Subscriptions window

To subscribe to surf reports:

1. In the Surf Report Publisher window, click Start to start publishing reports.
2. Click Subscriptions. The Surf Report Subscriptions window opens.

   

3. Click a surf location, use the < and > buttons to add and remove locations to your list of subscribed beaches. Clicking >> adds all the locations to your list, and clicking << removes all locations from your list.
4. Click OK to apply your changes and return to the Surf Report Publisher window, or Cancel to return to the Surf Report Publisher without applying your changes.

To stop publishing messages, return to the Surf Report Publisher window and click Stop. To clear the screen, click Clear.

To close the Surf Report Publisher application, close the Surf Report Publisher window. All your subscriptions are deleted when you close the Surf Report Publisher window.

Pager application

The Pager application can receive messages from both the Text Messenger application and the Surf Report Publisher application. The Pager application does not communicate directly with the other applications but indirectly by receiving messages that the other applications put on WebSphere MQ queues. So that you can close the Pager application, send messages to it from one of the other applications, and then start the Pager application again. While the Pager application is not running, the messages are held on the queues; when you start the Pager application again, it receives the queued messages. This example demonstrates asynchronous messaging.

However, if you close the Surf Report Publisher application, your subscriptions are deleted and no new surf reports are sent to the Pager application.

Pager application controls

The following diagram shows the controls of the Pager application.

The display of the Pager application consists of the Status area (at the top) and the Display area (below the Status area). The Display area can show either message text, a list of your messages, or the menu. The Status area has four labels:

• The first label, on the extreme left, indicates whether the Pager is connected.
• The second label displays a status message. For example, it can indicate how many messages you have on your Pager, and how many of these messages are new.
• The third label is displayed when you have unread messages.
• The fourth label, on the extreme right, is displayed if scrolling is possible. An arrow pointing up indicates that you can scroll up, and an arrow pointing down indicates that you can scroll down.

The pager has four buttons that are used to control the application:

• Use the View button, at the bottom of the Pager, to return to the previous display. When the display area is displaying a list of your messages, clicking the View takes you to the menu.
• Use the Select button, at the bottom of the Pager, to confirm the selections you make.
• Use the up and down scroll buttons to scroll down the list of messages, message text, or menu options.

Viewing messages

To view your messages:

1. Click the Select button to turn the pager on. The pager now displays any messages that you have.
2. Use the scroll buttons to highlight a message, click the Select button to view it. If the message text is too long to fit into the Display area, use the scroll buttons to view the rest of the message.
3. To view another message, click the View button to return to the list of messages. Use the scroll buttons to highlight another message, click the Select button to view the message.

Using the menu

To access the menu, click the View button. If you are viewing message text, you must click the View button twice: to return to the list of messages, and then to access the menu.

Use the scroll buttons to highlight an option, click the Select button to select it. The following list gives details of the different menu options:

Alert

Cycles through different alert options. The options are:

• Sound and vibrate
• Sound only
• Vibrate only
• None

Delete all messages

This option deletes all messages from the Pager.

Standby

This option puts the Pager into standby mode.

To leave the menu, click the View button.

Back to running the Pager samples