Caché ObjectScript Reference - InterSystems Documentation

System and Other FunctionsParametersterminalThe device name of the terminal to which you want to send a message, specified as a quotedstring. Specify the null string ("") to send the message to the system console.messageThe message to send, specified as a quoted string.timeoutOptional (used with named terminal only) — A timeout in seconds. If $ZUTIL(9) is not ableto send the message during the period of the timeout, it ceases attempts to send the messageafter the timeout expires.loglevelOptional (used with operator console only) — The log level you want to assign to the message.You can use the following values:• 0 = Send the message to the following locations: Operator console log file, Caché console.• 1 = Send the message to the following locations: Operator console log file, Caché console,System-wide operator console facility. 1 is the default.ExamplesIn the following example, $ZUTIL(9) sends the message GOOD MORNING on a separateline to the terminal /dev/tty07. ($CHAR(13) is a carriage return, $CHAR(10) is a line feed.)SET X=$ZUTIL(9,"/dev/tty07",$CHAR(13)_$CHAR(10)_"GOOD MORNING"_$CHAR(13)_$CHAR(10))In the following example, $ZUTIL(9) sends the message you specify on a separate line tothe operator console. ($CHAR(13) is a carriage return, $CHAR(10) is a line feed.)READ "Operator message? ",mymess,!SET X=$ZUTIL(9,"",$CHAR(13)_$CHAR(10)_mymess)Notes$ZUTIL(94) complements $ZUTIL(9). $ZUTIL(9) sends a message to a specified devicewhile $ZUTIL(94) sends a message to the principal device of a specified process. Be surethat you use the right function for the right purpose. If you send a process id to $ZUTIL(9)or a terminal device name to $ZUTIL(94), you receive a error.570 Caché ObjectScript Reference