CHM Troubleshooting

Issues before you open the documentation CHM files:

• I can't properly view the CHM files on a server or CD
• Can't open a file from the LANSA Documentation Directory
• HH_GET_WIN_TYPE Message is displayed
• Title bar does not match the open Guide

Issues once you open the CHM files:

• The font is incorrect when I link to a new page
• Search results & Contents list aren't synchronised
• Search results & Guide Name doesn't match guide displayed
• Unnecessary Page found for Search
• DBCS and Bullets not Displaying Correctly
• Error when pressing the blue book icon in the LANSA Editor's help pane

I can't properly view the CHM files on a server or CD

If you have recently updated Windows, your update will probably have contained security patches. You can work around the security patch restrictions by changing your registry settings. Refer to this Microsoft article http://support.microsoft.com/kb/896054 for the workaround or follow the steps below. These steps are an extract of the article.

To modify the ItssRestrictions registry entry to enable a specific security zone, follow these steps:

1. From the Start button, select Run, and then type regedit in the Open entry box. Press OK.
2. Locate and select the following sub key:
    
   HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\HTMLHelp\1.x\ItssRestrictions
    
   If this registry sub key does not exist, create it using these two steps:
    
   1.  On the Edit menu, select New, and choose Key.
   2. Type ItssRestrictions, and then press Enter.
       
3. Right-click the ItssRestrictions subkey, select New, and then select the DWORD Value.
4. Type MaxAllowedZone, and then press Enter.
5. Right-click the MaxAllowedZone value, and then press Modify to open the Edit DWORD Value dialog box.
6. In the Value data box, type a number from 0 and 4 (1 is the most likely one for you to enter) as per the table below, and then press OK.
7. Quit Registry Editor.

The following table summarizes how different entries are interpreted by the MaxAllowedZone value:

Note: By default, the MaxAllowedZone value is set to zero.

Can't open a file from the LANSA Documentation Directory

Do you get this error message when you try to open a file from the Directory.chm?

This error is caused by an error in one of the recent Microsoft security patches.

After applying the patch, the registration of the HHCtrl.ocx file is broken. To fix this problem, enter the following commands in a command prompt window.

To do this:

1. Select Start, then the Run option
2. Type CMD into the Run dialog and press OK.
3. In the command prompt window, enter the following commands:
   
   regsvr32 /u c:/winnt/system32/hhctrl.ocx
regsvr32 c:/winnt/system32/hhctrl.ocx

HH_GET_WIN_TYPE Message is displayed

Unfortunately, there is no single solution to the following error message.

If you press the OK button twice, the guide you wish to view will open.

This message seems to be displayed randomly as you may find that the next time you open the same guide the message is not displayed.

You may find that this message is more prevalent when viewing the LANSA documentation from a server. In this case, copy the directory to your hard drive. (You will need at least some of the guides on your hard drive to use the Visual LANSA Context Sensitive help.)

You may also find the reverse is true and the solution may be to copy the LANSA Documentation directory to a server. (Some files will also need to remain on your hard drive to obtain the benefit of the Visual LANSA Context Sensitive help.)

Title bar does not match the open Guide

If the title bar is different to the guide that is opened, especially when you open it from the documentation directory, clear your Internet Explorer's cache folder. This should remove the problem. There is no need to reboot your PC.

Refer to The font is incorrect when I link to a new page for details of clearing the cache folder.

The font is incorrect when I link to a new page

If you see a font that is different to the standard documentation font, it will be default font set for your browser. You can reset the page by pressing the Refresh button in the toolbar, however, this problem is generally an indicator that your Internet Explorer browser's cache is full.

To clear the cache (based on IE V6.0):

1. Open the browser window
2. From the Tools menu, select Internet Options.
3. Select the General tab and in the Temporary Internet Files section, click Delete Files.

Now re-try your LANSA guide's linked page display.

Search results & Contents list aren't synchronised

Normally, when you select a topic to view from the Search results, you can select the Contents tab to see just where the topic is in the relevant guide.

To ensure that the topic is displayed in the Contents list, simply double click on the topic you have selected in the Search tab (instead of the single click which will only display the topic).

Search results & Guide Name doesn't match guide displayed

Normally, when a topic is displayed in the Search results, the guide in which the topic exists is displayed.

If this guide name is consistently incorrect, that is, the last one you looked at it constantly displayed, clearing your browser's cache folder will fix the problem. Refer to The font is incorrect when I link to a new page for details of clearing the cache.

Unnecessary Page found for Search

If you find that a page has been selected when you carry out a search and there is no text highlighted on the page, it is because there is print-only text on the page that matches your search selector.

For example, on each cover page there is a list of the guide's contents that can be seen only when the guide is printed. (This contents list has no page number or hyperlinks, simply paragraph numbers to enable you to find the relative topics.)

DBCS and Bullets not Displaying Correctly

There is no complete solution to this problem of bullets being displayed as other types of characters. To improve your viewing, we suggest that you go to Internet Explorer and change the Encoding option to Auto Select. The Encoding option is on Internet Explorer's View menu.

Error when pressing the blue book icon in the LANSA Editor's help pane

In general, when you press the blue book icon from the help pane in the LANSA Editor, the online guide belonging to the help text that you currently have displayed is opened.

If there is 'no help' displayed, then LANSA cannot find the online guide to display and an error message will result. The 'no help' might be confusing, as the help text pane contains the name of the object for which you want help. This name, plus your description but without any help text, is displayed when it is one of your objects – not a LANSA supplied object. An example of this 'no help' follows: