Knowledge Base

What does File | Save As EXE do?

Article: P2931

The File | Save As EXE menu item in ToolBook, Multimedia ToolBook, and Instructor adds an EXE header to the front of the ToolBook file. This header allows a book to be launched without first launching the ToolBook executable.

When a saved-as-EXE book is launched (not opened with File | Open), it first tries to find an ASYM.INI file:

For saved-as-EXE books prior to 6.0, an ASYM.INI file in the Windows directory will be used.

For 6.0 a saved-as-EXE book, the book will look for the ASYM.INI:

1. in the directory stored in the registry in HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\App Paths\TB60.EXE.

2. in the book's own directory.

3. in the Windows\asym\runtime directory.

4. in the Windows directory.

After and ASYM.INI has been found or not found, the saved-as-EXE book will attempt to launch the ToolBook authoring executables or runtime executables in this order.

1. If an ASYM.INI file was found, the book will look in directories specified [Registered Apps] section. It will look for an authoring entry first and then a runtime entry. The entry will depend on the version of ToolBook. For example, the 5.0 authoring entry is TB50= and the 5.0 runtime entry is TB50RUN=, the 3.0 authoring entry is TB30= and the 3.0 runtime entry is TB30RUN=, etc.

2. Next, the saved-as-EXE book will try to launch an authoring version of ToolBook matching its own version. It will search for the authoring version in its own directory then any directory in the Windows path.

3. Next, the saved-as-EXE book will try to launch a runtime version of ToolBook matching its own version. Again, it will search in its own directory and then any directory in the Windows path.

4. If the executables have not been found yet, the saved-as-EXE book will use the program associated with .TBK files in the [Extensions] section of the WIN.INI file. On the authoring machine, this is usually TBLOAD.EXE.

5. If an ASYM.INI file was found, the book will run an executable specified in [ToolBook Load Information] section. It will run whatever executable is listed in the version entry. The entry will depend on the version of ToolBook. For example, the 5.0 entry is TB50=, the 3.0 entry is TB30=, etc. The TB50RUN= and TB60RUN= entries are not used. They are for Neuron.

When a book checks a version specific line in the ASYM.INI (like TB40=) it will check whatever line matches the version of ToolBook that did the Save As EXE. For example, if a 4.0 book was Saved As EXE and then the book was opened and saved in 5.0, the book is now a 5.0 file but the executable header is still the 4.0 header and will look for version 4.0 lines in the INI file. A book should be Saved As EXE in whatever version of ToolBook it is ported to.

OPENSCRIPT NOTICE The OpenScript programming examples found in many articles may need modification in order to work in ToolBook 9.0 or higher, particularly if the article was written for an older version of ToolBook. To learn more, click here.

Provide Anonymous Feedback About This Article

Are you interested in providing feedback to SumTotal about this article? Yes