Alerts and Monitoring

Topics | How To | Example | Support | Related Topics

Overview

Available Alerts and Alert Descriptions

Alert Administration

Notification Types

Alert Tokens

Overview

Alerts can inform you of conditions occurring within a CommCell that you may have otherwise not been aware of. These conditions can range from minor occurrences that do not require intervention to severe occurrences that need immediate intervention. The system detects conditions within two minutes of the occurrence.

Alerts can be configured globally or they can be job-based. Alerts that are configured globally are done so through the CommCell Console Control Panel and can be configured for all existing operations, where Job-Based alerts give users the ability to configure an alert while submitting an immediate job, scheduled job, configuring a schedule policy, or for a running job.

Alerts can be sent to their intended recipients by e-mail/pager, to a Windows System Event Viewer, by SNMP Trap(s), or by running a command script. If the mail server is down, the system will attempt to send alert e-mail notification for the next four hours. If after four hours, the mail server is still down, these alerts will be removed from the system, and will not be sent to the recipient. Additionally, individual alert notifications can now be generated when users select the Send Individual Notification for This Alert option while configuring alerts rather than multiple alerts being generated within a single alert notification.

You can also obtain information about conditions within the CommCell from the Event Viewer or Log Files.

The Microsoft Operations Manager (MOM) 2005, NetIQ and SNMP Trap Receiver applications can be used to monitor Alerts.

Users can opt to escalate some alert notifications, by selecting the desired options in the Escalation Notification section of the alert configuration, if available.

Alert Locale

By default, alert notification messages are sent in the same language as the CommCell Console used to configure the alerts. However, they can be displayed in a language other than that of the CommCell Console. You can change the locale while configuring the alert, see:

  • An alert can be configured to send e-mail notifications to user groups created from within the CommCell Console as well as external domain user groups. However, individual external domain users will not receive the alert notification e-mail if they have not previously logged on to the CommCell Console. Users (from the user groups created from within the CommCell Console) will receive the alert e-mail notification regardless of their login status.

  • Disabled users and/or user groups cannot create or receive scheduled reports or alerts.
  • Instance-level alerts for Oracle rman_util restore jobs do not work.

Available Alerts and Alert Descriptions

The alerts available are grouped into six categories:

The following tables identify the types of available alerts within each category, the user capabilities needed for each alert, the entities the alert can be associated with, the types of criteria available, and a description.

Application Management

Alert Type User Capabilities Needed for Each Alert type Entities that can be Associated with the Alert Criteria Description
ContinuousDataReplicator Agent Management or Alert Management capability with association at the object associated with the alert. Clients

Client Groups

 Log File Volume Reached Low Watermark One of the following has occurred:
  • A destination computer has imposed throttling on the source computer, based on the percentage of allocated log space remaining on the destination computer.
  • A destination computer has stopped the source computer from sending logs, based on the percentage of allocated log space remaining on the destination computer.
  • A source computer has run out of log space, and CDR has stopped monitoring the source paths for all the Replication Pairs, put the pairs in an aborted state, and deleted all log files.

The free disk space thresholds are configurable in the ContinuousDataReplicator Properties (Operational Parameters) window.
No transfer activity There has been no data replicated from the source to the destination. The CommServe automatically checks for transfer activity every 15 minutes.
Failed Replication A Replication Pair's job has failed, been aborted by a user, or aborted by the system.
Exchange Agent Management or Alert Management capability with association at the object associated with the alert. Clients

Client Groups

 Journal Mailbox Threshold Exceeded The journal mailbox exceeded its limit. (The mailbox threshold is set by the user in the CommCell console.)

NOTES

  • See Configure the Agent for a Journal Mailbox Threshold Alert in Books Online for step-by-step instructions for setting the threshold limit on the agent.
  • If you would like to change the interval at which the threshold limit is checked or the time-out for the monitoring process, you can set these through the nArcMonitorIntervalInMins and nArcMonitorTimeOutInMins registry keys.
SharePoint Agent Management or Alert Management capability with association at the object associated with the alert. Clients

Client Groups

 New Virtual Servers Were Found. Restart IIS Services. New virtual servers were found on the SharePoint server after an archive operation, which requires the Internet Information Services (IIS) to be restarted.
SharePoint version is upgraded. Restart IIS. The SharePoint server has been upgraded, which requires the Internet Information Services (IIS) to be restarted. 

Automatic Updates

Alert Type User Capabilities Needed for Each Alert type Entities that can be Associated with the Alert Criteria Description
Download Updates Administrative Management or Alert Management capability with CommCell association. Job Failed Updates failed to be downloaded.
Job Succeeded Updates were downloaded successfully.
Job Succeeded with Errors A download updates operation completed with errors.
Install Updates Administrative Management or Alert Management capability with CommCell association. Machines

