Tools3a
2.1
(c) Psion GmbH 1994

LICENSING CONDITIONS
All rights reserved.  Psion accepts no responsibility for any loss or damage caused by the direct or indirect use of this program.  The software remains the property of Psion GmbH.

No fee may be charged for this product, without the express permission of Psion GmbH.  If you copy this product, then you MUST copy all the files which are included in the original archive.

Psion GmbH
Saalburgstraße 157
D-61350 Bad Homburg

Tel: +49 6172 9654-0
Hotline: +49 6172 9654-28
Fax: +49 6172 39192
Mailbox: +49 6172 37090

Cix: mhoelscher
Internet: mhoelscher@uk.co.compulink.cix
Compuserve: 71333,2070

This program was written by Graham Tappenden
December 1993 - March 1994

INSTALLATION

To install TOOLS3a, copy the following files:
	TOOLS3A.APP	into	\APP\
	EXTRA21.OVL	into	\APP\

For English
	TOOLS01.RES	into	\APP\TOOLS3A\
	ASSOC01.INI	into	\APP\TOOLS3A\

For German
	TOOLS03.RES	into	\APP\TOOLS3A\
	ASSOC03.INI	into	\APP\TOOLS3A\

If you wish to use the Hex editor
	HEXEDIT.OVL	into	\APP\TOOLS3A\

If you wish to use the Database Tools
	DBFMAN.OVL	into	\APP\TOOLS3A\

RUNNING TOOLS3a FOR THE FIRST TIME

The first time that you run TOOLS3a, two windows appear.  These are, by default, the Internal Disk and Drive B:.  You will see later, that you can change what appears in these windows.

THE BASICS
TOOLS3a is a simple program to use.  The basic concept is this:  you have six windows available.  For each window you can specify:

		Which directory is displayed
		How this is sorted
		Where the window appears
		How tall the window is
		Which font is used (and therefore how wide the window is)

For each file, you can:
		Copy, Delete, Rename, Move
		Set attributes
		Start with an application (associate)
		Sort (DBF files only)
		Edit in Hex mode

You can:
		Create directories
		Remove directories
		Tag files for multiple-file operations
		Refresh all windows
		Display a directory tree

New for version 2.1:
		Change Drive
		Search for Files
		Disk Information

FILE OPERATIONS
COPY
1.	Move to the file you wish to copy.
2.	Select 'copy' from the menu.
3.	You may now choose a window to copy this file to.  If you wish to copy this file to somewhere else, then press ESC, and you can enter the full specification of the destination file.

MOVE
1.	Move to the file you wish to move.
2.	Select 'move' from the menu.
3.	You may now choose a window to move this file to.  If you wish to move this file to somewhere else, then press ESC, and you can enter the full specification of the new filename.

RENAME
1.	Move to the file you wish to rename.
2.	Select 'rename' from the menu.
3.	Enter the new name for this file.  If you change the directory name, then you actually move this file to the new directory.

DELETE
1.	Move to the file you wish to delete.
2.	Select 'delete' from the menu.
3.	You will be asked to confirm that this is the correct file to delete.

ATTRIBUTES
1.	Move to the file you wish to set the attributes of.
2.	Select 'Attribute' from the menu.
3.	You may now change the attributes of the file.
	(Read Only, Modified, Hidden, System).

TOOLS3a shows all files, regardless of whether or not they are Hidden.

TAG
1.	Move to the file you wish to tag.  Selecting 'Tag' toggles the tagging on this file.
	+ and - will set and cancel the Tag.
	* tags all files in the current window, / removes all tags in the current window.
2.	You can now select the operation you wish to perform: Copy, Move, or Delete.

Note: You can also tag files by pressing Shift-Up or Shift-Down.

DIRECTORY OPERATIONS

CREATE DIRECTORY
1.	Select 'Create Directory' from the menu.
2.	You can then edit the name of the directory displayed, to specify the name of the new directory.

REMOVE DIRECTORY
1.	Move to the directory to be removed.
2.	Select 'Remove Directory' from the menu.
3.	You must now confirm the name of the directory to remove.

Note: All files and sub-directories within this directory will be deleted.
FILE ASSOCIATIONS

Pressing RETURN whilst positioned on a directory enters this directory.  On a file, this starts the file with the associated application.

For example, if you are on a file .WRD, then the word processor will start with this file.

If you have your own applications, you can set up the association using the 'Associate' option on the menu.  You then need to supply the following data:

Extension	This is the extension to be associated, eg. PRN
Application	The name of the application file, eg. ROM::WORD.APP
Command	This is used by the system to assign the function keys, so use
			"Word", if you wish to be able to select this file with the Word key.
