Previous Topic: VARTABLE UPDATE Command—Update a Vartable Entry

Next Topic: Tivoli NetView Emulation


WRITE

The WRITE command lets you issue messages to various destinations. The command has more flexibility than the standard REXX SAY statement.

This command has the following format:

WRITE 
   [LOG={NO|YES}]
   [TERM={NO|YES}]
   [MON={NO|YES}]
   [{COLOR|COLOUR}=color]
   [{HLIGHT|HLITE}=hlight] 
   [ALARM={NO|YES}]
   [INTENS={LOW|HIGH}]
    DATA="wtext"

DATA must be the last parameter in the command.

LOG={NO | YES}

Specifies whether to write the message to the activity log.

Default: NO

TERM={NO | YES}

Specifies whether to write the message to the owning execution environment.

Default: YES

MON={NO | YES}

Specifies whether to write the message to all OCS users and dependent environments profiled to receive Monitor class messages.

Default: YES

{COLOR | COLOUR}={BLUE | GREEN | PINK | RED | TURQUOISE | WHITE | YELLOW | NONE}

Specifies the color of the message.

{HLIGHT | HLITE}={BLINK | REVERSE | USCORE | NONE}

Specifies the extended highlighting of the message.

ALARM={NO | YES}

Specifies whether to ring the terminal alarm when displayed on an OCS window.

Default: NO

INTENS={NORMAL | HIGH}

Specifies whether to display the message in high or normal intensity.

Default: NORMAL

DATA="wtext"

Specifies the text to display on the terminal.

Example: WRITE

ADDRESS 'NM'
'WRITE LOG=YES DATA="a message from REXX to the log"'
'WRITE LOG=YES TERM=YES COLOR=RED DATA="Hello World from NM rexx!"'
'WRITE LOG=NO TERM=YES COLOR=GREEN HLITE=REVERSE INTENS=HIGH',
'DATA="This should be green, intensive and reverse!"'
attr=' COLOR=PINK HLITE=REVERSE'
line=" DATA='This should be pink, intensive and reverse!'"
'WRITE LOG=NO TERM=YES'attr||line
allarg=' COLOR=GREEN DATA="This should be just green"'
WRITE allarg