Copyright: Copyright 1996 TommySoftware®


TommySoftware® Cloaking Device

Information

What does the Cloaking Device do?

Registration

Technical Support & Information

Conventions in This Reference

System Requirements

The Cloaking Device Window

Using TSZIP and TSUNZIP in batch files

Commands

 Encode Text in Clipboard

 Decode Data from Clipboard

 Encode File

 Decode File

 Compress Files

 Extract Files

 Options

North America, Inc.	Germany

648 Ashbury Street	Selchower Straße 32

San Francisco, CA 94117	D-12049 Berlin

U. S. A.	Germany

Phone 1-800-275-9406	Phone +49 30 621 5931

Phone (415) 522 0612

Fax (415) 522 0287	Fax +49 30 621 4064

CompuServe GO TOSOENG	CompuServe GO TOSOGER

Internet

sales@tommysoftware.com	(Sales)

support@tommysoftware.com	(Technical Support)

http://www.tommysoftware.com	(World Wide Web)

TommySoftware® Cloaking Device - Version 1.10e - Copyright 1996 TommySoftware®


What does the Cloaking Device do?
What does the Cloaking Device do? (Information)

TommySoftware® Cloaking Device is an easy to use but yet efficient Internet tool for everyone who sends e-mails or files across the Internet or other e-mail services:

-	The Cloaking Device encrypts and decrypts your e-mails "on the fly". This procedure is independent from the Web browser or e-mail editor you use and it's also independent from your Internet service provider. So the Cloaking Device enables you to exchange secured e-mails with your friends, colleagues, and customers right away no matter whether they have the same Internet service provider or use the same software.

-	The encryption technology which is used by the Coaking Device is based on an industry standard allowing you to use passwords with up to 63 characters. This makes it virtually impossible to crack an encrypted e-mail. Therefore it's also impossible to change the content of an encrypted e-mail.

-	All e-mails processed with the Cloaking Device are automatically compressed. So using the Cloaking Device not only improves safety but also speeds up your e-mail transfer across the Internet.

-	A new encoding and decoding procedure automatically retains all special characters (e.g. à, á, â, ã, ä, æ) contained in your e-mail.

-	You can also use the Cloaking Device to convert any type of binary file, e.g. executable files (*.EXE) or documents (*.DOC), to one or several text files which then can be sent across the Internet as standard e-mail. Of course this process includes the (optional) encryption and compression of all data. The receiver of such an e-mail then uses the Cloaking Device to restore the original binary file.

-	In addition to its Internet features the Cloaking Device allows you to compress and extract files using the standard ZIP format. This enables you to read ZIP files created by utilities also using the standard ZIP format. You can compress single files and complete directories. Long file names and encryption are also supported.

-	Optionally you can use the two 32-bit console applications TommySoftware® TSZIP and TommySoftware® TSUNZIP which are used by the Cloaking Device to do the compression and extraction in separate batch file operations.


Registration
Registration (Information)

Unless this application is registered, all operations are carried out using the fixed password »cloaking«. To be able to change the password you have to be a registered customer. Please remember that everybody who also has a TommySoftware® CloakingDevice can decode your email until you are able to change the password!

During registration, you will receive a user name and a registration code. The user name you receive from TommySoftware® or one of its partners has either to be your real name or your email address. If this is not the case, please contact: preventfraud@tommysoftware.com !

The registration fee for TommySoftware® Cloaking Device is $49.95 for two licences (2 for one!). Registration is available via the following ways:

Via E-Mail

Select the Register command from the main window's system menu. In the appearing dialog window, enter your desired user name and press the first button. A form will appear that allows you to enter your personal data. After completing this form, a text is copied into the Clipboard that you can paste into your e-mail editor. Send the e-mail to sales@tommysoftware.com .

Via the World Wide Web in the Internet

Visit our secured website at http://www.tommysoftware.com .

Via Phone

If you prefer to register over the phone (1-800-275 9406, 415-522 0612) you will be charged an additional $10 handling fee.

From a TommySoftware® Partner

Australia:

Country Orders only 	1-800-803-704

Brightspark Computers	Phone (Orders)	09-375-1178

Unit 7, 11-13 Marchant Way	Fax 	09-375-1668

Morley WA 6062	Compuserve	100033,1124