Alias			Used by Word for plain text files.  For plain text, set this to $
OPA			This is only needed if you write your own application files in OPL.

To run an OPA, you need to set the "Application" field to ROM::SYS$PRGO.IMG
and the name of your application must go in the "OPA" field with the FULL file
specification.
DISPLAY OPTIONS

SORTING
To sort the file list, select 'Sort' from the menu.
You may sort in Name, Extension, Size, or Date order, or leave the list unsorted.

ZOOMING
You may zoom the window in and out, in order to change the font size, and therefore the width of the window.

NEW WINDOW
You may use up to six windows simultaneously.  This option creates a new window.
You must specify the path which is to be used.
Note: To change the path in a window, press PSION-TAB.

MOVE WINDOW
You can move the window in all four directions using the cursor keys.  Pressing SHIFT moves the window faster.  In general, you cannot move completely off the screen, nor can you overlap with the status window.  Pressing ENTER confirms the new position.  Pressing ESC returns to the old position.

SIZE WINDOW
Using the up and down cursor keys, you can change the height of the window.  The width is fixed by the font used.  Again, pressing SHIFT moves faster, ENTER confirms, and ESC cancels.

CLOSE WINDOW
Here you can close one of your windows.

ZOOMING
Zooming changes the size of the font used, and therefore the width of the window.
Each window has its own font setting.
THE TOOLS
DBF TOOLS
DBF Tools allows you to sort your database files, and also to insert a field into a database file.
You should first be on a valid DBF file before you choose this option, and the file must be NOT be open by any other application (eg. Data).

You are given the following options:
					Insert Field
					Sort File

Using "Insert Field" you can insert a text field at a specified position.

Using "Sort File" you can sort the file based on the contents of one of its fields.

These routines are in principle the same as the example programs in the OPL handbook, but have been slightly modified for added functionality.

HEX EDITOR
The hex editor allows low-level access to the Psion File Structures.  You are shown your chosen file in both HEX and ASCII views.  Be default you are in 'Read-Only' mode, but by turning off the Protection you can also edit the contents of the file.

Using 'Address On' you can display the current address in the file.

You can search for a string, or jump to an address.  You may also open a different file if you wish.

REFRESH
This option will refresh the information in all of the windows.

DIRECTORY TREE
This option displays a tree diagram of the currently selected drive.  You can navigate up and down, and then press ESC to quit, or ENTER to select the new sub-directory.

CHANGE DRIVE
This options presents a dialog containing a list of the available drives, from which you may choose one.  The current window will then switch to this drive.

FILE SEARCH
File search requires you to enter the part of the filename you wish to search for (Wildcards are not allowed.  To search for FILE*.* type FILE).  You also need to specify where to look.

Current Path searches in the directory of the current window.

Current Drive searches in all directories of the drive in the current window.

Local Drives searches in all directories on LOC::A, LOC::B, LOC::M, etc.

All Drives searches in all directories on all available drives, eg. LOC::A, ..., REM::A, ...

DISK INFORMATION
Disk information provides details of the type of disk in use and how much space is available.

Pressing ESCAPE will return to the main program.  Pressing any other key will start a scan of the current disk.  This then reports the number of files on the disk with how much space they occupy.  From this it is possible to see how much space would be freed by formatting a flash using the formula:

		(Total Disk Space - Space Free) - Total Space Occupied by files

This report also shows how many of the files have their 'modified' bit set.  If the 'Backup' option in the System menu is used, or the -M parameter in MCLINK, then this will show the number of files which are not backed up.  A percentage is also shown.

TECHNICAL SUPPORT

If you have any problems using TOOLS3a, then Technical Support is available, using one of the methods outlined above.

To perform a 'reset' of TOOLS3a, you should delete the TOOLS3A.INI and ASSOC.INI files in the \TOOLS\ directory of your internal disk.

CREDITS

Tools3a had now progressed through various versions.  Apart from those at Psion GmbH who have supported its development, I would like to mention the following for their suggestions, help, or criticisms:

		Chris Lees (CompServe) was the first to spot the problem with CAPS LOCK in version 1.1.  Chris also requested the 'busy' message during the DBF sort.
		Christ Hennings (Cix) spotted that the Hex and DBF tools in 1.1 did not accept system messages.
		Robert Kirkbride (CompuServe) was the first to suggest Disk Information, and the file tagging (Michael Haas at Psion also nagged me on this point).
		David Williams (CompuServe) came up with several problems with version 1.1.
		Chris Parker (CompuServe) was the first to spot the problem with files without extensions.
		David Wood help in those moments of crisis, as well as providing the method to read and set file attributes.  He also helped find how to detect Flash, Ram, etc.