Recoverable messages

Between creation and delivery of a routed message with a disposition of PAGING, BMS stores the message in CICS® temporary storage, just as it does in the case of an ordinary PAGING message. Consequently, you can make your routed messages recoverable by your choice of the REQID option value, just as in the case of a nonrouted message. (See Logical message recovery.)

If you are routing to more than one type of terminal, BMS builds a separate logical message for each type, with the appropriate device-dependent data stream, and uses a separate temporary storage queue for each type.

Note:
For terminal destinations that have the alternate screen size feature, where two message formats are possible, BMS chooses the default size if the profile under which the task creating the message specifies default size, and alternate size if the profile specifies alternate size.

All of the logical messages use the same REQID value, however, so that you can still choose whether they are recoverable or not.

BMS also uses temporary storage to store the list of terminals eligible to receive your message and to keep track of whether delivery has occurred. When all of the eligible terminals of a particular type have received a message, BMS deletes the associated logical message. When all of the destinations have received delivery, or the purge delay expires, BMS erases all of the information for the message, reporting the number of undeliverable messages by destination to the master terminal operator message queue.

Message identification

You can assign a title to your routed message if you wish. The title is not part of the message itself, but is included with the other information that BMS maintains about your message in CICS temporary storage. Titles are helpful in situations where a number of messages may accumulate for an operator or a terminal, because they allow the operator to control the order in which they are displayed. (See the "query" option of the CSPG command in the CICS Supplied Transactions manual.)

To assign a title, use the TITLE option of the ROUTE command to point to a data area that consists of the title preceded by a halfword binary length field. The length includes the 2-byte length field and has a maximum of 64, so the title itself may be up to 62 characters long. For example:

Figure 115. Assigning a title
       01  MSG-TITLE.
           02  TITLE-LENGTH    PIC S9(4) COMP VALUE +19.
           02  TITLE-TEXT      PIC X(17) VALUE 'MONTHLY INVENTORY'.
       ...
       EXEC CICS ROUTE TITLE(MSG-TITLE)....
[[ Contents Previous Page | Next Page Index ]]