Message identification

You can assign a title to your routed message if you want. 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 might 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 CSPG - page retrieval .)

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 can be up to 62 characters long. For example:

Figure 1. 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)....