| sel-restore | Index Level | set |
| Syntax |
send-message user-id text
send-message * text send-message !port.number text send-message !* text |
| Category | TCL |
| Type | Verb |
| Description |
directs a text message to a specific port, a specific user-id, all current users, or every device attached to the system.
There are 4 valid verbs for sending messages: "send-message", "sm", "message" and "msg". They all behave exactly the same. The "user-id" form sends the message to any port where the given user-id is logged on. The "*" (asterisk) form sends the message to all users currently logged on to the system. The "!port.number" form sends the message to the specified port. The "!*" form sends the message to every terminal (and serial printer!) connected to the system, whether or not the device is logged on. (Even terminals sitting at the LOGON screen will receive a message. The recipient(s) of the message see the time/date, the user-id and port.number of the user who sent the message, and the text of the message. The text need not be enclosed in quotes. If the recipient(s) of the message is in the Update processor or in a menu, they will be prompted to "Press <return> to continue" before the screen is redisplayed. This message times out in 60 seconds. If the recipient(s) of the message is shelled out into Unix, then the message will be written directly to the approprate tty device. The @(x,y) and @(-x) functions may be used within message text. For example: "msg !2 @(-1) @(40,20) This message will clear the screen, then display this message at cursor position 40,20." When using the @ function, the beep and the 5-second delay are disabled on the process receiving the message. To enable these functions, see 'options'. |
| Options |
b force beep on receiving process
d force delay on receiving process |
| See Also | msg sm message |
| Example |
:send-message !0 are you there?
Sends the message to port zero only. :send-message !5 @(-1) @(40,10) Here is some text Sends the message to port 5. The message will first clear the screen, then print "Here is some text" at cursor location (40,10). |
| Warnings | |
| Compatibility | D3 7.1 D3 7.0 |
| sel-restore | Index Level | set |