3.2 Messenger

This Knowledge Script sends a message to a user currently connected to a Windows Terminal Server (WTS) session.

You can specify the recipients for the message by user name, session name, session ID, or by entering a file name that contains a list of recipients by user name (user names must not include spaces), session name, or session ID.

3.2.1 Resource Object

WTS Server

3.2.2 Default Schedule

The default interval is Run once.

3.2.3 Setting Parameter Values

Set the following parameters as needed:

Description	How to Set It
Recipients (separate with commas)	Specify a list of recipients for the message, separated by commas with no spaces. Type an asterisk () to send a message to all sessions. The default is (all sessions). You can specify WTS sessions by user name, session name, session ID, or file name. Names cannot include spaces. For example: wsmith,jcarter,001003 If you enter a file name that contains a list of recipients, specify a complete path, including the @ symbol. For example: @c:\recipient.txt Notes Ensure that the list of recipients listed in the file are separated by line breaks and not special characters. The recipient text file must contain only the list of recipients currently connected to a Windows terminal server.
Raise event if message fails to send?	Set to y to raise an event if the message is not successfully delivered. The default is y.
Collect data for messages sent?	Set to y to make the script return the number of sessions that received the message. The default is n.
Delay (time to wait for the receiver to acknowledge the message)	Specify the number of seconds to wait for the recipient to acknowledge receiving the message. After the number of seconds has passed, the message automatically closes. The default is 0 seconds, which means that the message is displayed until it the user acknowledges it.
Message	Specify the text of the message you want to send. The default message is work. To avoid an error with your message, if you want to include characters in double quotes in the text of your message (such as "Server"), use two double quote characters before and after the word(s) you want to enclose. For example:" . The length of the text message must not exceed 246 characters.
Event severity when message fails to send	Set the event severity level, from 1 to 40, to indicate the importance of the event raised when the message is not successfully sent. The default severity level is 5.