&MSGREPL

Replaces the text of a message delivered to MSGPROC.

&MSGREPL [ COLOR=color | COLOUR=colour ]
         [ HLIGHT=highlight | HLITE=highlight ]
         [ INTENS={ HIGH | NORMAL } ]
         [ ALARM={ YES | NO } ]
         [ SCAN={ YES | NO } ]
         [ NRD={ NO | OPER } ]
         [ DATA=replacement text ]

Used within the MSGPROC procedure to request that a message previously delivered for processing by an &MSGREAD be changed to the supplied text and returned for standard delivery.

Operands:

COLOR=color | COLOUR=colour

Specifies that the message color is to change to the selected color. Valid values are:

RED GREEN BLUE TURQUOISE YELLOW PINK WHITE

LIGHT=highlight | HLITE=highlight

Specifies the message highlight option is used. Valid values are:

REVERSE BLINK USCORE NONE

INTENS={ HIGH | NORMAL }

Specifies the message display intensity is used.

ALARM={ YES | NO }

Specifies whether the terminal alarm is sounded when a message is delivered.

SCAN={ YES | NO }

Specifies whether the text contains at sign (@) word highlighting characters for processing.

NRD={ NO | OPER }

If the non-roll delete attribute of the &MSGREAD message must be changed, use this operand to specify the new attribute. The existing NRD attribute of the message is tested by examining the &ZMNRD message profile variable set after executing &MSGREAD. NRD=YES is specified but is ignored; full non-roll delete with DOM correlation can only be set by the message originator, for example, &WRITE.

DATA=replacement text

The full text for the replacement message, including any message numbers required. Text is either upper or lower case.

The maximum length for replacement text is 256 characters.

If no text is supplied the request is treated as an &MSGDEL. DATA can only be specified as the last keyword on the statement since the data string is regarded as being everything right of the DATA= keyword, to the end of the statement.

Examples: &MSGREPL

&MSGREPL HLIGHT=BLINK DATA=NETWORK NODE &7 INACTIVE.

Notes:

If &MSGREPL is issued while no message is being processed, it is ignored.

After issuing &MSGREPL, the message is no longer available in its original format and &MSGCONT need not be issued to return the message for normal processing.

An &MSGREPL is followed immediately by an &MSGREAD to make the next message available.

More information:

&MSGREAD

&MSGDEL

&MSGCONT