Changing the location of Client work files: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(One intermediate revision by the same user not shown)
Line 4: Line 4:
<span class="f_Para">The Client [[Customize debuggerConfig file|configuration file]] (</span><span class="f_Monospace">debuggerConfig.xml</span><span class="f_Para">) has optional XML elements with which you can specify alternative folder locations for the Client work files. The files are divided into three groups, each of which is controlled by a single element, as follows: </span>
<span class="f_Para">The Client [[Customize debuggerConfig file|configuration file]] (</span><span class="f_Monospace">debuggerConfig.xml</span><span class="f_Para">) has optional XML elements with which you can specify alternative folder locations for the Client work files. The files are divided into three groups, each of which is controlled by a single element, as follows: </span>


* <span class="f_MonoBold">&lt;stateFileFolder&gt;</span><span class="f_ListBul1"> specifies where most Client work files are written (log, preferences, searches, for example) </span>
* <span class="term">&lt;stateFileFolder&gt;</span><span class="f_ListBul1"> specifies where most Client work files are written (log, preferences, searches, for example) </span>
* <span class="f_MonoBold">&lt;uiFolder&gt;</span><span class="f_ListBul2"> specifies where the Client interface-customization files (ui.xml, uimore.xml) are stored</span><span class="f_ListBul1">  </span>
* <span class="term">&lt;uiFolder&gt;</span><span class="f_ListBul2"> specifies where the Client interface-customization files (ui.xml, uimore.xml) are stored</span><span class="f_ListBul1">  </span>
* <span class="f_MonoBold">&lt;macroLibraryFolder&gt;</span><span class="f_ListBul1"> specifies where Client macro files are stored  </span>
* <span class="term">&lt;macroLibraryFolder&gt;</span><span class="f_ListBul1"> specifies where Client macro files are stored  </span>


