Communicating in a sysplex environment

The WTO macro allows applications to send messages to consoles within a sysplex, without having to be aware that more than one system is up and running.

You can direct a WTO message to a specific console by specifying the console ID or name when issuing the message. For example, you can use the CONSID or CONSNAME parameter on the WTO macro to direct the WTO message to consoles defined by those parameters. If the console is not active anywhere within the sysplex, the system writes the message to the system log unless it is an important information message, an action message or WTOR message. An important information message is a WTO or WTOR message with descriptor codes 1, 2, 3, 11, or 12. Action messages, messages with descriptor code 12, and WTORs are written to the system log.

You can also broadcast WTOs to all active consoles using MCSFLAG=BRDCST on the WTO macro. Unsolicited messages are directed by routing code, message level, and message type to the appropriate consoles anywhere within the sysplex. There may be some unsolicited messages that will not be queued to any console at a receiving system. In this case, all of the messages are written to the system log.