How to use File Server Resource Manager (FSRM) to configure the notification feature for File Screening Management in Windows Server 2003 R2

This article discusses the notification feature in Microsoft Windows Server 2003 R2 for File Screening Management that is provided in File Server Resource Manager (FSRM). This feature enables FSRM to send e-mail notifications or to log events in the Application log.

By using File Server Resource Manager (FSRM) in Windows Server 2003 R2, you can create file screens to control the types of files that users can save within a specified path. Additionally, you can configure FSRM to send e-mail notifications and to log events in the Application log when users try to save files of the type that you specify in an active screen or in a passive screen.

For each file screen, FSRM sends only one notification within each notification interval. By default, the notification interval is 60 minutes. You can change this interval by using the Filescrn.exe utility together with configuration files.

Note If you set the notification interval to a period that is too short, FSRM may generate excessive events and e-mail messages. Therefore, you may experience performance reduction.

You can set the RunLimitInterval parameter in text-based configuration files to change the notification interval from the default of 60 minutes. This parameter value is the number of minutes that FSRM will wait until it sends another notification for the same file screen. When this value is set to 0 (zero), FSRM sends notifications every time that a user operation triggers a file screen.

FSRM sends only one notification within each notification interval for a file screen even though the file screen is triggered by different users, or by different file types, or by different file groups. All file screen triggers are ignored other than the first file screen trigger until the interval expires or until the interval is reset. Any of the following operations resets the interval:

• You restart the FSRM service.
• You restart the server that hosts the FSRM service.
• You open and close the properties for the file screen.

Create FSRM configuration files to change notification behavior

To change the notification behavior, create files that have a .txt file name extension to use as configuration files, and then use the filescrn command to apply the configuration files. To do this, follow these steps:

1. For e-mail notification, create a configuration file that has a .txt file name extension, and then include the parameters that you want to change. The following is an example file:

   Notification=M
   RunLimitInterval=10
   To=MailTo@widgets.microsoft.com 
   From=Admin@widgets.microsoft.com 
   ReplyTo=Admin@widgets.microsoft.com 
   CC=MailCC@widgets.microsoft.com 
   BCC=MailBCC@widgets.microsoft.com 
   Subject=This is a mail subject
   Message = This is a mail message body

   Note You do not have to specify all parameters in the configuration file. For example, you can create a file that contains only one parameter, such as the RunLimitInterval parameter, if you want to change nothing but that parameter.
2. For event notification, create a .configuration file that has a .txt file name extension, and then include the parameters that you want to change. The following is an example file:

   Notification=E
   RunLimitInterval=10
   EventType=Information
   Message=Message For Event Log

3. Run the following command at the command prompt to apply the configurations in the files that you created in step 1 and step 2:
   
   Filescrn screen modify /path:<ScreenPath> /Modify-Notification:M,<c:\email.txt> /Modify-Notification:E,<c:\eventlog.txt>
   
   The following definitions are for the placeholders that are used in step 3:
   • <ScreenPath> is the path that the file screen is applied to.
   • <c:\email.txt> is the configuration file that you created in step 1 to use for e-mail notifications.
   • <c:\eventlog.txt> is the configuration file that you created in step 2 to use for event notifications.

For more information about how FSRM limits the number of notifications, click the following article number to view the article in the Microsoft Knowledge Base:

For more information about how to use FSRM and about file screening, visit the following Microsoft Web sites: