IDC Sampler 1.0
IDC Version 1.36
December 1993

K Tait, Computer Based Learning Unit, The University, Leeds LS2 9JT, UK
Email: ken@uk.ac.leeds.cbl, ken@cbl.leeds.ac.uk
Tel:   +44 532 334628   Fax: +44 532 334635
------------------------------------------------------------------------

This document contains a brief description of the contents of the IDC
Sampler, how to install it.

Files (with some restrictions that are specifically mentioned) may be
placed in any directory.  It does not give complete information nor
does it describe every method of doing something. Those who are
familiar with Windows and Toolbook may wish to proceed differently.
More information on IDC will be found in the document SAMPLER.WRI.

------------------------------------------------------------------------

List of Files
-------------

IDC Sampler
[Packed as SAMPLER.ZIP using PKZIP 2.04g]

	COMM136.TBK	Common handlers for all interctive documents
	EXAMPLE.TBK	An interactive document used by SAMPLER.TBK
	IDC136.ICO	Icon for IDC
	IDC_136.TBK	Interactive Document Compiler (Sampler 1.0)
	RESOURCE.IDX	Resource Index for Sampler 1.0
	SAMPLER.IDC	Source Document for SAMPLER.TBK
	SAMPLER.INF	Information File for SAMPLER.TBK
	SAMPLER.OPT	Options for Sampler 1.0
	SAMPLER.TBK	Sampler 1.0
	SAMPLER.WRI	More detailed information on IDC
	SYS136.TBK	System Book for all IDCs

Working Files (see SAMPLER.WRI)
[Packed as WORKING.ZIP using PKZIP 2.04g]

	AMPHET.BMP	Structure of amphetamine
	BUTTONS.TBK	Buttons format (alternative to Menu format)
	CANALGD2.BMP	Canal Gardens, Leeds
	CWCCH.BMP	Clothworkers Concert Hall
	GBSMALL.BMP	Map of Great Britain
	GH16.BMP	Great Hall (16 colours)
	GH256.BMP	Great Hall (256 colours)
	ILKLEYMR.BMP	Walkers on Ilkley Moor
	TOWNHALL.BMP	Leeds Town Hall
	VELTIME.BMP	Velocity-time graph
	WHARFDLE.BMP	Wharfedale, Yorkshire
	YOURS.IDC	A copy of SAMPLER.IDC for you to work with

Pharmacology MCQ Bank (Fragment)
[Packed as PHARM.ZIP using PKZIP 2.04g]

	A1.IDC		Source file for Biotransformations (Easy) *
	A1.TBK		Interactive document for Biotransformations (Easy)
	A2.IDC		Source file for Biotransformations (Average) *
	A2.TBK		Interactive document for Biotransformations (Average)
	A3.IDC		Source file for Biotransformations (Hard) *
	A3.TBK		Interactive document for Biotransformations (Hard)
	HELP.TBK	Help document for MCQs
	MCQ.IDX		Resource Index for MENU.IDC *
	MENU.IDC	Source file for Menu *
	MENU.INF	Information file for Pharmacology MCQ Bank
	MENU.TBK	Document which controls access to the Bank
	MHELP.TBK	Help document for Bank

Files marked with * are included to provide extra information about the
Pharmacology MCQ Bank.  It is not possible to make any direct use of
them using the Sampler Kit.

This file (README.TXT) is included in the kit but is not packed with
any of the above sets.

--- NOTE ---------------------------------------------------------------
The Sampler and the Pharamcology MCQ Bank require the Toolbook Run-time
system which consists of the following files:

	tbook.exe 
	tbkbase.dll
	tbkcomp.dll
	tbkutil.dll
	tbkfile.dll
	tbkwin.dll
	tbknet.exe	*

The one marked * is only necessary if you using a network.
------------------------------------------------------------------------


Installing the Sampler
----------------------

It is assumed that TBOOK.EXE and its components are in a directory
which is mentioned in the PATH environment variable.

Copy the files to one or more directories of your choice.  Files can
reside in whatever directories you wish. However there are some files
which must be kept together.  These are:

	COMM136.TBK with SAMPLER.TBK

and

	SYS136.TBK with IDC_136.TBK

Create a new program item in a program group of your choice and complete
the dialogue as follows:

	Description:	IDC Sampler 1.0
	Command Line:	TBOOK path\SAMPLER.TBK
	Working directory: anything

where 'path' gives the full path of SAMPLER.TBK and the working
directory should be on a disk for which you have write access to the
root directory.  If there is no disk that meets this criterion then add
the following line to SAMPLER.INF before the line 'end'.

	datapath=pathname

where pathname is the path of a directory to which you do have write
access.

If the filetype TBK is associated with TBOOK.EXE then TBOOK may be
omitted from the command line.

If you would like to use the icon provided then click on Change Icon and
browse till you find the file IDC136.ICO then exit from the dialogue
boxes by clicking OK.

Make sure SAMPLER.TBK and a copy of COMM136.TBK are in the same
directory.

--- ** NETWORK ** ------------------------------------------------------
If you are installing the IDC Sampler on a network drive then it is
important that any files which may be shared should be set to READ-ONLY.
In particular this applies to COMM136.TBK which is used several times
even if you are the only user working with SAMPLER.TBK.
------------------------------------------------------------------------

The Information File SAMPLER.INF must be edited to reflect the
organisation of your system (use Notepad or a nother text editor).

This is the file as supplied:

	Information file for IDC Sampler
	sampler:=c:\ken\idc\sampler
	example:=c:\ken\idc\sampler
	windows:=c:\windows
	toolbook:=c:\toolbook
	end

Change line 3 so that right hand side of the equals has the path to
the file EXAMPLE.TBK.

Change line 4 so that right hand side of the equals has the path to
the file WINHELP.HLP.

