Host Environment Commands › ADDRESS WTO—Issue WTO Messages

ADDRESS WTO—Issue WTO Messages

The ADDRESS WTO host environment complements the OPSWTO command processor, giving you more flexibility in issuing WTO messages. Using the ADDRESS WTO host environment, you can:

• Issue a WTO message synchronously in AOF rules, causing the WTO to be sent when the rule executes. When you send a WTO message by using the OPSWTO command processor in a rule, the OPSWTO command goes to an OSF server. This can cause a slight delay between the rule executing and the WTO being issued.
• Issue multiline WTO messages. The ADDRESS WTO host environment uses REXX stem variables to store individual lines of the message.

Use one of the following formats for an ADDRESS WTO command:

To issue a single-line WTO message:

ADDRESS WTO "TEXT('messagetext') keywords"
  [AREAID(areaid)]
  [CNNAME(consolenames)]
  [DELAY(delaytime)]
  [DESC(desccode)]
  [HILITE|LOWLITE]
  [MCSFLAGS(flagvalues)]
  [MSGID(messageid)]
  [NOLOG]
  [OPTION(value)]
  [REPLY]
  [ROUTE(routecode)]
  [SUBSYS(ssid)]
  [SYSTEM(ALL|EXT|sysnames)]
  [SYSWAIT(seconds)]
  [TOKEN(dom token)]
  [WAIT(waittime)]
  [WTOID[(wtoid)]]

To issue a multiline WTO message:

ADDRESS WTO "TEXTVAR(stem-name) keywords"
  [AREAID(areaid)]
  [CNNAME(consolenames)]
  [DELAY(delaytime)]
  [DESC(desccode)]
  [HILITE|LOWLITE]
  [LINETYPE(linetype)]
  [MCSFLAGS(flagvalues)]
  [MSGID(messageid)]
  [NOLOG]
  [OPTION(value)]
  [ROUTE(routecode)]
  [SUBSYS(ssid)]
  [SYSTEM(ALL|EXT|sysnames)]
  [SYSWAIT(seconds)]
  [TOKEN(dom token)]
  [WTOID[(wtoid)]]

Note: Specifying a wtoid value for the WTOID keyword is optional.