Disable automatic email notification on download 

When an authenticated user downloads a file for the first time, Files automatically sets a preference so that the user receives emails when that file is edited or commented on. The assumption is that users want to receive emails about updates to the file. You can disable this automatic preference-setting by changing a configuration property in the files-config.xml file.

Before you begin

To edit configuration files, use the IBM WAS wsadmin client. See Starting the wsadmin client for information about how to start the wsadmin command line tool.

About this task

Email notifications can also be enabled or disabled for all applications. See the topic Enable email notifications for information.


  1. Start the wsadmin client.

  2. Access the Files configuration files using the following command:


      If you are asked to select a server, you can select any server.

  3. Check out the Files configuration files using the following command:

      FilesConfigService.checkOutConfig("<working_directory>", "<cell_name>") where:

      • <working_directory> is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.

      • <cell_name> is the name of the WAS cell hosting the IBM Connections application. To obtain the cell name:

          print AdminControl.getCell()

      For example:

      • AIX/Linux:

          FilesConfigService.checkOutConfig("/opt/my_temp_dir", "CommServerNode01Cell")

      • Microsoft™ Windows™:


      Note: To check out email templates with the configuration files you can add the parameter includeEmailTemplates, and set it to "true". For example:

      FilesConfigService.checkOutConfig("/opt/my_temp_dir", "CommServerNode01Cell", includeEmailTemplates = "true")

      You can edit the emails that users receive by editing the templates. For information on email templates, see the topic Customize email templates.

  4. To set the emailNotification.addOnMediaDownload.enabled property to false, use the following command:

      FilesConfigService.updateConfig("emailNotification.addOnMediaDownload.enabled", "false")

  5. You must check the configuration files back in after making changes, and they must be checked in during the same wsadmin session in which they were checked out for the changes to take effect. See the topic Apply Files property changes for details.

      Note: If you checked out the email templates, use FilesConfigService.checkInConfig(includeEmailTemplates = "true") to check them back in as well.

Parent topic

Administer Files

Related tasks

Enable email notifications
Customize Files notification templates
Starting the wsadmin client
Apply Files property changes