Client Groups

 		 Job Failed An update installation failed.
Job Succeeded An update installation completed successfully.
Job Succeeded with Errors An update installation operation completed with errors.
Job Initiated An update installation was initiated.
Updates Available to Download Administrative Management or Alert Management capability with CommCell association. Updates Available to Download An update is available to be downloaded for installation.

The frequency interval at which these updates are detected is configurable in the registry key.
Upgrades and Service Packs Administrative Management or Alert Management capability with CommCell association. Machines

Client Groups

 		 Release Upgrade Required A new release software upgrade is required.

(If configured, this alert occurs when a Client and/or MediaAgent software version is lower than that of the CommServe.)

The frequency interval at which these updates are detected is configurable in the registry key.
Service Pack Required A software update is required.

(If configured, this alert occurs when a Client and/or MediaAgent service pack version is lower than that of the CommServe.)

The frequency interval at which these updates are detected is configurable in the registry key.

Configuration

Alert Type User Capabilities Needed for Each Alert type Entities that can be Associated with the Alert Criteria Description
Clients Agent Management or Alert Management capability with association at the object associated with the alert. Clients

Client Groups

 Properties Modified The properties of a client were modified, or there was an unauthorized attempt to alter properties.
Disk Space Low The minimum thresholds have been reached for the client software installation and system directories, which include the Job Results.

The threshold for Job Results directory is configurable in the CommCell Console's Client Computers Properties window.

The thresholds for the software installation and system directories and the frequency interval at which the directories are monitored are configurable in the registry key.

If Data Classification Enabler is installed, this alert, if configured, will be sent if 85 percent or more of the volume's disk space is consumed.

For computers where QSnap and either the Quick Recovery Agent or ContinuousDataReplicator are installed, this alert, if configured, will be sent if 80 percent or more of a volume's disk space is consumed, for all of the client computer's volumes.

If Content Indexing Engine is installed, this alert, if configured will be sent for the following:

  • If 80 percent or more of the volume's disk space is consumed.
  • If the minimum free space falls below 10 GB.
Agents Properties Modified The properties of an agent were modified, new content was added (for the Oracle agent only), or there was an unauthorized attempt to alter properties. This alert is also generated if the content, pre-post commands, or storage policy of a subclient were modified.
CommCell Administrative Management or Alert Management capability with CommCell association   Alert every n failed login attempts There were n failed attempts made to login to the CommCell.
Alert CommServe License Expires With n Days The CommServe license will expire in n days.
Alert when License Consumed reaches n % The CommServe license has reached n %.

License Capacity Usage details get updated every 24 hours. It may also be updated if a Data Aging Job is run or if CommServe services are restarted.
Properties Modified The properties of the CommServe were modified, or there was an unauthorized attempt to alter properties.
Alert Modified A user was added or removed to an alert, an alert was modified, or there was an unauthorized attempt to modify the properties of an alert.
Force De-configured A user failed or successfully forced de-configured an Agent, Client, or MediaAgent.
Disk Space Low The minimum thresholds have been reached for the CommServe software installation and system directories or there is insufficient disk space for the CommServe database to grow.

The threshold for the software installation and system directories and the frequency interval at which the directories are monitored are configurable in the registry key.

The threshold for CommServe database directory, and the frequency interval at which the database directory is monitored, are configurable in the CommCell Console's Control Panel - System window (Database space check interval and Database Space Check Thresholds).
Library Library Management or Alert Management capability with library association Libraries Properties Modified The properties of a library were modified, an overwrite media option was selected for the library, or there was an unauthorized attempt to alter properties of a library.
MediaAgents Media Management or Alert Management capability with MediaAgent association MediaAgents Properties Modified The properties of a MediaAgent were modified, or there was an unauthorized attempt to alter the properties of a MediaAgent.
Disk Space Low The minimum thresholds have been reached for the MediaAgent software installation and system directories, which include the Index Cache.

The threshold for MediaAgents Index Cache directory is configurable in the CommCell Console's MediaAgents Properties window.

The threshold for the software installation and system directories and the frequency interval at which the directories are monitored are configurable in the registry key.

DDB Store got corrupted Deduplication Store of a MediaAgent is corrupted.
MediaAgent went Offline A MediaAgent was switched on/offline.
Notify only if Condition persists for Notify only if the condition persists for certain length of time.
Repeat notification every Repeat the notification for every n hours and m minutes.

(n and m are set by the user at the time of configuration.)
Schedules Alert Management capability with CommCell association   Scheduler Changes A schedule was added, deleted, or modified, a job failed to be scheduled, a user added, removed, or modified a holiday.
Storage Policy Storage Policy Management or Alert Management capability with storage policy association Storage Policies Properties Modified The properties of a storage policy were modified, or there was an unauthorized attempt to alter the properties of a storage policy.