Australia	Internet	bspark@iinet.com.au

or	WWW	http://www.iinet.com.au/~bspark

PO Box 253	http://www.tommysoftware.com

Morley WA 6943

Australia

Austria:

Husco Austria

z.Hd. Herrn Hussein	Telefon	(1) 505 4311-11

Bösendorferstraße 4	Telefax	(1) 505 9406-21

A-1010 Wien	WWW	http://www.tommysoftware.com

Österreich

Belgium:

Trax Computer Applications	Phone	050/20.07.35

Steenstraat 61	Fax	050/20.07.35

8211 Zedelgem	CompuServe	100031,3552

Belgium	Internet	100031.3552@compuserve.com

WWW	http://www.tommysoftware.com

Czech Republic:

JIMAZ s.r.o.	Telefon	(02) 379 498

Hermanova 37	Fax	(02) 378 103

17000 Praha 7	BBS	(02) 312 19 19

Ceska Republika	Internet	jimaz@jimaz.cz

WWW	http://www.tommysoftware.com

Denmark:

Phone	5361 9042, mo-fr 10h-16h

Pro Soft	Fax	5361 9391

Benloese Skel 4 G	BBS	5767 1747 (28.800,N,8,1)

DK-4100 Ringsted	CompuServe	100065,1744

Denmark	Internet	100065.1744@compuserve.com

WWW	http://www.tommysoftware.com

Germany:

TommySoftware®	Telefon	030 / 621 5931

Abt. Verkauf PVK	Telefax	030 / 621 4064

Selchower Straße 32	Email (Internet)	sales@tommysoftware.com

D-12049 Berlin	WWW	http://www.tommysoftware.com

Deutschland

Great Britain:

The Thompson Partnership

Lion Buildings	Phone	01889-564601

Market Place	Telefax	01889-563219

UTTOXETER	CompuServe	70007,5560

Staffs, ST14 8HZ	Internet	sales@ttp.co.uk

England	WWW	http://www.tommysoftware.com

Japan:

Personal Data Factory	Phone	0270-21-1423

Shimoueki-cho 451-3	Fax	2070-26-1636

Isesaki-shi	Nifty-Serve	HFD00021

Gunma-ken 372	CompuServe	101153,21

Japan	Internet	101153.21@compuserve.com

WWW	http://www.tommysoftware.com

Netherlands:

CopyCats Software & Services	Tel / Fax	072-5745993

Postbus 1088	CompuServe	100121,1562

1700 BB Heerhugowaard	Internet	100121.1562@compuserve.com

Nederland	WWW	http://www.tommysoftware.com

Postbank	rek. 43.28.577

New Zealand:

Micro-South Computers	Phone	(03) 365 1309

c/o Bytes & Nibbles Shareware	Telefax	(03) 365 1309

PO Box 32-143	CompuServe	100355,3120

Christchurch	Internet	100355.3120@compuserve.com

New Zealand	WWW	http://www.tommysoftware.com

Sweden:

Megatec	Telephone	0503-40330

Kålabråtsvägen 14	Telefax	0503-40033

S-54492 Hjo	WWW	http://www.tommysoftware.com

Switzerland / Liechtenstein:

Software News!	Phone	(01) 814 31 40

Flurstraße 57	Fax	(01) 814 31 40

CH-8302 Kloten	CompuServe	100042,1105

Schwitzerland	Internet	softnews@semafor.ch

WWW	http://www.tommysoftware.com

United States of America:

Toll-Free Phone 	1-800-275-9406

TommySoftware®, N.A., Inc.	Phone	(415) 522 0612

648 Ashbury Street	Fax 	(415) 522 0287

San Francisco, CA 94117	Internet	sales@tommysoftware.com

U. S. A.	WWW	http://www.tommysoftware.com

When purchasing the Cloaking Device from a TommySoftware® Partner, the prices may vary.


Technical Support & Information
Support & Information (Information)

For technical support please send an e-mail to "support@tommysoftware.com". If you have any other questions please send your e-mail to "sales@tommysoftware.com".

On our World Wide Web site (http://www.tommysoftware.com) and in our CompuServe library you can find the latest program versions and upgrades, additional documentation, utilities, and current information on our products. And please also try out our special Web offers. Don't miss this opportunity to make the most of the Internet!


Conventions in This Reference
Conventions in This Reference (Information)

The following conventions are used throughout the reference:

Very important: You should really read this!

Note

Tips & Tricks

Click	The word click by itself means click the left mouse button once (sometimes also called left-click). Otherwise we say right-click, or double-click.

SHIFT	This means the Shift key.

KEY1+KEY2	This means press KEY1 and KEY2 at the same time. For example, ALT+TAB means hold down the ALT key while you press the TAB key.

x+100+2/3	User input, e.g. text in edit controls.

Italic	Strengthening of single words or phrases.

CLOAKING.TXT	File name.

"Options"	When referring to elements in dialog boxes the element names are displayed in quotation marks (e.g. "Options" button).

System>Always On Top	This means the command "Always On Top" in the system menu of TommySoftware® Cloaking Device.

Registration	Underlined, colored text marks a jump to another topic. By left-clicking the underlined text the corresponding topic is displayed. To return to the previous topic apply the "Back" button.

If a dialog box is shown in a topic, you can get information on the dialog's elements (e.g. buttons, lists etc.) by left-clicking the relevant part of the picture, see How can I access information on this dialog?


System Requirements
System Requirements (Information)

TommySoftware® Cloaking Device requires at least the following:

- Intel 80386 processor

- Microsoft Windows 95 or Windows NT 3.51 or higher

- The file system must support long filenames

- 8 MB RAM available to Windows (not including swap file)

- Graphics card and monitor capable of displaying 640×480 pixels and 16 colors.

- Mouse or other pointing device.


The Cloaking Device Window
The Cloaking Device Window (Information)

The main window of TommySoftware® Cloaking Device contains six button that provide fast access to the most frequently used commands. In addition, the system menu of the window contains some less often used commands.

The position of the TommySoftware® Cloaking Device window is stored permanently, i.e. it will be restored after terminating and restarting the application.

The windows can either be a topmost window, i.e. lie above all "normal" windows, or it can lie within the normal window order. This option can be toggled using the Always on Top command in the window's system menu. This setting will also be stored permanently.


Using TSZIP and TSUNZIP in batch files
Using TSZIP and TSUNZIP in batch files (Information)

TommySoftware® Cloaking Device installs the tools TSZIP.EXE and TSUNZIP.EXE on your machine. These are small 32-bit console applications used for compression and extraction of files in standard ZIP format. They can e.g. be used inside batch files to allow non-monitored backups.

For details on these two applications, open the console window, set the current path to the directory of TommySoftware® Cloaking Device and type TSZIP or TSUNZIP, respectively. Both applications will display a short description of their parameters.

If you plan to permanently use the tools, it might be a good idea to copy them to the SYSTEM or SYSTEM32 subdirectory of your windows system in order to provide fast access to them. Alternatively, you may inlcude the location of the TommySoftware® Cloaking Device in your PATH variable.

Please notice that both TSZIP and TSUNZIP are part of the TommySoftware® Cloaking Device package and may not be passed on separately! The TommySoftware® Cloaking Device licence agreement is valid for them as well.


Encode Text in Clipboard
Encode Text in Clipboard (Commands)

 Using this button, the text currently contained in the Clipboard is encoded.

The resulting Cloaking Device data is either placed in the Clipboard (replacing the original text) or saved to a file. This depends on whether the "Copy Encoded Data to Clipboard" option is active or not.

In the latter case, a file selection dialog appears in which you can enter the destination file name. If the "Multiple Files" option is active, more than one file may be produced if the text in Clipboard is large enough. The files created will then have a running number in brackets appended to the destination file name entered.

The button is only active if a text is contained in the Clipboard. You cannot use this command to encode anything else than text!

Related Options:

Clipboard Options


Decode Data from Clipboard
Decode Data from Clipboard (Commands)

 Using this button, the Cloaking Device data currently contained in the Clipboard is decoded.

If the Cloaking Device data in the Clipboard contains a text, this text will be copied to the Clipboard (replacing the original Cloaking Device data).

If the Clipboard contains an encoded binary file, a file selection appears in which you can enter the destination file name. If the original file name was included in the Cloaking Device data, the file selection dialog will default to that file name.

The button is only active if valid Cloaking Device data is contained in the Clipboard.

Related Options:

Clipboard Options


Encode File
Encode File (Commands)

 Using this button, a binary file is encoded.

After choosing this command, a file selection dialogs appears in which you can select the binary file to be encoded.

The resulting Cloaking Device data is either placed in the clipboard or saved to a file. This depends on whether the "Copy Encoded Data to Clipboard" option is active or not.

In the latter case, a file selection dialog appears, in which you can enter the destination file name. If the "Multiple Files" option is active, more than one file may be produced if the selected binary file is large enough. The files created will then have a running number in brackets appended to the destination file name entered.

Related Options:

File Options


Decode File
Decode File (Commands)

 Using this button, Cloaking Device data from one or multiple files is decoded.

After choosing this command, a file selection dialogs appears in which you can select the file that contains the Cloaking Device data to be decoded. If the "Multiple Files" option was active when creating the file, more than one file with a running number in brackets may be available. In this case, select the first file having the number 1.

If the Cloaking Device data in the files contains a text, this text will be copied to the Clipboard.

If the files contain an encoded binary file, a file selection appears in which you can enter the destination file name. If the original file name was included in the Cloaking Device data, the file selection dialog will default to that file name.

Related Options:

File Options


Compress Files
Compress Files (Commands)

 Using this button, files can be compressed into a ZIP archive.

The ZIP archive created is compatible with the standard ZIP format used by most compression / extraction tools.

How can I access information on this dialog?

Related Options:

Compress Options


Extract Files
Extract Files (Commands)

 Using this button, files can be extracted from a ZIP archive.

The ZIP archive required must be compatible with the standard ZIP format used by most compression / extraction tools.

How can I access information on this dialog?

Related Options:

Extract Options


Options
Options (Commands)

 Using this button, an "Options" can be accessed that offers several options for the Cloaking Device commands.

The dialog contains the following tabs:

Clipboard

File

Compress

Extract

All options are stored permanently, i.e. they will be maintained even after exiting and restarting the application.


Clipboard Options
Clipboard (Options)

How can I access information on this dialog?


File Options
File (Options)

How can I access information on this dialog?


Compress Options
Compress (Options)

How can I access information on this dialog?


Extract Options
Extract (Options)

How can I access information on this dialog?


Click the left mouse button on any element in the illustrated dialog window to see an explanation of that element. Explanations for an element are available when the mouse pointer changes from an insertion mark ( [image]) to a hand with a pointing finger ( [image]).

After left-clicking an element, a floating window with information about the clicked dialog element appears. If this window contains jumps, they can be selected as usual. To close this window, left-click again, or press ESC or any other key.

In some cases, the illustration may show some elements that are currently not visible in the application. This is not an error, but is neccessary to show and explain all possible dialog window appearances within one illustration.

For information on the command that called this dialog window, please use one of the jumps listed at the end of this topic.

Press the F1 key to get further information on using the help system.


Clicking on this button will close the dialog accepting all changes. Any changes or operations specified will be carried out.


Clicking on this button will close the dialog, accepting any changes made in the dialog.


Clicking on this button will close the dialog, without accepting any changes. Any following operation will not be carried out.


Clicking on this button displays the help text for this dialog window.


Enter here the password used to encode and decode texts within the clipboard. The maximum length of the password is 63 characters, it will automatically be converted to lower case.

Please be advised that there is no way for us to recover files for which you have forgotten the password. Always store your passwords in a safe place!


If this check box is active, the text will be compressed before encoding. This option should normally be activated in order to reduce the resulting Cloaking Device data length.


If this check box is active, the created Cloaknig Device data will directly be copied to the clipboard. Else a file selection dialog appears, allowing to select a destination file.


Enter here the password used to encode and decode files. The maximum length of the password is 63 characters, it will automatically be converted to lower case.

Please be advised that there is no way for us to recover files for which you have forgotten the password. Always store your passwords in a safe place!


If this check box is active, the file will be compressed before encoding. This option should normally be activated in order to reduce the resulting Cloaking Device data length.


If this check box is active, the file name of the original file will be stored in the Cloaking Device data. This enables the receiver to restore the data to its original file name.


If this check box is active, the complete path name of the original file will be stored in the Cloaking Device data. This enables the receiver to restore the data to its original file name and location.


If this check box is active, the Cloaking Device data will be stored in multiple files if neccessary. The size of each file can be determined by the segment sizes entered below.


Enter here the maximum file size of the first Cloaking Device data segment. If the Cloaking Device data is larger than this value, and the "Multiple Files" option is active, further files will be created.


Enter here the maximum file size of further Cloaking Device data segments. If the Cloaking Device data is larger than the first segment's meximum size and the "Multiple Files" option is active, further files will be created, having at most the size stated here.


If this check box is active, the created Cloaknig Device data will directly be copied to the clipboard. Else a file selection dialog appears, allowing to select a destination file.


Enter here the password used to compress files. The maximum length of the password is 63 characters, it will automatically be converted to lower case.

Please be advised that there is no way for us to recover files for which you have forgotten the password. Always store your passwords in a safe place!


Include only files in the operation that match any of the file specifications in this file list e.g. *.txt data\*.doc . By default all files are included in the operation.

File list conventions: If you specify more than one name, separate each name with a space. You may use standard wildcards: * (group of characters), ? (single character). If a name contains spaces, place double quotes (" ") around the name, e.g. "Long File Name" .


Exclude all files from the operation that match any of the file specifications in this file list, e.g. *.hlp temp\*.* .

File list conventions: If you specify more than one name, separate each name with a space. You may use standard wildcards: * (group of characters), ? (single character). If a name contains spaces, place double quotes (" ") around the name, e.g. "Long File Name" .


If this radio button is active, the selected files will be compressed using maximum compression. This will provide best compression, but cost most time.


If this radio button is active, the selected files will be compressed using normal compression. This will result in good compression, costing affordable time.


If this radio button is active, the selected files will be compressed using fast compression. This will provide medium compression while being quite fast.


If this radio button is active, the selected files will be compressed using super fast compression. This will provide some compression while being very fast.


If this radio button is active, the selected files will not be compressed. This option can be used to pack several already compressed files (like *.ZIP, *.TIF, *.JPG, *.GIF) into a single archive in minimum time.


If this check box is active, hidden and system files will be included.


If this check box is active, directories will not be recursed into, i.e. only the top level of a directory scheduled for compression will be compressed.


If this check box is active, the TSZIP utility will be executed in a console window, allowing the user to watch the progress indication bars of TSZIP.


Enter here any additional options to be passed to the TSZIP utility during compression.


Enter here the password used to extract files. The maximum length of the password is 63 characters, it will automatically be converted to lower case.

Please be advised that there is no way for us to recover files for which you have forgotten the password. Always store your passwords in a safe place!


Extract only files that match any of the file specifications in this file list, e.g. *.txt data\*.doc . If you don't specify this option all files contained in the ZIP file will be extracted.

File list conventions: If you specify more than one name, separate each name with a space. You may use standard wildcards: * (group of characters), ? (single character). If a name contains spaces, place double quotes (" ") around the name, e.g. "Long File Name" .


If this check box is active, the files will be extracted without use of pathes, i.e. they will all be located directly in the destination directory. If multiple files with the same file name (but different paths) exist in the archive, only the last one will survive.


If this check box is active, the TSUNZIP utility will be executed in a console window, allowing the user to watch the progress indication bars of TSUNZIP.


Enter here any additional options to be passed to the TSUNZIP utility during extraction.


Enter here the name of the ZIP file into which the compressed files shall be stored.


Clicking on this button will display a file selection dialog in which you can select the name and location of the ZIP file.


Enter here the directories and files to be compressed, e.g. c:\mydir\*.* d:\file.txt .

File list conventions: If you specify more than one name, separate each name with a space. You may use standard wildcards: * (group of characters), ? (single character). If a name contains spaces, place double quotes (" ") around the name, e.g. "Long File Name" .


Clicking on this button will display a file selection dialog in which you can select a file or directory to be added to the list of files and directories to be compressed.


Clicking on this button will display the Compress Files Options dialog.


Enter here the name of the ZIP file from which files shall be extracted.


Clicking on this button will display a file selection dialog in which you can select the name and location of the ZIP file.


Enter here the directory to which the files shall be extracted, e.g. c:\mydir\*.* .


Clicking on this button will display a file selection dialog in which you can select a directory to which the files shall be extracted.


Clicking on this button will display the Extract Files Options dialog.