<<< Back Home >>>

BKMSG 1R1A -- Send Message To Terminal From Within Breakpoint


BKMSG is a utility processor that can send messages to a user's own terminal while breakpointed to a print file. It can be used to track the progress of a breakpointed runstream.

Call: @BKMSG[,options]
      -- Message line[s] --
      @...

Options:

B - Beep the terminal when sending the message, by inserting an ASCII BEL character (07). This may not work on all terminal types.

D - Date- and time-stamp the message (compare with T).

HELP - Display a brief HELP page for BKMSG.

P - Print the message in the runstream as well as sending it to the terminal. The P option will also force printing of the message in the case where the run is not currently breakpointed or not a demand run, since otherwise it would be ignored.

T - Time-stamp the message (compare with D).

As many images as needed may follow the @BKMSG call, and they will all be sent together. There is an upper limit of about 4095 characters to the message. The message is terminated by an @EOF or any ECL image.

BKMSG uses an ER ERRPR$ with the RSI function to send its message. By default it uses E$ORMSG 02333, which is defined as "^1 complete". To prevent the "complete" from being displayed, BKMSG inserts an ASCII control character following the user's message. By default this character is HT (011); both it and the the default message number are defined as tags at the beginning of the BKMSG source. However, the "complete" may not always be suppressed; adjusting the length of the message may succeed in doing so.

If need be, an alternate message number may be specified in the call, as in '@BKMSG 004567'. This only needs to be done once during a session, since BKMSG will assign a flag file using as a maximum field the message number, converted as though decimal. If desired, the site may define a local E$ORMSG number, such as 0217700E, as simply "^1", a single insert with no other text.

Example:

        @BK1
        @XQT FILE.PROG1
        @BKMSG,TPB
        PROGRAM 1 DONE
        @ASG,A FILE2
        @XQT FILE.PROG2
        @BKMSG,TPB
        PROGRAM 2 DONE
        @BK2,E