> ## 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.

# In-call commands

> In call detail, the command line runs in in-call mode:

In **call detail**, the command line runs in **in-call** mode:

* The **CFS badge** shows which call is targeted.
* **OS 423** means unit 423 on scene **for this call** — no `#` needed.
* **PRI=**, **TYPE=**, **LOC=**, **NARR=**, **N**, and **NS** apply to **this** call.
* Type **`PRI=`** for priority suggestions (1–4). Type **`TYPE=`** for incident types / shortcodes that **start with** what you typed (e.g. `TYPE=ASS` → ASSAULT…).
* Notes from **`N`** / **`NARR=`** appear on the call immediately (quotes optional: `N "test 123"`).
* Type **`HELP STATUS`** (or tap **STATUS** in the HELP dialog) for full timer usage.

Use **`VIEW #<CFS>`** from the dashboard to open a different call, or pick it from the board, before running in-call commands for that CFS.

## Call-only commands (require an open call)

These are recognized when you are on **call detail** (and appear in **HELP** there):

### Status timer (call-level and agency)

| Command              | What it does                                                                                                                                                                                                 |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `STATUS 10`          | Set or restart the **call-level** status timer to *N* minutes (`STATUS 0` stops it).                                                                                                                         |
| `STATUS ON`          | **One agency** on the call → start that agency’s status timer. **Multiple agencies** → you must use `STATUS ON @AgencyName` (the error lists the agencies). **No agency on call** → enable call-level timer. |
| `STATUS OFF`         | Same single / multi / call-level rules to stop timers.                                                                                                                                                       |
| `STATUS OFF @Agency` | Pause the **agency** status timer for that agency on this call.                                                                                                                                              |
| `STATUS ON @Agency`  | Start or resume that agency's status timer (creates the timer if it was never started).                                                                                                                      |

### People and vehicles

| Command                              | What it does                                                                                                                                                                                                                                                            |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PERSON <role> <name…>`              | Add an involved person. **Role** is required: `suspect`, `victim`, `witness`, `other`, `driver`, `passenger`, `passenger_1` … `passenger_4`, `reporting_party`. First word of the name is **first name**; the rest is **last name** (e.g. `PERSON suspect John Smith`). |
| `VEH <color> <make> <model> [plate]` | Add an involved vehicle (e.g. `VEH red Honda Civic ABC123`). Plate is optional; extra tokens are treated as part of the plate.                                                                                                                                          |

### Report flag and email

| Command                  | What it does                                                                                               |
| ------------------------ | ---------------------------------------------------------------------------------------------------------- |
| `FLAG` or `RTF`          | Mark the call **report to follow** (same effect; **RTF** is a shortcut alias).                             |
| `EMAIL user@example.com` | Generate the **CFS PDF** and email it to the address(es) listed. Multiple addresses: separate with spaces. |

### Batch assign

| Command                   | What it does                                                                                                                                                                                    |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ASSIGN @351 @422 @VEH-5` | Assign **multiple** units to **this** call in one line. Each token must start with `@` and match a unit callsign (or ID) in your org. Unknown callsigns are skipped; at least one must succeed. |

### Report number

| Command   | What it does                                                        |
| --------- | ------------------------------------------------------------------- |
| `REPORT#` | Shows or assigns the **report / case number** for the current call. |

How it works depends on your agency's **report-number mode** (configured by a CadmusAdmin):

| Mode                      | `separateReportNumbers` setting | Behavior                                                                                                                                    |
| ------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Same as CFS** (default) | `false`                         | Returns the CFS number — no new number is generated.                                                                                        |
| **Separate sequence**     | `true`                          | Allocates the next number from the agency's format template (e.g. `26-0001`) and writes it to the incident. Also sets **Report to Follow**. |

If a report number has already been assigned (from a previous `REPORT#`, `FLAG`, or close with RTF), the command simply displays it — it will not allocate a second number.

<Note>
  On the **dashboard**, **HELP** does **not** list the call-only table above; open a call and press **HELP** there to see it.
</Note>