Change line 5 so that right hand side of the equals has the path to
the file PAGES.TBK.  This file is supplied with Toolbook and is normally
found in the same directory as TOOLBOOK.EXE and TBOOK.EXE.  (If this is
not the case then the link from SAMPLER.TBK to PAGES.TBK may prove
problematic and can only be fixed by editing RESOURCE.IDX and
recompiling SAMPLER.TBK -- this procedure is described in SAMPLER.WRI.)

Change line 6 so that right hand side of the equals gives a path which
is valid on your system and to which you have write access.

Open the Sampler by double clicking its icon.  Using SAMPLER.TBK is
quite straightforward, but more information about using interactive
documents is given in SAMPLER.WRI.

--- WARNING ------------------------------------------------------------
Errors in the information file may lead to run-time errors and even the
possibility that the intereactive document may not function correctly.
The normal way to leave Toolbook in such circumstances would be to type
control-X.  In any interactive document produced with IDC this is
password protected to ensure that the normal exit route is taken and
datafiles are correctly updated.  The request for the password occurs
after control-X is typed and the password for SAMPLER.TBK is please.

It is possible to change the password for a particular interactive
document.  The procedure is described in SAMPLER.WRI.
--- NOTE ---------------------------------------------------------------
The IDC and interactive documents supplied in this sampler are designed
for a VGA screen.  If your screen is VGA then the pages will completely
fill the screen.  If your screen has a resolution which is greater than
VGA then the page will be centred on your screen.  If it has a lower
resolution that VGA then an error message will be generated.  This last
case has not been tested.  It is possible to create interactive
documents with pages which are either VGA size or SVGA size.
------------------------------------------------------------------------

Installing the Compiler
-----------------------

This will allow you to re-compile the Sampler or compile a source
document of your own. (Ways of doing these are outlined in the document
SAMPLER.WRI in the section SOME THINGS TO TRY.

It is assumed that TOOLBOOK.EXE and all its components are in a
directory mentioned in the PATH environment variable.

Create a new program item in a program group of your choice and complete
the dialogue as follows:

	Description:	IDC 1.36
	Command Line:	TOOLBOOK path\IDC_136.TBK

	Working directory: annything

where 'path' gives the full path of IDC_136.TBK and the working
directory should be on a disk for which you have write access to the
root directory.

If you would like to use the icon provided then click on Change Icon and
browse till you find the file IDC136.ICO then exit from the dialogue
boxes by clicking OK.

Make sure IDC_136.TBK and SYS136.TBK are in the same directory.

Open the Compiler by double clicking its icon.

In the file SAMPLER.WRI in the section headed SOME THINGS TO TRY there
is a detailed step-by-step guide to using the compiler.

--- NOTE ---------------------------------------------------------------
It is recommended that the compiler is run from a local disk -- NOT a
network disk.  Although this is possible it should keep things simpler.
------------------------------------------------------------------------

Installing the Pharmacology MCQ Bank
------------------------------------

Only a fragment of the Pharmacology MCQ Bank is supplied.  In the full
bank contains some 1500 questions in 22 topics.  These questions have
been collected over more than ten years.  The system supplied with this
sampler has been in use since the beginnng of October 1993.

It is assumed that TBOOK.EXE and its components are in a directory
which is mentioned in the PATH environment variable.

Copy the files to a directory of your choice.  (At Leeds the bank
resides in two directories but for simplicity only one need be used for
this fragment.)

Modify the text files MENU.INF using NotePad or another text editor.

The file as supplied looks like:

	Information File for Pharmacology MCQ Bank
	content:=c:\ken\idc\sampler
	control:=c:\ken\idc\sampler
	datapath=c:\ken
	recordfile=pharm93.srf
	scores=tright,twrong,tdontknow
	weights=1,-1,0
	bookmarks=none
	end

--- NOTE ---------------------------------------------------------------
Those variables (names to the left of the equals) which have colons at
the end of their names (for example, sampler:) must always be given file
paths as values.  Other variables (there is only datapath) in this case
may have any string as a value.  In this particular case datapath is
assigned a file path as a value.
------------------------------------------------------------------------

It is only necessary to change lines 2, 3  and 4.  Lines 2 and 3 should
be changed so that (in each case) the part to the right of the equals
gives the directory into which you have copied the bank.  Line 4 should
be changed so that the path given to the right of the equals is valid on
your system.  (This is the directory used to store performance records.)

Create a new program item in a program group of your choice and complete
the dialogue as follows:

	Description:	Pharmacology MCQ Bank
	Command Line:	TBOOK path\MENU.INF

where path gives the full path of MENU.TBK.  If .TBK is associated with
TBOOK.EXE then TBOOK may be omitted from the Command Line.

If you would like to use the icon provided then click on Change Icon and
browse till you find the file IDC136.ICO then exit from the dialogue
boxes by clicking OK.

Copy COMM136.TBK to the directory containing the Pharmacology MCQ Bank.

Open the Pharmacology MCQ Bank by double clicking its icon.

--- ** WARNING ** ------------------------------------------------------
As most of the Pharmacology MCQ Bank is not supplied.  Only the FIRST
option on the main menu will work.  Further information about the bank
can be obtained from Ian Hughes, Department of Pharmacology, The
University, Leeds LS2 9JT, UK.  Tel: +44 532 334313
------------------------------------------------------------------------

Final Remark
------------

This Sampler (version 1.0) is the first to be distributed.  This
sampler is free and may be distributed to anyone who is interested
provided that the complete kit is passed on

It is inevitable that there are bugs in the system which I have not
detected and aspects of the functionality that are unsatisfatory as
well as errors in the documentation.  Please let me know of anything
that will help me make the next distribution better.

Ken Tait 22nd December 1993

========================================================================


