CLI Reference > Server Administration Commands > im setnotification
 
im setnotification
sets e-mail notification for a user or group
Synopsis
im setnotification [--email=value] [--notificationRule=value] [--notificationRuleFile=value] [(-Ffile|--selectionFile=file)] [--quiet] [--user=name] [--hostname=server] [--password=password] [--port=number] [(-?|--usage)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [-g|--gui] [--settingsUI=[gui|default]] [--status=[none|gui|default]]
Description
im setnotification sets e-mail notification for a user or group. For users, you can also use the im createuser and im edituser commands to set e-mail notification. For groups, you can also use the im creategroup and im editgroup commands to set e-mail notification.
* 
You must have the following permissions assigned to you: allow ViewMyNotification to view e-mail notification settings, and allow ModifyMyNotification to create and edit notification rules.
To specify a date and time for a date field, use the MM/dd/yyyy h:mm:ss [AM|PM] format. You can specify a time only if the date field is configured to display the time. To specify the current date for a date field, type today. This option can be specified for a date field or a date field configured to display the date and time. To specify the current date and time for a date field, type now. This option can be specified only if the date field is configured to display the date and time. To specify an empty value for the date field, type none.
When specifying a user, you can specify the user's name or "me". "me" is a symbolic user which refers to the user that the notification rule is created for. This is useful if you want to create a common notification rule and share it with other users.
Configuration management project fields cannot be used in e-mail notification rules.
E-mail notification is subject to project, type, and field visibility rules. Only users that have visibility for a given project and type receive e-mail notification for issues related to that project and type. In addition, e-mail notifications include only the fields they have permission to view.
E-mail notifications are evaluated on the Integrity Lifecycle Manager Server ’s time zone; however, symbolic dates in rules are evaluated on the Integrity Lifecycle Manager Client’s time zone.
Configuration management project and attachment fields cannot be specified.
Options
This command takes the universal options available to all im commands, as well as some general options. See the options reference page for descriptions.
--email=value
specifies the e-mail address for the user or group. To specify multiple e-mail addresses, separate them with semi-colons (;).
--notificationRule=rule
specifies the notification rule for this principal. For the rule syntax, see Specifying Rules on the options reference page.
--notificationRuleFile=filename
specifies the file that contains the rules to read. For the file content format, see Specifying Rules on the options reference page.
See Also
Commands: im createuser, im edituser, im creategroup, im editgroup
Miscellaneous: options