> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cadmus-cad.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Agency Settings: NCIC, Traffic Stops, Unit Login, and Report Numbers

> Configure agency-level toggles in Cadmus Web Admin — enable NCIC access, require dispatch unit login for MDT users, allow traffic stops, and set up RMS report number formats.

Agency settings give AgencyAdmins precise control over what officers and dispatchers in a single agency can do — from whether traffic stops and citations appear in the workflow to whether MDT users must be logged onto a unit by dispatch before entering the app. Because these settings are agency-scoped, they do not affect other agencies in your organization, and some can be further refined at the individual user level through [per-user overrides](/admin/user-agency-overrides).

## Open agency settings

<Steps>
  <Step title="Select your organization">
    From the Web Admin sidebar, confirm the correct organization is selected.
  </Step>

  <Step title="Go to Agencies">Select **Agencies** in the sidebar.</Step>

  <Step title="Choose the agency">
    Select the agency you want to configure.
  </Step>

  <Step title="Open Settings">
    Select the **Settings** tab for that agency, or navigate directly to
    `/agencies/{agencyId}/settings`.
  </Step>
</Steps>

This page requires the **AgencyAdmin** role or higher (`canManageAgencyResources`).

## Boolean settings

Settings are grouped by category and displayed with color-coded labels: **Safety** (red), **Access** (blue), **Features** (green), and **Compliance** (orange).

<Tabs>
  <Tab title="Traffic Stops Allowed">
    * **Category:** Safety
    * **Default:** Enabled
    * **Effect when on:** Users may conduct traffic stops and generate citations from Dispatch CAD and mobile apps.
    * **Effect when off:** Traffic stop and citation workflows are restricted for all users in this agency.
    * **User override:** Allowed — you can disable traffic stops for individual users (for example, trainees) without affecting the rest of the agency.
  </Tab>

  <Tab title="State/NCIC Access">
    * **Category:** Access
    * **Default:** Disabled
    * **Effect when on:** Users who also have NCIC access at the user level can run state and NCIC queries — provided CJIS routing is configured at the organization level.
    * **Effect when off:** All NCIC queries are denied for this agency's users.
    * **User override:** Allowed — you can enable NCIC for a specific certified operator while leaving the agency default off.

    <Warning>
      Enabling State/NCIC Access here without first configuring an org-level CJIS site causes queries to fail at runtime. Configure CJIS before enabling this toggle.
    </Warning>
  </Tab>

  <Tab title="Require unit login by dispatch">
    * **Category:** Access
    * **Default:** Disabled
    * **Effect when on:** MDT users whose effective setting is on remain in a waiting room after sign-in until dispatch logs them onto an active unit.
    * **Effect when off:** MDT users can enter the app after normal sign-in, matching the legacy behavior.
    * **User override:** Allowed — you can require this for one deputy while the agency default is off, or exempt one user while the agency default is on.

    <Note>
      This applies to field MDT sessions on Windows, Android, and iOS. Dispatch CAD and enrolled unit-device or apparatus tablet mode are not gated by this setting.
    </Note>
  </Tab>

  <Tab title="Separate RMS Report Numbers">
    * **Category:** Features
    * **Default:** Disabled
    * **Effect when on:** "Report to Follow" closures assign RMS case numbers that are separate from the CFS number, using the **Report Number Format** you configure below.
    * **Effect when off:** The report number equals the CFS number.
    * **User override:** Not allowed — this setting applies to the entire agency.
  </Tab>

  <Tab title="CAD Module">
    * **Category:** Features
    * **Default:** Enabled (existing agencies keep full access until you change this)
    * **Effect when on:** Dispatch CAD and Mobile CAD show calls, map, dashboard, and call-linked citation workflows.
    * **Effect when off:** Mobile hides Calls, Find a Call, Map, and Dashboard navigation for that agency. Officers use e-citations without linking to a CAD call.
    * **User override:** Not allowed — applies to the entire agency.
  </Tab>

  <Tab title="E-Ticket Module">
    * **Category:** Features
    * **Default:** Enabled (existing agencies keep full access until you change this)
    * **Effect when on:** Mobile **E-Ticket** and agency citation settings are available. In production builds, e-tickets unlock when this module is on for the agency.
    * **Effect when off:** Mobile hides **E-Ticket** and citation configuration is disabled for that agency.
    * **User override:** Not allowed — applies to the entire agency.

    <Warning>
      At least one of **CAD Module** or **E-Ticket Module** must stay enabled. Cadmus rejects saving when both are off.
    </Warning>
  </Tab>
</Tabs>

## Report number format

The **Report Number Format** field appears only when **Separate RMS Report Numbers** is enabled. Use the following tokens to build your format string:

| Token      | Output                                        |
| ---------- | --------------------------------------------- |
| `{YYYY}`   | 4-digit year (e.g., `2026`)                   |
| `{YY}`     | 2-digit year (e.g., `26`)                     |
| `{NNNN}`   | 4-digit zero-padded sequence (e.g., `0001`)   |
| `{NNNNNN}` | 6-digit zero-padded sequence (e.g., `000001`) |
| `{AGENCY}` | Agency abbreviation as configured in Cadmus   |

**Example:** `{AGENCY}-{YY}-{NNNN}` produces `CPD-26-0001`.

<Tip>
  Document the format string in your agency's SOP and align it with your RMS
  vendor's case number field requirements before enabling separate numbering in
  production.
</Tip>

## Save workflow

<Steps>
  <Step title="Enter edit mode">
    Select **Edit** if the page requires it to unlock fields.
  </Step>

  <Step title="Adjust settings">
    Toggle boolean settings or edit the report number format string.
  </Step>

  <Step title="Save">Select **Save**.</Step>

  <Step title="Confirm success">
    Wait for the success toast notification to confirm the changes were applied.
  </Step>
</Steps>

## Dispatch and mobile impact

| Setting                        | When OFF                                            | When ON                                                         |
| ------------------------------ | --------------------------------------------------- | --------------------------------------------------------------- |
| Traffic Stops Allowed          | Traffic and citation flows restricted               | Normal traffic stop workflow available                          |
| State/NCIC Access              | Queries denied                                      | Queries allowed if user also has effective NCIC access          |
| Require unit login by dispatch | MDT opens normally after sign-in                    | MDT waits until dispatch logs the user onto a unit              |
| Separate Report Numbers        | Report number equals CFS number                     | Custom RMS numbering per format string                          |
| CAD Module                     | Mobile hides CAD navigation (calls, map, dashboard) | Full CAD workflows in Dispatch and Mobile                       |
| E-Ticket Module                | Mobile hides E-Ticket; citation settings disabled   | E-citations available; production E-Ticket unlocks when enabled |

## Common mistakes

<Warning>
  Disabling **Traffic Stops Allowed** mid-shift affects units already on traffic
  calls. Communicate the change to active units before toggling.
</Warning>

<Warning>
  Changing the **Report Number Format** after numbers have already been issued
  can create gaps or duplicate sequences. Coordinate with your records manager
  before modifying the format string in production.
</Warning>

* **Enabling NCIC without org CJIS configuration** — the agency-level toggle is only half of the requirement; org CJIS routing must also be set up.
* **Enabling unit-login gating without shift procedures** — officers will wait after sign-in until dispatch logs them onto a staffed unit. Confirm F2 unit-login procedures before enabling this agency-wide.
* **Changing report format after numbers are issued** — historical records reference the old format; the mismatch complicates reconciliation.
* **Assuming separate copies exist** — mobile and Dispatch CAD read the same agency settings; there are no separate configuration copies to keep in sync.
