Pathway/XM System Management Manual

Managing Clients and Requesters
Compaq NonStop™ Pathway/XM System Management Manual—426761-001
8-12
Sending Messages to Terminal Users
If you include the FREQTABLE option, the STATS TERM command generates a
frequency distribution table that contains statistics for the specified TERM object (or
objects):
>> STATS TERM TFRONT1, FREQTABLE
For the syntax of the STATS TERM command, refer to STATS TERM on page 11-71.
Sending Messages to Terminal Users
You can send messages to application terminal users using the TELL TERM command.
These messages can contain any kind of information, ranging from informative text to
urgent requests.
You can direct these messages to selected users (addressing their terminals by TERM
object name), or to all users accessing your application. Devices represented by both
configured TERM objects and temporary TERM objects can receive these messages.
For example, the following command sends a message about an orientation meeting to a
new user sitting at the device configured through TERM-06:
>> TELL TERM TERM-06, "New Employee Orientation at 1:00 p.m."
The next command sends a message about a planned computer system upgrade to all
users of terminals in group ABC:
>> TELL TERM GROUP ABC, "Two New CPUs to be Added Tonight!"
In response to the TELL command, the Pathway/XM environment assigns your message
a unique identifying number and queues the message for delivery.
Your message does not interrupt the receiving user’s normal operation at the input-
output device or process; it is not displayed until the user completes interaction with the
current screen. Furthermore, this message can only be displayed if the message display
capability is enabled in the screen program run for the device or process.
The associated PATHMON process automatically deletes a message when all
destination TERM objects acknowledge its receipt.
You can display the message number and text of all pending messages by entering:
>> INFO TELL *
The TELL message number assigned by the Pathway/XM environment enables you to
refer to the message in specific commands. You will need to use this number, for
instance, to delete TELL message text through PXMCOM. You can delete any
individual pending message by using the DELETE TELL command followed by the
message number, for example:
>> DELETE TELL 26
The DELETE TELL command cancels delivery of a pending message. You cannot,
however, issue a global DELETE TELL command that removes all pending messages.