Job Management

Alert Type User Capabilities Needed for Each Alert type Entities that can be Associated with the Alert Criteria Description
Auxiliary Copy Administrative Management or Alert Management capability with CommCell association Storage Policies

Storage Policy Copies

 Job Succeeded An auxiliary copy operation completed successfully.
Job Succeeded with Errors An auxiliary copy operation completed with errors.
Job Skipped A scheduled auxiliary copy operation ran late, was skipped, or was skipped due to a holiday.
Job Failed An auxiliary copy operation failed, failed to start, or the operation was aborted by the system.
Job Activity An auxiliary copy operation was killed, resumed, or suspended by a user.
Auxiliary Copy fallen behind alert The following criteria have been met for the selected storage policy:
  • data to be copied is more than n GB
  • jobs have not been copied in more than n days

(n is set by the user in the Storage Policy Properties (Advanced) window.)

The interval at which the storage policy is checked for this criteria can be configured in the Media Management Configuration (Auxiliary Copy Configuration) window; the default Interval (Hours) between Auxiliary Copy Fallen Behind alerts is 24 hours.
Delayed by n Hrs An auxiliary copy operation was in a waiting state for n hours. (n is set by the user at time of configuration.)
Alert every n attempt (Phase failures) There were n attempts made to resume the auxiliary copy operation after a phase failure.
Alert every n attempt (Network failures) There were n attempts made to resume the auxiliary copy operation after a network failure.
Backup Copy Workflow Administrative Management or Alert Management capability with CommCell association Storage Policies
Job Succeeded A backup copy operation completed successfully
Job Succeeded with Errors A backup copy operation completed with errors.
Job Skipped A scheduled backup copy operation ran late, was skipped, or was skipped due to a holiday.
Job Failed A backup copy operation failed, failed to start, or the operation was aborted by the system.
Job Activity A backup copy operation was killed, resumed, or suspended by a user.
Job Started A backup copy operation was started by a user.
Continuous Data Replication Data Protection Operations or Alert Management capability at each associated entity. Clients

Agents

Replication Sets

 Job Succeeded A Recovery Point creation, Consistent Recovery Point creation, or CopyBack operation completed successfully.
Job Succeeded with Errors A Recovery Point creation, Consistent Recovery Point creation, or CopyBack operation completed with errors.
Job Skipped A scheduled Recovery Point creation, Consistent Recovery Point creation, or CopyBack operation ran late, was skipped, or was skipped due to a holiday.
Job Failed A Recovery Point creation, Consistent Recovery Point creation, or CopyBack operation failed, failed to start, or the operation was aborted by the system.
Job Activity A Recovery Point creation, Consistent Recovery Point creation, or CopyBack operation was killed, resumed, or suspended by a user.
Delayed by n Hrs A Recovery Point creation, Consistent Recovery Point creation, or CopyBack operation was in a waiting state for n hours. (n is set by the user at time of configuration.)
Alert every n attempt (Phase failures) There were n attempts made to resume the Recovery Point Creation or CopyBack operation after a phase failure.
Alert every n attempt (Network failures) There were n attempts made to resume the Recovery Point Creation or CopyBack operation after a network failure.
Data Aging Administrative Management or Alert Management capability with CommCell association Job Succeeded A data aging operation completed successfully.
Job Succeeded with Errors A data aging operation completed with errors.
Job Skipped A scheduled data aging operation ran late, was skipped, or was skipped due to a holiday.
Job Failed A data aging operation failed, failed to start, or the operation was aborted by the system.
Job Activity A data aging operation was killed by a user.
Data Classification Alert Management capability Clients

Client Groups

 Classification Failed A data classification operation failed to write to the database.
Data Protection Data Protection Operations or Alert Management capability at each associated entity. Clients

Client Groups

Agents

Backup Sets

Instance/Partition

All Subclients**

Subclients

 Job Succeeded A data protection operation completed successfully.
