Preview: this page describes the next FireCAD release, planned for December 1, and the beta available now. For the current release, see Clearing XRecords.
Command
| Command | Description |
|---|---|
ATUTILS_CLEAR_ALL_XRECORDS |
Remove FireCAD's records from every device, wire path and wire path label in the active drawing |
Type the command at the AutoCAD command line.
Important: This is a last-resort maintenance command. Running it unlinks every wire path and wire path label in the drawing from the project. You will have to redraw them. Do not run it to fix question marks on devices or other stale device data; see "When Not to Use This Command" below.
Prerequisites
- A FireCAD project must be open.
- The active drawing must belong to that project. If it does not, the command stops with "The active drawing is not included in this project".
- A backup of the project and the drawing. See What Is the Best Way to Make a Project Revision or Backup the Project and Drawing.
Overview
FireCAD keeps a small record (an XRecord) on each object it manages in a drawing. The record tells FireCAD which project item the object belongs to. This command removes those records from the active drawing:
| Object | What is removed |
|---|---|
| Devices | The device record, the record on each device label attribute, and the device state stamp |
| Wire paths | The wire path (segment) record |
| Wire path labels | The wire path label record |
Nothing is erased from the drawing and nothing is deleted from the project database by the command itself. The effect shows up on the next Validate:
- Devices are recognised again. Validate rebuilds their records.
- Wire paths and wire path labels are not. Validate only keeps a wire path that still carries its record, so it drops every wire path and wire path label in the drawing from the project. The lines stay on screen as plain AutoCAD objects, but FireCAD no longer treats them as circuit wiring: lengths, wire path labels and anything that reads the drawn routing are lost until you redraw them.
Device connections are stored in the project, not in the drawing, so the circuits and the devices on them are kept.
Steps
-
Back up the project and the drawing.
-
Type
ATUTILS_CLEAR_ALL_XRECORDSat the command line. -
FireCAD asks:
"This removes FireCAD's records from every device, wire path and wire path label in this drawing. Wire paths and their labels lose their link to the project on the next Validate. Continue? [Yes/No]
" The default is No. Pressing Enter or Esc, or answering No, cancels with "Nothing was changed."
-
Answer Yes to continue. FireCAD reports how many objects it cleared:
"Cleared FireCAD records on N object(s). Run Validate to rebuild the device records; wire paths and wire path labels are not relinked."
If anything fails, the whole operation is rolled back and FireCAD reports "Clearing the records failed, nothing was changed".
-
Run Validate (
ATVALIDATE) to rebuild the device records. -
Redraw the wiring. Use Draw Circuit Wirepath for each circuit, then refresh the wire path labels. Erase the old, unlinked wire path lines and labels so they are not confused with the new ones.
If You Answered Yes by Mistake
Do not run Validate and do not save. Close the drawing without saving it, then reopen it. If the drawing was already saved and validated, restore the drawing and project from your backup.
When Not to Use This Command
-
Question marks on every device, or devices showing a stale status after a drawing was recovered, relinked or saved as a copy. Run Validate (
ATVALIDATE) instead. In the release from December 1, Validate detects a device record that names another drawing or an old handle and rewrites it, so the question marks clear on their own. -
Blocks that are not FireCAD devices but carry FireCAD device data (for example, blocks pasted in from another project, or a drawing that suddenly stops drawing model space). Use
ATFIND_STRAY_DEVICE_DATA, which lists those blocks, selects them, and asks "Remove the FireCAD data from these blocks? The blocks themselves are kept." It only touches the stray blocks and leaves your wiring alone. - Orphaned rows in the project database. Use Deleting Orphaned Records.
- Any drawing where you want to keep the wire paths you have drawn.
When to Use
- When you deliberately want to strip FireCAD's records from a drawing and you accept redrawing every wire path and wire path label in it.
- When Cadgen support asks you to run it as part of a specific repair.
Related Articles
- Validating the Active Drawing
- Deleting Orphaned Records
- Deleting All Segments
- Auto Draw Circuit Wirepath
- What Is the Best Way to Make a Project Revision or Backup the Project and Drawing
FireCAD is the industry-leading AutoCAD add-in for fire alarm system design — from circuit layout to wire routing to code-compliant reports.
Learn more and get started at getfirecad.com →
Inspect Point Integration — Fire alarm system device lists and bill of materials can be pushed directly from FireCAD into Inspect Point, eliminating manual data entry and ensuring every device is ready for inspection scheduling and ongoing asset management.
Learn more here →