Microsoft KB Archive/926092

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

Article ID: 926092

Article Last Modified on 11/8/2006

-

APPLIES TO


 * Microsoft Windows Server 2003 R2 Standard Edition (32-bit x86)
 * Microsoft Windows Server 2003 R2 Enterprise Edition (32-Bit x86)
 * Microsoft Windows Server 2003 R2 Datacenter Edition (32-Bit x86)
 * Microsoft Windows Server 2003 R2 Standard x64 Edition
 * Microsoft Windows Server 2003 R2 Enterprise x64 Edition
 * Microsoft Windows Server 2003 R2 Datacenter x64 Edition

-



INTRODUCTION
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.



MORE INFORMATION
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:   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.   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  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: /Modify-Notification:M,  /Modify-Notification:E, 

The following definitions are for the placeholders that are used in step 3:   is the path that the file screen is applied to.  is the configuration file that you created in step 1 to use for e-mail notifications.  is the configuration file that you created in step 2 to use for event notifications. </li></ol>

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:

926093 File Server Resource Manager (FSRM) limits the number of e-mail messages or events that each file screen can send in Windows Server 2003 R2

<div class="notice_section">

Technical support for x64-based versions of Microsoft Windows
If your hardware came with a Microsoft Windows x64 edition already installed, your hardware manufacturer provides technical support and assistance for the Windows x64 edition. In this case, your hardware manufacturer provides support because a Windows x64 edition was included with your hardware. Your hardware manufacturer might have customized the Windows x64 edition installation by using unique components. Unique components might include specific device drivers or might include optional settings to maximize the performance of the hardware. Microsoft will provide reasonable-effort assistance if you need technical help with a Windows x64 edition. However, you might have to contact your manufacturer directly. Your manufacturer is best qualified to support the software that your manufacturer installed on the hardware. If you purchased a Windows x64 edition such as a Microsoft Windows Server 2003 x64 edition separately, contact Microsoft for technical support.

For product information about Microsoft Windows XP Professional x64 Edition, visit the following Microsoft Web site:

http://www.microsoft.com/windowsxp/64bit/default.mspx

For product information about x64-based versions of Microsoft Windows Server 2003, visit the following Microsoft Web site:

http://www.microsoft.com/windowsserver2003/64bit/x64/default.mspx

<div class="references_section">