Job Succeeded with Errors A data protection operation completed with errors.
Job Skipped A scheduled data protection operation ran late, was skipped, or was skipped due to a holiday.
Job Failed A data protection operation failed, failed to start, or was aborted by the system.
Job Activity A data protection operation was killed, resumed, or suspended by a user.
No Data Protection A data protection operation failed to start.
Delayed by n Hrs A data protection operation was in a waiting state for n hours. (n is set by the user at time of configuration.)
No Backup for last n Days A data protection operation did not complete successfully for the last n days. (n is set by the user at the time of configuration in the alert wizard.)
Job exceeded running time of n Hrs A data protection operation was in a suspended, running or in a pending state for more than n hours.
(n is set by the user at the time of configuration in the alert wizard.)
Alert every n attempt (Phase failures) There were n attempts made to resume the data protection operation after a phase failure.
Alert every n attempt (Network failures) There were n attempts made to resume the data protection operation after a network failure.
Increase in Data Size by n% A data protection job is at least n% larger in data size than the previous data protection job of the same type (full, incremental, differential or synthetic full). Default is set at 10%.  (n is the percentage of increase in data size, at which if met, will trigger the alert. The actual data size increase may be larger than the n%.)
Decrease in Data Size by n% A data protection job is at least n% smaller in data size than the previous data protection job of the same type (full, incremental, differential or synthetic full). Default is set at 10%. (n is the percentage of decrease in data size, at which if met, will trigger the alert. The actual data size decrease may be larger than the n%.)
Notify only when jobs qualify for extension retention The data protection job is set for extended retention.

 
Notify only when job contains failed objects The data protection job contains one or more failed objects.
Data Recovery Browse and In Place Recover or Browse and Out of Place Recover or Alert Management capability at each associated entity. Clients

Client Groups

Agents

Backup Sets

Instance/Partition

 Job Succeeded A data recovery operation completed successfully.
Job Succeeded with Errors A data recovery operation completed with errors.
Job Skipped A scheduled data recovery operation ran late, was skipped, or was skipped due to a holiday.
Job Failed A data recovery operation failed, failed to start, or the operation was aborted by the system.
Job Activity A data recovery operation was killed, resumed, or suspended by a user.
Job Started A data recovery operation was started by a user.
List Media A user requested a list of media used for the original data protection operation.
Data Verification Administrative Management or Alert Management capability Storage Policies

Storage Policy Copies

 Job Succeeded A data verification operation completed successfully.
Job Succeeded with Errors A data verification operation completed with errors.
Job Skipped A scheduled data verification operation ran late, was skipped, or was skipped due to a holiday.
Job Failed A data verification operation failed, failed to start, or the operation was aborted by the system.
Job Activity A data verification operation was killed, resumed, or suspended by a user.
Delayed by n Hrs A data verification operation was in a waiting state for n hours. (n is set by the user at time of configuration.)
Disaster Recovery Backup Administration Management or Alert Management capability with CommCell association. Job Succeeded A disaster recovery backup completed successfully, a backup set was pruned during the operation (default = 5 backup sets).
Job Succeeded with Errors A disaster recovery backup operation completed with errors/warnings.
Job Skipped A scheduled disaster recovery backup ran late, was skipped, or was skipped due to a holiday.
Job Failed A disaster recovery backup failed, failed to start, the operation was aborted by the system, or no storage policy was defined for the operation.
Job Activity A disaster recovery backup operation was killed by a user.
Delayed by n Hrs A disaster recovery backup operation was in a waiting state for n hours. (n is set by the user at time of configuration.)
Erase Data Administration Management or Alert Management capability with CommCell association. Clients

Agents

Backup Set

Subclients

 Job Succeeded An erase data operation completed successfully..
Job Succeeded with Errors An erase data operation completed with errors/warnings.
Job Skipped A scheduled erase data operation ran late, was skipped, or was skipped due to a holiday.
Job Failed An erase data operation failed, failed to start, was killed by a user, was aborted by the system.
Job Activity An erase data operation was killed, resumed, or suspended by a user.
Media Erase Library Management or Alert Management capability with library association Libraries Job Succeeded A media erase operation completed successfully.
Job Succeeded with Errors A media erase operation completed with errors/warnings.
Job Failed A media erase operation failed, failed to start, or was killed by a user.
Job Activity A media erase operation was killed, resumed, or suspended by a user.
Media Inventory Library Management or Alert Management capability with library association Libraries Job Succeeded An inventory operation completed successfully.
Job Succeeded with Errors An inventory operation completed with errors.
Job Failed An inventory operation failed, failed to start, or was killed by a user.
Media Refreshing Administrative Management or Alert Management capability with CommCell association Storage Policies

Storage Policy Copies

 Alert every n attempt (Phase failures) There were n attempts made to resume the data protection operation after a phase failure.
Alert every n attempt (Network failures) There were n attempts made to resume the data protection operation after a network failure.
Delayed by n Hrs An offline content indexing operation was in a waiting state for n hours. (n is set by the user at time of configuration.)
Job Succeeded An offline content indexing operation completed successfully.
Job Succeeded with Errors An offline content indexing operation completed with errors.
Job Skipped An offline content indexing operation ran late, was skipped, or was skipped due to a holiday.
Job Failed An offline content indexing operation failed, failed to start, the operation was aborted by the system.
Job Activity An offline content indexing operation was killed by a user.
Offline Content Indexing Administrative Management or Alert Management capability with CommCell association Storage Policies

