gtpd2m0s | Data Communications Services Reference |
The unsolicited message processor accepts definite commands from a terminal or application program and delivers the attached text to the designated addressee. Since the request is in the form of a command, in the case of a terminal, it would have been entered by a terminal logged in to the System Message Processor (SMP).
This package will validate the entry for syntax and content, then all acceptable messages will be queued to all the specific terminals implied by the addressee (first operand). Terminal(s) will then be notified of the pending unsolicited message and the request for the unsolicited message will be processed; with the delivery of the message the entry will be taken off the queue.
When processing an unsolicited message, a reference item is created and inserted in a directory record (CO1DR). This record is retrieved using the address of the destination terminal to compute the needed ordinal number within the directory's record type. A reference item contains information such as:
Broadcast messages require the creation of reference items for the addressed terminals. Once the unsolicited message directory has been updated, a notification message is sent to the destination terminal to inform the operator of the existence of the unsolicited message. This notification, whose form depends on the terminal characteristics, is immediately sent for all broadcast messages. In order to schedule delivery of these messages, an Unsolicited Notification List (CO3NL) is created containing the addresses of each relevant receiving terminal. This list is processed by a component of the unsolicited message processor.
For single messages, the destination terminal is immediately notified of the existence of an unsolicited message.
After receiving notification of existing unsolicited messages, the terminal operator may either temporarily disregard the notice or immediately request a display of the message by following one of the prescribed procedures.
The appropriate input activates the unsolicited message processor, which retrieves and searches the unsolicited message directory for the proper item based on an originating application and the operator's terminal address. The unsolicited message is formatted appropriately and sent to the requesting terminal via the ROUTC macro, the Output Edit CRT Driver, or the Output Message Transmission Program.
On a time initiated basis, the policing segment of the unsolicited message processor scans the unsolicited message directory (CO1DR) to again advise terminal users of unsolicited messages queued for the terminal. This policing function may also be initiated by a direct request from the terminal user (ZPUMP).
The initialization of the Prime Directory Records (CO1DR) must be accomplished before the unsolicited message processor is used. This entails the formatting of the records in an acceptable manner for subsequent use by the rest of this package.