CHM Troubleshooting

Issues before you open the documentation CHM files:

Issues once you open the CHM files:

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 and while you may be able to view the contents list, all the pages report with a navigation error. 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. Click Start, click Run, type regedit, and then click 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, type MaxAllowedZone, and then press ENTER.
  4. Right-click the MaxAllowedZone value, click Modify,  and type a number from 0 and 4 (1 is the most likely one for you to enter) as per the table below, in the value data box, and and then click OK.
  5. Quit Registry Editor.

Note: On Windows 64-bit PCs, the sub key will have a slightly different registry location, as follows:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\HTMLHelp\1.x\ItssRestrictions.
Refer to http://support.microsoft.com/kb/896459 for further information on the 64-bit version of Registry Editor and the 32-bit version of Registry Editor.

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

MaxAllowedZoneLocal Machine zoneLocal intranet zoneTrusted sites zoneInternet zoneRestricted sites zone
0AllowedBlockedBlockedBlockedBlocked
1AllowedAllowedBlockedBlockedBlocked
2AllowedAllowedAllowedBlockedBlocked
3AllowedAllowedAllowedAllowedBlocked
4AllowedAllowedAllowedAllowedAllowed

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

Security warning when opening a downloaded CHM file

A Windows security update may prevent you from opening CHM files that you downloaded from the Internet, even if you saved them to your local hard disk. To resolve this problem, clear the "Always ask before opening this file" check box in the Open File-Security Warning dialog box, and then click Open. If you click Open without clearing the checkbox, the help file's table of contents will appear, but the body text will not. Alternatively, in Windows Explorer, right-click the file that you want to open, click Properties, and then click Unblock. See http://support.microsoft.com/kb/902225/ for more information.

Navigation to the Webpage was cancelled error

If you have recently updated Windows, your update will probably have contained security patches and while you may be able to view the contents list, all the pages report with a navigation error. Refer to Microsoft article http://support.microsoft.com/kb/896905 for the workaround or follow the steps below. These steps are an extract of the article.

To re-enable cross-frame navigation, follow these steps:

  1. Click Start, click Run, type regedit, and then click OK.
  2. Locate and then right-click the following registry subkey:
     
    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\HTMLHelp\1.x\HHRestrictions
     
    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 HHRestrictions, and then press ENTER.
       
  3. Right-click the HHRestrictions subkey, select New, and choose DWORD Value, type EnableFrameNavigationInSafeMode to name the registry entry, and then press ENTER.
  4. Right-click EnableFrameNavigationInSafeMode, click Modify, type 1 in the Value data box, and then click OK.
  5. Right-click the HHRestrictions subkey, select New, and then select the DWORD Value, type MaxAllowedZone, and then press ENTER.
  6. Right-click the MaxAllowedZone value, click Modify,  and type a number from 0 and 4 (1 is the most likely one for you to enter) as per the table above, in the value data box, and and then click OK.
  7. Quit Registry Editor.

Note: On Windows 64-bit PCs, the sub key will have a slightly different registry location, as follows:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\HTMLHelp\1.x\ItssRestrictions.
Refer to http://support.microsoft.com/kb/896459 for further information on the 64-bit version of Registry Editor and the 32-bit version of Registry Editor.

Another possible reason for this 'Navigation to the webpage was canceled' error is outlined in a LANSA Technical Note on Blocked Files. Although the technical note refers to Zip files, the same security block can occur when downloading CHM files. For more information, refer to the following Microsoft page regarding CHMs http://support.microsoft.com/kb/2021383

Consider that the dowloaded files might be blocked by the security policy your IT department put in place. To continue with the unblock, right click on CHM file and select Properties. Click "Unblock" button under "Advanced" in "General" tab. Hit "Apply". Once you unblock the file successfully, the unblock button disappears.

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?

Interner Explorer Script Error

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.

HTML Help Author 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:

Example of the 'no help' error
Back to Top