Storage Policy Copies

 

 Job Succeeded An offline content indexing operation completed successfully.
Job Succeeded with Errors An offline content indexing operation completed with errors.
Job Skipped An offline content indexing operation ran late, was skipped, or was skipped due to a holiday.
Job Failed An offline content indexing operation failed, failed to start, the operation was aborted by the system.
Job Activity An offline content indexing operation was killed by a user.
Delayed by n Hrs An offline content indexing operation was in a waiting state for n hours. (n is set by the user at time of configuration.)
Information Management Administrative Management or Alert Management capability with CommCell association   Job Succeeded An information management operation completed successfully.
Job Skipped An information management operation ran late, was skipped, or was skipped due to a holiday.
Job Succeeded with Errors An information management operation completed with errors.
Job Failed An information management operation failed, failed to start, the operation was aborted by the system.
Job Activity An information management operation was killed by a user.
Delayed by n Hrs An information management operation was in a waiting state for n hours. (n is set by the user at time of configuration.)
Report Administration Management capability with CommCell association.   Job Activity A report operation was killed by a user.
Job Failed A report operation failed, failed to start, the operation was aborted by the system, or a report failed to be saved.
Job Skipped A report operation ran late, was skipped, or was skipped due to a holiday.
Job Succeeded A report operation completed successfully.
Job Succeeded with Errors A report operation completed with errors.
SRM Data Collection Administration Management capability with CommCell association. Clients

Client Groups

 Alert every n attempt (Phase failures) There were n attempts made to resume the data collection operation after a phase failure.
Alert every n attempt (Network failures) There were n attempts made to resume the data collection operation after a network failure.
Job Activity A data collection operation was killed by a user.
Job Failed A data collection operation failed, failed to start, the operation was aborted by the system.
Job Skipped A data collection operation ran late, was skipped, or was skipped due to a holiday.
Job Succeeded A data collection operation completed successfully.
Job Succeeded with Errors A data collection operation completed with errors.
No Data Protection A data collection operation failed to start.

 

**DataArchiver agents only

Media Management

Alert Type User Capabilities Needed for Each Alert type Entities that can be Associated with the Alert Criteria Description
Device Status Library Management or Alert Management capability with CommCell association Libraries Drive went Offline A drive in a library switched offline.
Library went Offline A library switched offline.
Mount Path went Offline A mount path went offline.
Library Management Library Management or Alert Management capability with library association. Libraries Insufficient Storage The number of spare media inside the library for a scratch pool and cleaning pool fell below the low water mark defined or there is no spare media inside the library. For a disk library, the free disk space fell below the low water mark or there is insufficient disk space.
Maintenance Occurred A drive cleaning operation completed successfully or failed.
Maintenance Required The library or drive has exceeded its threshold, a drive requires cleaning, or the mount path has exceeded its fragmentation threshold.

 

The percentage threshold at which the mount path is deemed fragmented can be configured in the Media Management Configuration (Service Configuration) window, Mount Path Fragmentation Threshold Percentage option.
Media Handling Errors The system found a duplicate barcode/label in the library, or the system detected a media in the wrong library.
Media Handling Required A media is not in the library, or a media in a drive needs changing because the system detected wrong or no media in the drive.
Media Mount and Usage Errors A media is marked read only, bad or depreciated, or a mount or an unmount error has occurred.
User Overwrite of Media The media was overwritten due to an option selected by the user.
Media Ready in Mail Slot Media in mail slot is ready to be picked up by the user.

NOTES

  • This criterion is applicable to a VaultTracker media export (to mail slot) only, which requires a VaultTracker license. For more information, see License Administration in Books Online.
  • It is recommended that the <MEDIA LIST> and <MORE MEDIA Y/N> tokens be added to the notification message when configuring this alert. For more information, see Alert Tokens in Books Online.
Media Recalled The media has been retrieved from an export location for a specific operation. For more information, see Recall Media in Books Online.
VaultTracker Library Management or Alert Management capability with Library association. Tracking Policies Job Succeeded A pending media movement completed successfully.
Job Succeeded with Errors A pending media movement completed with errors.
Job Failed A pending media movement failed.
Job Initiated A pending media movement was created.
Media Handling Required A media is moved to a virtual mail slot, or a media needs import.
Media Picked Up Media was picked up.
Media Reached Destination A media has reached the required destination.
Media Returned to Source A media was returned to the source.
Rolled Back A media movement was rolled back.

Alert Administration

Modify Alerts

The options of a configured alert can be modified from the Alerts dialog box.

Delete Alerts

An alert can be deleted from the Alerts dialog box.

Disabled/Enabled

An alert can be disabled/enabled from the Alerts dialog box.

View Configured Alerts

