Diagnostics options

The Diagnostics tab of the User Preferences dialog box offers these options.

Section Description
General settings The General section includes these options:
  • Enabled - When selected, diagnostic information is recorded in the session log.

    Otherwise, diagnostic information is not recorded.

    Caution: 
    Be aware that enabling diagnostic information to be recorded can have negative impacts on system performance, so you should enable this only in a development environment.
  • System Information - When selected, system information is included in the session log when diagnostic information is recorded. Such messages identify the current language ID, the current string table, and other general settings in effect.

    Otherwise, this information is omitted.

  • Save to Disk - When selected, diagnostic information is written directly to a file on your computer's hard drive. Middle tier messages are excluded even if they are recorded in the session log. The system creates the file WinStudio.log and puts it in the C:\Documents and Settings\login\Local Settings\Temp folder (where login is a workstation login) and then within a generated folder that is randomly named.

    For example:

    C:\Documents and Settings\JohnQPublic\Local Settings\Temp\1\Winstudio.log

    Note:  It might be simpler to use the Windows search feature to find the WinStudio.log document than to look through the folders manually.

    Otherwise, diagnostic information is recorded only in the session log and not in a separate file.

    Caution: 
    Selecting this option slows processing.
  • Security - When selected, security information about form-level and component-level permissions is recorded in the log.

    Otherwise, security information is omitted from the log.

Form settings The Form section includes these options: 
  • Initialization - When selected, an entry is included in the diagnostic record each time a form is opened, including information about the initialization parameters.

    Otherwise, form initialization data is not recorded.

  • Events - When selected, an entry is included in the diagnostic record about each event that is generated by the system.

    Otherwise, event data is not recorded.

Event Handler > Include setting When selected, information about event handlers is included in the diagnostic record, whenever an event handler is used.

Otherwise, event handler data is not recorded.

Validator > Include setting When selected, information about validators is included in the diagnostic record, whenever a validator is used.

Otherwise, validator data is not recorded.

Variable settings The Variable section includes these options: 
  • Initialization - When selected, each time a variable is created, information is included about whether the variable is global or form-level, persistent or temporary.

    Otherwise, variable initialization data is not recorded.

  • Value Changed - When selected, each time a the value of a variable changes, information is included about the previous value and the new one.

    Otherwise, data is not recorded when the value of a variable changes.

  • Dependent Notification - When selected, data is included each time the dependents of a variable are refreshed because the value of the variable is changed.

    Otherwise, this data is not recorded.

Call Details settings The Call Details section includes these options: 
  • Scripts - When selected, diagnostic information is included about the execution of scripts, including script parameters and return values.

    Otherwise, script execution data is not recorded.

  • IDO Methods - When selected, diagnostic information is included about IDO methods executed from event handlers or from validators, including method parameters, return codes, and error messages.

    Otherwise, this diagnostic information is not recorded.

  • Form Server - When selected, diagnostic information is included about the form server from which forms data was obtained.

    Otherwise, this diagnostic information is not recorded.

Component settings The Component section includes these options: 
  • Initialization - When selected, information is included about components in the log.

    Otherwise, no information about components is recorded, even if other options in this group are selected.

  • List building - When selected, nformation is included about lists, when they are created and when they are invalidated (so that the next access will cause them to be recreated).

    Otherwise, list building information is not recorded.

  • User interaction - When selected, the interactions of all users' with the component is recorded, including messages about these actions:
    • Focus changes to the component or away from it.
    • Selection of items from lists.
    • Clicking of a button on the component.
    • Data being typed into a field.
    • In a grid, any changes to a record that result in it being marked as modified.
    • The saving of a record in a grid prior to the entire collection being saved.
    • Any other action that causes modified data to be processed.
    Caution: 
    Selecting this option generates a large number of entries in the log and can negatively impact system performance.

    Otherwise, user component interaction data is not recorded.

  • To/From Source - When selected, information is included about data moving to and from the source or data binding for the component, including variables, properties, or the building of derived values.
    Caution: 
    Selecting this option generates a large number of entries in the log and can negatively impact system performance.

    Otherwise, this data is not recorded.

  • To/From Control - When selected, information is included about data moving to and from the control for the component.
    Caution: 
    Selecting this option generates a large number of entries in the log and can negatively impact system performance.

    Otherwise, this data is not recorded.

  • Dependent Notification - When selected, information is included about a component's dependent being refreshed because the value of the component changed.

    Otherwise, this data is not recorded.

IDO Collections settings The IDO Collections section includes these options: 
  • Initialization - When selected, information is included about the parameters passed to the IDO to retrieve the collection, the properties to include, and which components are bound to the collection.

    Otherwise, this data is not recorded.

  • Commands - When selected, information is included about commands and standard operations.

    Otherwise, this data is not recorded.

  • Update Overview - When selected, information is included an overview of the updating or saving of a collection.

    Otherwise, this data is not recorded.

  • Dependent Notification - When selected, information is included about notifications to dependents.

    Otherwise, this data is not recorded.

  • Load Overview - When selected, an overview of the process of loading the collection is included.

    Otherwise, this data is not recorded.

  • Update Values - When selected, data is recorded each time a the value of a property is updated in the collection, including individual requests from components or scripts as well as a record of each individual value sent during a collection update.
    Caution: 
    Selecting this option generates a large number of entries in the log and can negatively impact system performance.

    Otherwise, this data is not recorded.

  • Load Values - When selected, data is recorded each time a property's value is retrieved from the collection, including individual requests from components or scripts as well as a record of each individual value retrieved during a collection load.
    Caution: 
    Selecting this option generates a large number of entries in the log and can negatively impact system performance.

    Otherwise, this data is not recorded.

Interpreter settings The Interpreter section includes these options:
  • Overview - When selected, information is included about strings before and after they are interpreted.

    Otherwise, this data is not recorded.

  • Variables - When selected, information is included about the detailed substitutions of the V(), FV(), and FVN() keywords.

    Otherwise, this data is not recorded.

  • Properties - When selected, information is included about the detailed substitutions of the P() and FP() keywords.

    Otherwise, this data is not recorded.

  • Components - When selected, information is included about the detailed substitutions of the C() and FC() keywords.

    Otherwise, this data is not recorded.

  • Scripts - When selected, information is included about the detailed substitutions of the SCRIPTS keyword.

    Otherwise, this data is not recorded.

  • Others - When selected, information is included about the detailed substitutions of the CURDATE(), STRINGS(), and any other substitution keywords.

    Otherwise, this data is not recorded.