Chapter 5 - Manager Main Menu

Diag Function

Using the Manager Diagnostics Functions

Clicking the Diagnostics button on the Main Menu will bring up the diagnostics subfunctions in a pop-up menu and allow the user to perform the diagnostic subfunctions listed below:

Run Diagnostics
Check Branches
Unreachable Questions
Analyze Keyword Use
Analyze Question Text
Browse Rich Text Records
Compare Records
Compare Questions

To chose Diagnostic subfunction left-click on the subfunction in the menu.

 

Run Diagnostics

When this function is selected the "Run Diagnostics" window will appear. It contains all of the diagnostic functions the Manager performs. Individual or multiple function may be selected from the list.

To select a diagnostic function,

  • Highlight it.
 

To select multiple functions in blocks, use

  • <Shift> + Click.

To select multiple non-contiguous functions, use

All diagnostics will be executed if none are selected.

To execute the selection(s), press the Run Selected Diagnostics button.

 

Diagnostic Results Tab

To view the results of the diagnostics chosen, press the Diagnostics Results tab. This figure below displays the results of all possible diagnostics run on a table.

The results of the most recent diagnostic run should appear, but if the screen is blank, press the Display Last Results button.

The questions Name and the Error Code are displayed. The results may be printed, by pressing the Create Report button.

When the Create Report button is pressed the standard Report Generator dialogue box will be displayed. Choose the HTML tab. The destination path and file name may be changed in the Output File field of the dialogue box. The dialogue box will default to the directory specified in Setup tab, Preferences button, Output Dir with default file name DiagErrors.HTML.

 

Check Branches

When this function is chosen the following window appears. The question names of the current instrument appear in the left column of the box on the left and the text of the question appears in the column to the right. When a question name is selected, it branches appear on the right. The Default Next question will always appear, the Conditional Branches will appear, if applicable.

When the Print List button is pressed the standard Report Generator dialogue box will be displayed. Choose the HTML tab. The destination path and file name may be changed in the Output File field of the dialogue box. The dialogue box will default to the directory specified in Setup tab, Preferences button, Output Dir with default file name Branches.HTML.

  

Unreachable Questions

When the diagnostic subfunction Unreachable Question is selected, the Manager brings up a window that displays the question names of all the unreachable questions. An 'unreachable question' is by definition one that has no previous question leading to it and, therefore, is outside the logic of the question chain. By default the first question in a module will always appear because it has no previous question leading to it.

Double-clicking on a question name in the window will open the Design function Questionnaire subfunction to that question and the user may review its logical chain.

When the Print button is pressed the standard Report Generator dialogue box will be displayed and the user may choose between the two active report formats (HTML and Text) and edit some of the print option. The print report will be simply a list of the question names displayed in the window.

Analyze KeyWord Use

When this button is pressed it brings up the Analyze Keywords window. This function lists the question names of Keyword Codes and Calendar Functions and makes a twofold analysis available.

If the Unknown Keys button is pressed, the window displays the Question Names of the unknown keyword used. A message to that effect appears in the box at the lower left with the total.

Double clicking on one of the particular question names will bring up the full question record in edit mode. (Design function, Questionnaire subfunction.)

A second type of analysis is available by first choosing one of the radio buttons: either Keyword Keys or Calendar Keys.

Then select one of the Keyword or Calendar terms by highlighting it. If there are questions in the current instrument's module that use the selected keyword, the question names will be displayed in the box on the right.

Double clicking on one of the particular question names will bring up the full question record in edit mode.

The Print List button is inoperable for this function.

 

Analyze Question Text

When this function is selected a window similar to "Analyze Question Text" will appear. It will be blank and the user must first make a few selections to view data similar to that shown in the figure below.

First select the type(s) of desired reports to display from the check boxes:

  • Correct References;
  • Warning messages;
  • Question names; and
  • Error Messages.
  • Then select the action to carry out the analysis by pressing on of the following buttons:

  • Analyze Text;
  • Print List; or
  • Save as Text.
  • When the Analyze Text button is pressed, a dialogue box will appear asking the user "Do you wish to log references to symbols not in the Symbols List." Respond Yes or No.

    Depending on the analyses selected and the size of the database, processing may take some time. Messages pertaining to the progress of the analysis and preparation of results will appear in a box at the bottom of the screen. Results will be displayed in a window shown in the accompanying figure. Results may be printed or saved as text in a file to be specified by the user.

    When the Print List button is pressed the standard Report Generator dialogue box will be displayed. Choose the HTML tab. The destination path and file name may be changed in the Output File field of the dialogue box. The dialogue box will default to the directory specified in Setup tab, Preferences button, Output Dir with default file name TextAnalysis.HTML.

      

    Browse RTF records

    When the Browse RTF records subfunction is selected the window shown below entitled "Browse Alternate Language Text" will open. To work more efficiently with this window maximize it so that the Name and Text fields and buttons across the bottom are more clearly visible. No Names or Text will appear in the left box until one of the alternate languages is specified. Use the command menu Edit/Find/Language to specify one of the alternate languages.

    When a language is specified, the left box will display the Names, an arcane form of the Text, and in the lower half the actual alternate language text of the currently selected (). The arcane Text is the actual code of the rich text format. If no names appear in the Name field, then this means no records exist for that language and only the placeholder of the first record in the file will be displayed, its arcane Text, and the text of first record of the principal language will be repeated in the lower half.

    When no Alternate Language text files have been created for that language they must first be created by using the Design subfunction RTF Question Text.

    This subfunction may be used to browse the records of the main language table and one alternate language table in a linked manner and edit the text of the records. Records may be deleted in the alternate language table, as well as, orphaned records in (both) __?? table(s).
    Delete Orphan RecordAfter displaying an "Are you Sure...?" message, deletes all records that have no corresponding record name in either __?? table.
    Add RecordRun-time error, Manager bombs.
    Updatewith no user interface this button updates __??
    Delete RecordDeletes the currently selected record () in the Alternate Language table. There is no way to "undo" this action except to re-create the record using the Design subfunction RTF Question Text.
    LinkCreates a link between the corresponding records in the two tables so that by clicking on one question name, the currently selected record indicator () selects the same record in both tables. __?? but the highlight doesn't move in the main language table (if highlighted)!!!__??

     

    Compare Records

    This function hangs in that the hour-glass cursor appears and never goes away.
    Typing in the full path makes no difference.
    The only way to stop the action is to use the End Task operation in Windows (<Ctrl> + <Alt> + <Del>).

      

    Compare Questions

    Choose Instrument and Module press the View button and the columns are filled with question names.

    How does one differentiate between the Primay and Secondary columns. If the currently selected module is used, both columns get filled with the same question names. Upon Compare All a third checkbox column appears with X's.

     

    Next Steps

    Correct the diagnostic errors by re-editing the questions. Go to the Design function, Questionnaire subfunction.

    If there are no errors, setup the Survey program and transfer the records to the Survey program and run the Survey. To transfer the records, see DataXfer function, Export Field Files & Patches.