The Alerts dialog box displays the configured alert, the alert category and alert type, and the CommCell user that created the alert. The Alert Summary provides the alert options in more detail.

Test Alerts

An alert can be tested to verify the e-mail server is configured correctly so that all intended recipients of the alert are receiving the notification messages. For more information, see Test a Configured Alert.

The TestSendMail utility in the Resource Pack can also be used from the command line to test the mail connection for sending alerts.

Reports

The CommCell Configuration report provides the option to include information on configured alerts. See CommCell Configuration Report for an overview.

Notification Types

Alerts can be sent to the intended recipients by the following means:

E-mail/Pager

Alerts can be sent in the form of an e-mail to selected recipients, providing the recipient has a valid SMTP mail server, a valid e-mail/pager address, and is enabled as a valid CommCell user. E-mail/pager messages can be customized by adding tokens to the body of the e-mail. An e-mail notification can contain up to 100 alerts.

Before sending an email, you must set-up the email server within the CommCell Console.  See E-Mail Server Configuration for more information.

SNMP Traps

Alerts can be sent by a CommServe, using the SNMP protocol, to other computers in the form of SNMP traps, provided that the SNMP Enabler software is installed on the CommServe computer and SNMP was selected as the alert notification type. See SNMP Enablers for more information.

System Event Viewer

Alerts can be sent to the Windows System Event Viewer on the CommServe. Event Viewer alert notifications can be customized by adding alert token arguments to the alert configuration. The tokens will be included in the body of the alert notification message.

Run Command

Alerts can be sent by configuring a Run Command.

The Run Command can be located on the CommServe or remote machines, but is executed only on the CommServe machine. The command can be configured with arguments; multiple arguments should be separated by spaces, which the system allows.

Save to Disk

Alert notification messages can be sent in the form of a text file to a designated directory either locally or on a network share. This is useful when it is necessary to quickly obtain a listing of the failed items in an operation.

RSS Feeds

Alert notification messages can be sent in the form of an RSS feed, which can be automatically integrated with your Web Browser.

Alert Tokens

An alert token is a parameter that can be added to an alert configuration so that when initiated the desired status information will be appended to the alert notification message. Each alert notification has a different set of tokens available for configuration depending on the criteria selected for the alert. See Default Alert Notification Messages and Tokens for more information.

The following table describes all the alert tokens:

