# Run the intended saved netlist and recognise stale results

Run simulation from a netlist tab and resolve save/external-change decisions first. Imported result files can be inspected but cannot be simulated.

## Compatibility

2.9.0 release target; current-source Windows candidate evidence

Published guidance with release-applicability limits. Confirm package applicability before following this guide.

**KB-GUI-007 · verified workaround**: Save the intended source, record its location and explicitly reopen and run it after relaunch. Automatic normal-exit tab restoration is not accepted on the checked JoSIM candidate.

**KB-RESULT-001 · verified workaround**: Save the intended edited source before Run and verify current arrays. Choosing No runs the saved source; the document current label may then disagree with the still-edited buffer.

[Download Complete diode and polynomial current/charge teaching models (ZIP)](/_functions/kbExample?name=josim-nonlinear-models.zip)

Includes: diode-ac.cir, diode-dc.cir, diode-op.cir, diode-tran.cir, diode.inc, poly-ac.cir, poly-dc.cir, poly-op.cir, poly-tran.cir, poly.inc, run_models.py, README.txt.

## Before starting

Use the intended 2.9 release and its matching manual. These steps are derived from maintained source documentation; availability in the final distributed package must be checked.

## Steps

1. Open the intended netlist tab. Save an untitled document before its first run.
2. For unsaved semantic edits, deliberately choose save-and-run, run the last saved file, or cancel. Resolve external file changes before proceeding.
3. Choose Run > Run simulation, the command-palette action or the toolbar Run action.
4. Read the completion and case status in Tasks and Output. For cancellation, request Cancel and wait for the worker to finish before another run.
5. After edits or settings changes, treat earlier results as stale until the intended configuration has run successfully.

![JoSIM source editor with JTL_Example.cir open, source breadcrumbs, line numbers and the Run triangle in the toolbar.](https://static.wixstatic.com/media/31de30_b7c9ff63ee004493b55c65bbe8da14b7~mv2.png)

Check the active source tab and saved state before running the circuit.

## Check the save choice against the actual data

The checked 2.9.0 path offers Yes to save and run, No to run the saved file, and Cancel to stop. With a visible unsaved 20 ps edit, No ran the saved 5 ps model and retained 401 samples. Its task was stale, but the document incorrectly reported Results current (KB-RESULT-001).

Use Yes when the edit should run. The native check saved and ran 20 ps, then used normal Undo followed by Yes/save and Run to recover the original 5 ps source and arrays. Compare saved source and the current numerical data; neither a document label nor solver completion establishes accuracy.

![The actual unsaved-source dialog offers Yes to save and run, No to run the saved file, and Cancel to stop.](https://static.wixstatic.com/media/31de30_d2a0f424428b4c76999682fd38ca2235~mv2.png)

Choose Yes to run the visible edit. No can retain a stale task while the document incorrectly says Results current; verify source identity and the new numerical data.

## Check the result

The selected result belongs to the intended saved netlist and case. Failed, cancelled and not-run cases remain distinct.

Viewing imported CSV/TSV or running the last saved file does not establish that unsaved editor text was simulated.

## If the problem remains

If Run is unavailable, check netlist-vs-result tab type, save/external-change state and licensing. Keep diagnostics rather than repeatedly launching an unchanged failing run.

## If no tab returns after restarting

Save the source before exiting. Automatic session restoration failed in the checked current-source Windows candidate: after normal close, a second process restored no tab (KB-GUI-007).

Explicitly reopen the saved .cir file, confirm its path and rerun for a new current result. That route passed in a separate process before export. It does not establish persistence of previous in-memory results or fix automatic restoration.

## Sources and verification details

Recorded inputs/builds only. Complete walkthrough and final-package acceptance remain separate.

- VAL-016: JoSIM-Pro 2.9 current-source Windows candidate with matching freshly built runtime; not the final distributed package. Production GUI controls, normal licensed JTL and AND runs, missing-include restoration, exact input/output collision rejection and operator-assisted CSV/All traces export. Explicitly reopening saved JTL and rerunning also passed Automatic session restoration failed (KB-GUI-007). File opening was supplied at the production OpenFile boundary; folder-picker input, cancellation, retry, other export formats, physical accuracy and final-package acceptance remain unverified. CSV/CLI differences were at most one ULP in this example, not an accuracy or regression tolerance. The Clang-built runtime does not close the separate MSVC/OpenMP finding KB-BUILD-001. External Computer Use capture remains unqualified.
- VAL-069: Fresh frozen Windows JoSIM-Pro 2.9.0 nonlinear review candidate. 25 independent native/source/artifact checks, two normal app processes, fourteen successful runs and one failed run. Actual editor key/text commit, Cancel/No/Yes, source/disk separation, coarser-step/Undo/save recovery, typed AC opening and explicit saved-source reruns. No can run the saved model while the document incorrectly says Results current. No product repair, complete GUI article, physical OS picker/pointer, automatic session restoration, final package/platform or general measured-device accuracy acceptance. The task, document label and numerical reference retain separate scopes.

- josim-jtl-editor: JoSIM-Pro 2.9 manual UI reference. A maintained manual UI reference, not a fresh calculation or a completed walkthrough. Final distributed-package applicability remains to be checked.
- josim-nonlinear-save-before-run: Fresh frozen Windows JoSIM-Pro 2.9.0 nonlinear candidate, reviewed 4 November 2026. Bounded illustration with independent raw-data checks. Known reference/freshness limits, physical OS picker/pointer, arbitrary physical model and final-package/platform qualification remain separate.

- josim-pro:docs/manual_source/sections/gui_simulation_results.tex: Simulation lifecycle; Preconditions for running; Result states and diagnostics
- owner:technical-review-20261102: Owner selected 2.9 as the publication target; final package checks remain required
- validation:josim-native-windows-20261103: VAL-016; exact native actions, independent output checks, operator Save and failed automatic-restoration boundary
- validation:nonlinear-models-20261104: VAL-069 actual Cancel/No/Yes, saved-source identity and document freshness contradiction

- VAL-016 retains its saved-JTL and explicit-reopen scope. VAL-069 adds actual Cancel/No/Yes, source edit/Undo/save and separate-process nonlinear reruns. External-change decisions, worker cancellation, imported-result run prevention and final packages remain unexercised.
- Automatic session restoration failed and remains KB-GUI-007. No complete GUI lifecycle acceptance is claimed.

## Related guides

- [Run the installed JTL example in JoSIM®-Pro](/knowledge-base/josim-first-jtl)
- [Check a JoSIM workspace before running simulations](/knowledge-base/josim-workspace-diagnostics)
- [Export waveform figures or numerical CSV/TSV data](/knowledge-base/josim-export-results)
- [Compare cases and create derived traces or measurements](/knowledge-base/josim-derived-traces)
- [Review Git changes, stage selected lines and resolve a source conflict](/knowledge-base/josim-git-review)
- [Simulate a diode and check current, charge and reference limits](/knowledge-base/josim-diode-current-charge)
- [Define and validate polynomial current and charge](/knowledge-base/josim-polynomial-current-charge)
- [Compare and restore a previous saved source version](/knowledge-base/josim-local-save-history)
- [Choose autosave and recover unsaved source](/knowledge-base/josim-autosave-recovery)
- [Search and replace across a workspace](/knowledge-base/josim-workspace-replace)