DRY0003 - Click OK to Terminate

DRYCAD Suite | User Documentation | v1.0.0

Table of Contents

1. Overview
2. Getting Started
3. User Interface
4. Configuration: settings.ini
5. Examples
6. Troubleshooting
7. Version History

1. Overview

CATIA V5’s own crash dialog gives you exactly one option: click OK, and the session terminates, no save prompt, no chance to recover unsaved work. DRY0003 – Click OK to Terminate runs alongside CATIA and gets ahead of that moment: it reads every document still open in the crashing session and lets you save what you need before the process actually goes down.

What it does:

• Lists all open documents (Parts, Products, Drawings) in the active CATIA session
• Shows each document’s save state, saved, unsaved, or never-saved, with a status icon
• Saves already-named documents in place, and prompts for a save location for documents that were never saved
• Refreshes the document list on demand
• Optionally filters the list to show only unsaved documents

Supported CAD platforms: CATIA V5

Workspace requirement: None, the tool works regardless of the active workspace type (General, Part, Product, Drawing, or Sketch), since it operates on the whole CATIA session rather than a single document.

2. Getting Started

Prerequisites

• CATIA V5 must be running
• You must be logged in with a valid DRYCAD Suite user account

Launching the Tool

DRY0003 is launched from the DRYCAD Suite CommandBar inside CATIA V5. Click the corresponding button to open the panel.

The tool checks the following conditions at startup, and will show an error and close if any fail:

• A valid user session is found
• CATIA V5 is running
• The active workspace is one of the supported types

If CATIA closes, or the process is no longer detected, DRY0003 checks the CATIA process every 5 seconds and closes itself automatically once it’s no longer valid, there’s no point keeping a rescue panel open once there’s nothing left to rescue.

The DRYCAD Menu

Every DRYCAD Suite tool with a user interface includes a menu in the top bar, accessed via the hamburger icon next to the window controls.

3. User Interface

The panel is a single view: a list of open documents, with save controls beneath it.

3.1 Open Documents (List)

Displays every open document found in the current CATIA session, each row showing:

• A save status icon, saved, unsaved, or never-saved (new, no filename yet)
• A document type icon, Part, Product, or Drawing
• The document name, with the full file path shown as a tooltip

Select one or more documents (multi-select is supported) to include them in the next save operation. If Show only unsaved documents is enabled in settings.ini (see Section 4), documents that are already saved are hidden from the list entirely.

3.2 Refresh

The refresh button re-reads the list of open documents from CATIA, useful if you’ve opened or closed documents since the panel appeared.

3.3 Close / SAVE

Saving does not close the panel, the list refreshes afterward so you can confirm the result or save additional documents before CATIA terminates.

4. Configuration: settings.ini

File Location

<install_folder>/DRY0003/settings.ini

Can also be opened directly via Open Settings in the DRYCAD Menu (see Section 2), or reset via Clear Settings.

Structure

[Settings]
; Documents visibility: show only unsaved documents (0: False [default], 1: True)
SHOW_ONLY_UNSAVED_DOCUMENTS="0"

Lines starting with ; are comments and are ignored.

Parameters

SHOW_ONLY_UNSAVED_DOCUMENTS

When set to 1, the Open Documents list only shows documents that haven’t been saved, useful when a session has many open files and you only want to see what’s actually at risk.

; Example, only show unsaved documents
SHOW_ONLY_UNSAVED_DOCUMENTS="1"

5. Examples

Example 1, Recovering from a crash with mixed document states

A session has three documents open when CATIA crashes: one Part saved minutes ago with unsaved changes, one Product that has never been saved, and one Drawing that’s fully up to date.

What happens:

• The list shows all three documents by default (or just the first two if SHOW_ONLY_UNSAVED_DOCUMENTS=1)
• Selecting the Part and clicking SAVE saves it immediately to its existing file
• Selecting the never-saved Product and clicking SAVE opens a Save As dialog titled SAVE LOCATION FOR UNSAVED FILE <name>, letting you choose where to store it before CATIA closes
• The already-saved Drawing can be left unselected, there’s nothing to recover

Key points:

• Save behavior is per-document: named files save silently, unnamed files always prompt for a location
• You can save documents in separate batches before finally letting CATIA terminate

6. Troubleshooting

”User not found. Please login and try again.”

The tool could not find a valid DRYCAD Suite user session. Make sure you are logged in to the Suite before launching the tool.

”CATIA is not open. Please open CATIA and try again.”

The tool cannot detect a running CATIA V5 process. This is unusual for a crash-recovery scenario, if CATIA has already fully closed, there’s no session left to recover documents from.

”Invalid Workspace”

No supported workspace could be detected in the CATIA session. This is rare for DRY0003 since it accepts every workspace type; if you see this, the CATIA session may already be in an unrecoverable state.

”Failed to save the selected documents.”

One or more selected documents could not be saved, commonly because the CATIA session is already too unstable to complete the save operation, or a chosen save location is invalid or inaccessible. Try saving documents individually, starting with the most important ones.

The panel closes on its own

DRY0003 monitors the CATIA process every 5 seconds and closes automatically once CATIA is no longer running. This is expected, once the crashing instance is gone, there’s nothing left to save.

7. Version History

DRY0003, Click OK to Terminate | DRYCAD Solutions | v1.0.0