Token Description
<AGENT TYPE NAME> The name of the agent.
<ALERT CATEGORY - ALERT TYPE> The alert category and type.
<ALERT NAME> The alert display name.
<ALL CLIENT LIST> A list of all the clients for which updates are selected to be installed.
<BACKUPSET NAME> The name of the backup set.
<CLIENT LIST> The name of the clients included in the operation.
<CLIENT NAME> The name of the client.
<CLIENT RELEASE LIST> A list of client names and releases.
<CLIENT STATUS LIST> A list of client names and the status of the update installation operation on each client.
<COMMCELL NAME> The name of the CommCell.
<COMMENT> Information regarding the detected condition.
<CONDITION CLEARED Y/N> Informs a user if the detected condition has cleared.
<CONTENTS> The list of updates available for download.
<CONTENTS DOWNLOADED> The list of updates downloaded.
<COPIED DATA SIZE> The size of data that was copied.
<COPIED MEDIA LIST> The list of media that was copied.
<COPY NAME> The copy name.
<CS UPGR TIME> The last time the CommServe was upgraded.
<CURRENT BACKUP SIZE> The current size of the backup data.
<DATE OF LAST SUCCESSFUL JOB> The last date at which a job completed successfully.
<DESCRIPTION> Information regarding the condition detected.
<DESTINATION LOCATION> Media destination location.
<DETECTED CRITERIA> Alert criteria that was detected.
<DISK SPACE INFO> Disk space information: volume name, volume size, free space.
<DISK SPACE LOW Y/N> Informs user if the disk space for the software installation directory, CommCell database, Quick Recovery Agent, QSnap, or ContinuousDataReplicator is low.
<DOWNLOAD SIZE (MB)> The size of the files that have been downloaded.
<DRIVE NAME> The name of the drive.
<DRIVEPOOL NAME> The name of the drive pool.
<ELAPSED TIME> The amount of time used for the operation.
<END TIME> The time the operation ended.
<ERR CODE> The error code for the job pending or job failure reason.
<EXPORT LOCATION> The name of the media export location.
<ENTENDED RET.CANDIDATE Y/N> Indicates whether the job qualifies for extended retention.
<FAILED ATTEMPT TIME LIST> The time at which failed login occurred.
<FAILED ATTEMPTS COUNT> The number of failed login attempts.
<FAILED CLIENT LIST> A list of clients that failed to install updates.
<FAILED COUNT> The number of failed objects.
<FAILED OBJECTS> A list of failed objects in an attachment.
<FAILURE REASON> A reason why there was a failure.
<FILES DOWNLOADED> A list of the downloaded files.
<FORCE DECONFIG Y/N> Informs a user if a CommCell object was de-configured.
<FREE SPACE> Free space on related volume.
<GUI CLIENT NAME> Name of the client displayed in the user interface.
<INITIATER> VaultTracker policy name that initiated the VaultTracker action.
<INSTANCE NAME> The name of the instance.
<JOB ID> The Job ID assigned by the Job Manager for the job.
<JOBS RUNNING CLIENT LIST> A list of client names that have jobs running at the time of update installation.
<JOBS TOBE COPIED> The number of jobs to be copied.
<LEVEL> The backup level.
Note that for a File Archiver iDataAgent the status of the Index will be displayed for this token.
<LIBRARY NAME> The name of the library.
<LICENSE EXPIRED> The name of the license that will expire.
<LOW CACHE CLIENT LIST> A list of client names that have low cache at the time of update installation.
<MAILBOX NAME> The name of the mailbox.
<MESSAGE COUNT> The number of messages in the mailbox.
<MEDIA LABEL> The label/barcode of the media.
<MEDIA FAILED> The media that failed to be erased.
<MEDIA LIST> A list of media used during the operation.
<MEDIA LOCATION LIST> A list of media and their locations.
<MEDIA REQUIRE LIST> The media required for a data recovery operation.
<MEDIA SPACE LEFT> For disk media, the space remaining on a disk. For tape media, the remaining spare media in a scratch pool.
<MEDIA SUCCEEDED> The media that was successfully erased.
<MEDIA TOBE COPIED COUNT> The number of media to be copied.
<MEDIAAGENT NAME> The name of the MediaAgent.
<MORE MEDIA Y/N> A yes/no token, which specifies whether more media is to be exported.
<MOUNTPATH NAME> The name of the mount path.
<NO. OF DAYS LEFT FOR LICENSE EXPIRY> The number of days remaining until license expires.
<NO SUCCESSFUL JOB SINCE> The number of days since a data protection operation did not complete successfully.
<NUMBER OF ITEMS> The number of items restored/recovered during the operation.
<OLDEST JOB ENDDATE> The end date of the oldest job to be copied.
<OPERATION TYPE> The name of the operation.
<OTHER LIBRARY> The library to which the media belongs.
<OWNER EMAIL> The email address of the user who created the alert.
<OWNER NAME> The user who created the alert.
<PERCENTAGE CHANGE> The percentage change of data size from previous job to current job.
<PREVIOUS JOB ID> The previous job identification number.
<PREVIOUS BACKUP SIZE> The previous backup job data size.
<PROPERTY MODIFIED Y/N> A yes/no token, which specifies whether a property has been modified.
<PROTECTED COUNT> The number of protected objects.
<PROTECTED OBJECTS> A list of protected objects and file sizes in an attachment. File sizes are displayed in bytes.
<PRUNED JOB COUNT> The number of jobs that have aged.
<PRUNED MEDIA BARCODE LIST> The barcode list of aged media.
<RETAIN UNTIL> The predicted ending retention date of the job.
<RD JOB Y/N> A yes/no token, which specifies whether a job was initiated to a Recovery Director iDataAgent.
<RECOVERED COUNT> The number of objects recovered.
<RECOVERED OBJECTS> A list of recovered objects in an attachment.
<REPSET NAME> The name of the replication set.
<RESOURCE WAIT TIME> Time elapsed while a job is waiting for a resource.
<RESTORE USER NAME> The user that initiated the restore operation from the Search Console.
<SCHEDULE NAME> The name of the schedule.
<SCHEDULE TIME> The time the operation was scheduled.
<SERVER RELEASE> CommCell release number.
<SIZE> The size of the files restored during the operation.
<SIZE OF DATA TOBE COPIED> The size of the data to be copied.
<SKIPPED COUNT> The number of objects that were skipped during a data recovery operation.
<SKIPPED OBJECTS> A list of skipped objects in an attachment.
<SNAPSHOT VOLUME UNIT> The name of the snapshot volume unit.
<SOURCE LOCATION> The name of the source location.
<SP LIST> A list of the storage policies used in the operation.
<SP NAME> The name of the storage policy.
<SPAREPOOL/MOUNTPATH NAME> The spare media pool or mount path name.
<START TIME> The time the operation started.
<STATUS> The status of the operation.
<STORAGE POLICIES USED> The name of the storage policies associated with the data protection operation.
<SUBCLIENT NAME> The name of the subclient.
<SUBJECT BEGIN> The beginning of the notification.
<SUBJECT END> The end of the notification.
<SUCCESSFUL CLIENT LIST> A list of clients that were updated successfully.
<THRESHOLD> The threshold value for the library, drive and media.
<TIME> The time (as per the time zone of the CommServe) the condition was detected.
<TIME OF LAST SUCCESSFUL JOB> The last time at which a job completed successfully.
<TRANSIT LOCATION> The name of the transient location.
<UNKNOWN CLIENT LIST> A list of clients whose status was unable to be determined after the installation of updates.
<UNREACHABLE CLIENT LIST> A list of clients that are unreachable.
<UP-TO-DATE CLIENT LIST> A list of clients that already have all of the updates required.
<USER NAME> The CommCell user that initiated the operation.
<USER NAME LIST> A list of user names entered for the failed login attempts.
<UTC_TIME> The time the condition was detected as displayed in UTC time.
<VOLUME NAME> The name of the volume.
<WORKFLOW> The name of the Recovery Director workflow.
<XFER BYTES> Data transferred in bytes.
<XFER GB PER HOUR> Data transferred in gigabytes per hour.
<XFER SECS> Number of seconds for the data transfer to occur.
<XFER SIZE> Amount of data transferred automatically displayed in the size unit respective of the size amount. Refer to the following:
If amount of data transferred is equal to: Then, amount will be automatically displayed as:
Less than 1 MB Bytes
Greater than 1 MB, Less than 1 GB Megabytes
Greater than 1 GB
 		 Gigabytes
