# Configure Scheduled Signal Calculations & Alerts

Learn how to schedule _Signal Calculations_ and signal alerts in your Vault.

## About Scheduling Signal Calculations & Alerts

You can configure the _Signal Monthly Calculate and Create Data_ job to run _Signal Calculations_ and the Signal Alert Rule Engine on a scheduled basis. This job provides routine surveillance for potential signals and executes the signal detection process from end to end for pharmacovigilance (PV) data from your Safety database. To obtain results, the scheduler maps date fields from the _Reporting Period_ to a set of predefined <a href="/en/gr/753138/#view-columns">view columns</a> of the _Date_ and _DateTime_ type when applying <a href="/en/gr/753138/#filters">filters</a>. To learn more about what happens when this job runs, see <a href="/en/gr/826975/">Scheduled Signal Calculations & Alerts</a>.



<div class="note-border alert-important">
  <div class="alert alert-important" role="alert">
    <div><i class="far fa-exclamation-circle"></i></div>
    <div class="alert-text">
      <p><strong>Important</strong>: 
You must schedule the <em>Signal Monthly Calculate and Create Data</em> job after the <em><a href="/en/gr/752963/#last-run-report">Workbench Daily Full Data Sync Job</a></em> with enough time to allow the Safety Workbench job to execute all processing. Otherwise, Vault will evaluate <em>Signal Calculations</em> on the data from the previous day. Schedule the <em>Signal Monthly Calculate and Create Data</em> job at least three (3) hours after the <em>Workbench Daily Full Data Sync Job</em> is set to run.</p>
    </div>
  </div>
</div>



## Prerequisites

Before you can configure the scheduled job, you must enable <a href="/en/gr/826977/">scheduling _Signal Calculations_ and alerts</a>.

## Configure the Monthly Job to Schedule Signal Detection

To configure the schedule on which Vault runs _Signal Calculations_ and the Signal Alert Rule Engine for PV data:
1. Navigate to **Admin > Operations > Job Definitions > Signal Monthly Calculate and Create Data**.
2. Select **Edit**.
3. Configure the following fields:
    * **Status**: From the drop-down, select **Active**.
    * **Job Owner**: From the drop-down, select a user or user group.
    * **Repeat By**: Select either **Day of Month** or **Day of the Week**.
    * **Repeat on Day**/**Repeat on**: This field varies based on the _Repeat By_ value. From the drop-down select a value.
    * **Vault Time**: From the drop-down, select a time at which the job will run.
4. Select **Save**.

<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: There is a limitation where the scheduled run will stop processing a <em>Signal Reporting Period</em> if it is associated with a <a href="/en/gr/753144/#create-signal-calculations"><em>Signal Calculation</em> with a <em>Case</em> series</a>. In this scenario, use the Vault notification to navigate to the <em>Signal Reporting Period</em> that resulted in an error. Remove the <em>Case</em> series from the <em>Signal Calculation</em>, set the respective <em>Signal Reporting Period</em> to the <em>Queued</em> state type, and <a href="#manual">manually run the scheduled job</a>. This limitation will be addressed in a future release.</p>
    </div>
  </div>
</div>



## Manually Run the Signal Monthly Calculate and Create Data Job {#manual}

You can manually run the _Signal Monthly Calculate and Create Data_ job in the scenario where the job did not run due to Vault maintenance or errors:
1. Navigate to **Admin > Operations > Job Status**.
2. Under the _Scheduled_ section, hover over the _Signal Monthly Calculate and Create Data_ job.
3. Select the **Actions** menu and then select **Start Now**.
4. In the _Start Now_ dialog, select **Start Now**.

## Scheduled Signal Detection Errors Troubleshooting

When <a href="/en/gr/826975/#scheduled-signal-detection-errors">scheduled signal detection fails</a> for a _Signal Reporting Period_, you can review the Vault notification for next steps. The following are common troubleshooting suggestions:
* Ensure the _Signal_ _View_ and _Case_ series view have the same filters.
* Ensure all required filters are populated.
* Ensure the _Case_ series view and the _Signal View_ on the _Signal Calculation_ share the same _Principal View_ and have the same dependent views.
* Ensure the <a href="/en/gr/825938/#assign-the-case-version-key-on-principal-views">_Case Version Key_</a> is populated on the _Case_ series view's _Principal View_.
* Ensure the <a href="/en/gr/825938/#add-view-columns">_Signal Case Series Key_</a> is populated for all view columns on the _Case_ series view and that it matches the _API Name_ of the _Statistical Data_.

In addition to reviewing the Vault notification, you can:
* Review the detailed error log in **Business Admin > Objects > Workbench Logs**. By default, Vault sorts these logs by the day and time the error was encountered, starting with the most recent. In the _Workbench Log Data_ field, select the attachment to download the error log to review and resolve the issues.
* <a href="/en/gr/24762/#actions-on-job-instances">Download the job instance log</a> for the _Signal Monthly Calculate and Create Data_ job.