<span class="f_Para">Within </span><span class="f_Monospace">debuggerConfig.xml</span><span class="f_Para">, you specify folder path values for the elements as in the following: </span>
<span class="f_Para">Within </span><span class="f_Monospace">debuggerConfig.xml</span><span class="f_Para">, you specify folder path values for the elements as in the following: </span>
Line 55: Line 55:
|-
|-
| <span class="f_DefListDDTable">'''log.txt'''</span>
| <span class="f_DefListDDTable">'''log.txt'''</span>
| <span class="f_DefListDDTable">The Debugger [[debugging_the_debugger.html#log_client_jd|Client log]] </span>
| <span class="f_DefListDDTable">The Debugger [[Debugging the Janus Debugger|Client log]] </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
|-
|-
Line 75: Line 75:
|-
|-
| <span class="f_DefListDDTable" style="font-style: italic;">'''name'''</span><span class="f_DefListDDTable">'''.watch'''</span>
| <span class="f_DefListDDTable" style="font-style: italic;">'''name'''</span><span class="f_DefListDDTable">'''.watch'''</span>
| <span class="f_DefListDDTable">[[saving_restoring_watch_window.html|Saved]] </span><span class="f_GUIlabelTable">Watch Window</span><span class="f_DefListDDTable"> lists </span>
| <span class="f_DefListDDTable">[[Saving and restoring Watch Window contents|Saved]] </span><span class="f_GUIlabelTable">Watch Window</span><span class="f_DefListDDTable"> lists </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
|-
|-
Line 87: Line 87:
|-
|-
| <span class="f_DefListDDTable">'''getVariableList.xml'''</span>
| <span class="f_DefListDDTable">'''getVariableList.xml'''</span>
| <span class="f_DefListDDTable">The remembered position and size of the </span><span class="f_MonoSpTable">[[getvVriablesForClass command|getVariablesForClass]]</span><span class="f_DefListDDTable"> command output window </span>
| <span class="f_DefListDDTable">The remembered position and size of the </span><span class="f_MonoSpTable">[[getVariablesForClass command|getVariablesForClass]]</span><span class="f_DefListDDTable"> command output window </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
|-
|-
| <span class="f_DefListDDTable">'''history.xml'''</span>
| <span class="f_DefListDDTable">'''history.xml'''</span>
| <span class="f_DefListDDTable">The remembered position and size of the </span><span class="f_GUIlabelTable">[[display_stmt_history.html|Execution History]]</span><span class="f_DefListDDTable"> window </span>
| <span class="f_DefListDDTable">The remembered position and size of the </span><span class="f_GUIlabelTable">[[Displaying a statement history|Execution History]]</span><span class="f_DefListDDTable"> window </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
|-
|-
| <span class="f_DefListDDTable">'''preferences.xml'''</span>
| <span class="f_DefListDDTable">'''preferences.xml'''</span>
| <span class="f_DefListDDTable">The settings from the </span><span class="f_GUIlabelTable">[[file_menu_opts.html|Preferences]]</span><span class="f_DefListDDTable"> and </span><span class="f_GUIlabelTable">[[changing_colors.html|Color Preferences]]</span><span class="f_DefListDDTable"> dialog boxes </span>
| <span class="f_DefListDDTable">The settings from the </span><span class="f_GUIlabelTable">[[File menu options|Preferences]]</span><span class="f_DefListDDTable"> and </span><span class="f_GUIlabelTable">[[Changing the colors in Client displays|Color Preferences]]</span><span class="f_DefListDDTable"> dialog boxes </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
|-
|-
| <span class="f_DefListDDTable">'''shortcuts.xml'''</span>
| <span class="f_DefListDDTable">'''shortcuts.xml'''</span>
| <span class="f_DefListDDTable">The remembered position and size of the </span><span class="f_GUIlabelTable">[[intro_configurable_components.html#keyboard_shortcut|Keyboard Shortcuts]]</span><span class="f_DefListDDTable"> window </span>
| <span class="f_DefListDDTable">The remembered position and size of the </span><span class="f_GUIlabelTable">[[Introducing the configurable components#Keyboard shortcuts|Keyboard Shortcuts]]</span><span class="f_DefListDDTable"> window </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
|-
|-
| <span class="f_DefListDDTable">'''textviewer.xml'''</span>
| <span class="f_DefListDDTable">'''textviewer.xml'''</span>
| <span class="f_DefListDDTable">The remembered position and size of the </span><span class="f_GUIlabelTable">[[copying_printing_saving_text.html|Text Viewer]]</span><span class="f_DefListDDTable"> window </span>
| <span class="f_DefListDDTable">The remembered position and size of the </span><span class="f_GUIlabelTable">[[Copying, printing, or saving text|Text Viewer]]</span><span class="f_DefListDDTable"> window </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
| <span class="f_DefListDDTable">stateFileFolder </span>
|-
|-

Latest revision as of 03:27, 14 November 2022

The Debugger Client uses a variety of text files to store information about user activity to maintain its tools and displays, as well as a comprehensive troubleshooting log. These work files are catalogued below.

The Client configuration file (debuggerConfig.xml) has optional XML elements with which you can specify alternative folder locations for the Client work files. The files are divided into three groups, each of which is controlled by a single element, as follows:

  • <stateFileFolder> specifies where most Client work files are written (log, preferences, searches, for example)
  • <uiFolder> specifies where the Client interface-customization files (ui.xml, uimore.xml) are stored  
  • <macroLibraryFolder> specifies where Client macro files are stored  

Within debuggerConfig.xml, you specify folder path values for the elements as in the following:

<debuggerConfig version="1.0">        ...     <stateFileFolder>c:\myData</stateFileFolder>     <uiFolder>c:\myUI</uiFolder>      <macroLibraryFolder>c:\work\macroLibrary</macroLibraryFolder>        ... </debuggerConfig> 

If you include an element, the specified folder location is validated when the Client is started, and you receive an error if the folder is missing or not writable. The locations are also reported in the audit trail.

If an element is not specified, the installation target folder is the assumed location. The exception to this is the macroLibraryFolder element: if this element is not specified, the Client will initially attempt to store or find macro files in the stateFileFolder location, else in the Client installation folder. Similarly, if the macroLibraryFolder element is specified, the Client tries that location first, else it tries the stateFileFolder location, else the Client installation folder.

A summary of the Client files

File (by type) File content Configuration file element that specifies file default location
name.macro Client macro macroLibraryFolder
excludeProc.txt The list of procedures to be excluded from debugging stateFileFolder
excludeRoutine.txt The list of methods and subroutines to be excluded from debugging stateFileFolder
find.txt The most recent Search terms stateFileFolder
includeProc.txt The list of procedures not to be excluded from debugging stateFileFolder
includeRoutine.txt The list of methods and subroutines not to be excluded from debugging   stateFileFolder
log.txt The Debugger Client log stateFileFolder
until.txt The most recent run-until target procedures stateFileFolder
vars.txt The most recent entries in the text box above the Watch Window stateFileFolder
watchmemory.txt The contents of the Watch Window between Client runs (if feature is enabled) stateFileFolder
whitelist.txt The white list of procedures to omit from debugging   stateFileFolder
name.watch Saved Watch Window lists stateFileFolder
about.xml The remembered position and size of the Client's About box stateFileFolder
console.xml The remembered position and size of the Macro Console window stateFileFolder
getVariableList.xml The remembered position and size of the getVariablesForClass command output window stateFileFolder
history.xml The remembered position and size of the Execution History window stateFileFolder
preferences.xml The settings from the Preferences and Color Preferences dialog boxes stateFileFolder
shortcuts.xml The remembered position and size of the Keyboard Shortcuts window stateFileFolder
textviewer.xml The remembered position and size of the Text Viewer window stateFileFolder
ui.xml Modifications to the Client's default buttons and hot key associations uiFolder
uimore.xml Settings that override the  ui.xml file settings uiFolder
valueDisplay.xml Remembered position and size of Value window displays stateFileFolder
windowmemory.xml Remembered position and size of the main Debugger Client window stateFileFolder

See Also:

Alternative locations for Debugger documentation files