<AUTOMATED CONTENT CLASSIFICATION_POLICY_NAME> The name of the Automated Content Classification Policy.
<LEGAL HOLD PHASE SELECTED Y/N> A yes/no token, which specifies whether Legal Hold phase is selected.
<NO.OF ITEMS FAILED IN LEGAL HOLD PHASE> Number of items failed in Legal Hold phase.
<NO.OF ITEMS FAILED IN ERM CONNECTOR PHASE> Number of items failed in ERM Connector phase.
<NO.OF ITEMS FAILED IN RESTORE TO REVIEW SET PHASE> Number of items failed in Restore to Review Set phase.
<NO.OF ITEMS FAILED TO RESTORE> Number of items failed to restore.
<NO.OF ITEMS FAILED TO SEARCH> Number of items failed to search.
<NO.OF ITEMS FAILED TO TAG> Number of items failed to tag.
<NO.OF ITEMS RESTORED SUCCESSFULLY> Number of items restored successfully.
<NO.OF ITEMS SEARCHED SUCCESSFULLY> Number of items searched successfully.
<NO.OF ITEMS SELECTED FOR LEGAL HOLD> Number of items selected for Legal Hold.
<NO.OF ITEMS SELECTED FOR ERM CONNECTOR> Number of items selected for ERM Connector
<NO.OF ITEMS SELECTED FOR TAGGING> Number of items selected for Tagging.
<NO.OF ITEMS SELECTED TO RESTORE TO REVIEW SET> Number of items selected for restoring to review set.
<NO.OF ITEMS SELECTED TO RESTORE> Number of items selected for restore.
<NO.OF ITEMS SELECTED TO SEARCH> Number of items selected for search.
<NO.OF ITEMS SUCCEEDED IN LEGAL HOLD PHASE> Number of items succeeded in Legal Hold phase.
<NO.OF ITEMS SUCCEEDED IN ERM CONNECTOR PHASE> Number of items succeeded in ERM Connector phase.
<NO.OF ITEMS SUCCEEDED IN RESTORE TO REVIEW SET PHASE> Number of items succeeded in restore to review set phase.
<NO.OF ITEMS TAGGED SUCCESSFULLY> Number of items tagged successfully.
<PHASES_IN_JOB> List of phases for the job.
<ERM CONNECTOR PHASE SELECTED Y/N> A yes/no token, which specifies whether ERM Connector phase is selected.
<RESTORE PHASE SELECTED Y/N> A yes/no token, which specifies whether restore phase is selected.
<RESTORE TO REVIEW SET PHASE SELECTED Y/N> A yes/no token, which specifies whether restore to review set phase is selected.
<SEARCH PHASE SELECTED Y/N> A yes/no token, which specifies whether search phase is selected.
<STATUS OF LEGAL HOLD PHASE> Status of the Legal Hold phase.
<STATUS OF ERM CONNECTOR PHASE> Status of the ERM Connector phase.
<STATUS OF RESTORE PHASE> Status of the restore phase.
<STATUS OF RESTORE TO REVIEW SET PHASE> Status of the restore to review set phase.
<STATUS OF SEARCH PHASE> Status of the search phase.
<STATUS OF TAGGING PHASE> Status of the tagging phase.
<TAGGING PHASE SELECTED Y/N> A yes/no token, which specifies whether tagging phase is selected.

Back To Top