Users manual


STarCall

The Data-transmitting-program for your ATARI

 

(c) 1/92 - 11/96

for version 2.1



DATA TRANSMISSION * TELEFAX * BBS * VOICE










INLI - Computer & Software.


Address: 			Ingo Linkweiler
				Marktstr. 48
				D-45711 Datteln
				Telefon: 02363-55629
				Fax/Mailbox: 02363-2610
				E-Mail: Ingo Linkweiler @ Do.maus.de











Index

INDEX	2
1 CHAPTER 1	7
1.1 Foreword	7
1.1.2 Greetings	7
1.1.3 Shareware info:	7
1.1.4 This manual	8
1.1.5 The author:	8
1.2 About STarCall features:	8
1.2.1 System configuration:	9
1.2.2 STarCall includes:	9
1.3 What is DT ?	9
1.3.1 What is a Terminal ?	9
1.3.2 BBS / E-mail	9
1.3.3 Datex J / Btx / Teletex	10
1.3.4 Telefax	10
1.3.5 Costs	10
1.3.6 What is the job of the telephone company?	10
1.3.7 Some laws	10
1.4 Installing STarCall step by step	11
1.4.1 Installing hardware:	11
1.4.2 Installation STarCall from Disk:	11
1.4.3 Installation manually	12
1.4.4 Installation as accessory	12
1.4.5 Support of Multi-Tos / Mag!X	12
1.4.6 GDOS- Whats that?	13
1.4.7 Installing MULTRIX	13
1.4.8 Installing modules	13
1.5 Configuration files	13
1.5.1 The file  StarCall.Cnf 	13
1.5.2 Die Datei STarCall.Set	13
CHAPTER 2	15
2.1 The first time	15
2.1.1 Menu-bar	15
2.1.2 Dialogs	15
2.1.3 The Desktop	15
2.2 The Beginning:	15
2.2.1 Important Configurations	16
2.2.2 Test of the Configuration	16
2.3 Example: Dialing a BBS	16
2.3.1 Connect to the BBS.	16
2.4 Mouse Quotes:	17
CHAPTER 3	18
3 Menus	18
3.1 Menu STarCall	18
3.2 Menu file	18
3.2.1 Open	18
3.2.2 Save	18
3.2.3 Save as	18
3.2.4 Load Settings	18
3.2.5 Save Settings	18
3.2.6 File Utilities	18
3.2.7 Set time and date:	19
3.2.8 Run program	19
3.2.9 Start Batch	19
3.2.10 Quit	19
3.3 Menu Transfer	19
3.3.1 Online	19
3.3.2 Command Shell	20
3.3.3 Chat	20
3.3.4 Send file.	21
3.3.5 Receive file	21
3.3.6 Send Ascii file	21
3.3.7 Send Clipboard	21
3.3.8 Quote Clipboard	21
3.3.9 Dialing	21
3.3.9.1 Numbers:	21
3.3.9.2 Edit Numbers	22
3.3.10 Hang up	23
3.3.11 Break	23
3.3.12  Printer:	24
3.4 Menu Windows	24
3.4.1 Open Buffer	24
3.4.2 Open Editor	24
3.4.3 Status	24
3.4.4 Open Tek	25
3.4.5 Terminal in window	25
3.4.6 Terminal TOS	25
3.4.7 Find Text	25
3.4.8 Marks	25
3.4.9 Clear Screen	25
3.5 Menu Editor	25
3.5.1 Block start	26
3.5.2 Block end	26
3.5.3 Hide marks	26
3.5.4 Erase Block	26
3.5.5 Cut Block	26
3.5.6 Copy Block	26
3.5.7 Insert Block	26
3.5.8 Send Block , Quotes	26
3.5.9 Save Block	26
3.5.10 Print block	26
3.6  Menu Parameter	26
3.6.1  RS-232-Setup	27
3.6.2  Terminal	28
3.6.3 Transfer protocol:	29
3.6.4 Modem:	30
3.6.5 Function keys	31
3.6.6  Set Path	31
3.6.7 Answer calls	32
3.6.8 Fonts	33
3.7 Config	33
3.7.1   User-Moduls	34
3.7.2 Printer	34
3.7.3 Register	34
3.7.4 Buffer	34
3.7.5 Colours	35
3.7.6 System-Password:	35
3.7.7 Telephone charge	35
3.7.8 Tek	35
3.7.9 Sounds	36
3.7.10 Desktop	36
3.8 Menu Extras	36
3.8.1 Logfile and Calculator	36
3.8.2 Create Autologin	36
3.8.3 Clean Desktop	37
3.8.4 Help	37
3.8.5 Fax	37
3.8.6 Voice	37
3.8.7 Moduls	37
CHAPTER 4	38
4 Batch Files	38
4.1 What is a Batch ?	38
4.2 Automatic Creation of Batches	38
4.3 Manual start of a Batch	38
4.4 Self-running Batches	38
4.5 Programming your own Batch	38
4.6 The commands:	39
CHAPTER 5	46
5 Zyxel-Voice Functions	46
CHAPTER 6	48
6.1 Receive Fax	48
6.1.1 How to install STarFax	48
6.2.1 Receive a Fax	48
6.2.2 Receive a Fax with STarCall	48
6.2.3 Receive a Fax with STarFax	49
6.3 Create a Fax	49
6.3.1 Ascii, 1st Word Plus 2.x / 3.x	49
6.3.2 Tempus Word	49
6.3.3 Calamus	49
6.3.4 Script	50
6.3.5 Signum 3	50
6.3.6 Stad / Degas / Doodle	50
6.3.7 IMG Grafikprogramme	50
6.3.8  QFAX	50
6.3.9  Other Programs	50
6.4  Send a Fax	50
6.4.1 The list of numbers	51
6.4.2 Select FAX	51
6.4.3 Jobs	51
6.5 Fax Options	52
6.6 Cover	53
6.7 Using STarFax for own programs	53
6.7 Viewfax	53
6.8 Using the Fax-modul for programing own programs	55
CHAPTER 7	56
7.1 STarBox+STarPoint introduction	56
7.2 STarPoint Installation	56
7.2.1 STarPoint configuration	56
7.3 Working with STarPoint	58
7.3.1 Boards and mails	58
7.3.2  STarPoint menus	58
7.4 Management	59
7.4.1 Boards	59
7.4.2 Edit Users	61
7.5 Working with STarBox	61
7.5.1 Function keys	62
7.5.2 Placing data in your BBS	63
7.5.3 Modem Login	63
7.5.4 STarBox online configuration	63
7.5.5 Menu editor	64
7.5.6 Some more hints	64
CHAPTER 8	65
8.1 Zconnect - Whats that ?	65
8.2 Address	65
8.3 Prepare polling	65
8.4 How can somebody poll at my bbs ?	65
8.5 I want to be point !	66
8.6 How to connect a bbs to a network	66
8.6 MAPS	67
8.7 Hints for experts:	67
CHAPTER 9	68
9.1 VT-Emulation	68
9.1.1  General ASCII-Codes	68
9.2.1 VT-52-Codes	68
9.2.2  VT-52 Key table	68
9.2.3 VT-100 Codes	68
9.2.4 VT100 - Key table	70
9.2.5 The RS232 port	70
CHAPTER 9	72
9.3.1 Troubleshooting	72
9.3.2 Update service	72
9.3.3 Some BBS-commands	73
9.4 Modem-Commands	73
9.5 Lexikon	74
9.9 Last words	74
 
1	CHAPTER 1

1.1	Foreword

Congratulation for buying STarCall for your Atari-computer. With this 
software product you get an efficient program for your computer. When 
developing STarCall we try to give you an easy way into the world of 
telecommunication and data transmittion. STarCall has been developed 
together with many users, to realize all wishes and possibilities.
 When planning STarCall an important idea was to include all functions and 
utilities you need for data-transmittion (short DT) in one programm package 
and to create an easy graphic environment. We want to give beginners an 
easy start with this program, because data-transmittion is a very complex 
theme.
We also want to give "experts" all functions they want. So we decided to 
split STarCall in moduls: That is more flexible and updateable.
STarCall will be regulary updated and many new features will be included. 
It should be a program, which saitifies many users. If YOU find some bugs, 
or have some new ideas, please inform us via Fax, letter or e-mail in our 
support-BBS. Our BBS is dayly online, you may get free updates in a special 
area of this system. (see chapter 9.1)

And now much success,
						Ingo Linkweiler.


1.1.2	Greetings

Many users helped to develop STarCall. So at this place greetings and 
thanks to...

Michael Ziegler		for ZMODEM-Modul (Please register!)
Heinz Lagler			for parts of this manual
Robert Osten			for some important documents
Michael Matschke @ DO	for many ideas and testing
Klaus Ehrenschwender		for hardware works
many other Users		for  testing and ideas
many Sysops			for STarCall support

1.1.3	Shareware info:

STarCall is distributed as shareware, you also will get it in some computer 
shops.
When running STarCall the first time, you will be asked to enter a 
registration code. You will get this code incl. one free update with the 
newest version directly from the author or from your software distributer.
The price incl. shipment:

STarCall Standard			DM 40.-	US $ 35
STarCall Professional incl. Fax	DM 99.-	US $ 75
printed manual.			DM 15,-	US $ 15

The manual is included as ASCII-file, when you are allready fir in using 
STarCall and know everything about data transmittion, you may order 
STarCall without the printed manual.
When you have ordered STarCall Pro from a software distributer, you will 
get your code free when sending us the registration form.
User of the Shareware-Version or a not registered version may send me a 
letter or a copy of the file "Order.txt". Please include the money or a 
cheque or transfer it to my bank account.



Please send shareware registrations, letters, ideas and money to...

Address:

Ingo Linkweiler, Marktstr. 48, D-45711 Datteln
Telefon: 02363-55629	Fax/Mailbox: 02363-2610
E-Mail: Ingo Linkweiler @ Do.maus.de

remittance to

Bank account:
Konto: 134 944 015 
Volksbank Datteln
BLZ:  426 616 05 , 

Important:
Until you did not register STarCall, you will be asked to register. This 
message will be displayed for 10 seconds. So please register, you will get 
your code within about 10 days and a disk with the newest version

1.1.4	This manual

This manual introduces you in the use of STarCall. When it is possible and 
usefull, we give some general hints to the theme DT and some other 
information. Nevertheless we sometimes have to refer to other sources, for 
example your modem manual. We can not introduce you in the use of different 
BBS-Systems,  but we will give some examples.
Important: STarCall will be updated regulary, so we can not insert all 
features of STarCall in this manual. You will find actual information and a 
list of new features in the file "update.txt"

1.1.5 The author:


 
Bild "Ingo"

Hi, for all who want to know who 
invented this software, here a 
short info:

Name: Ingo Linkweiler
birth: 26.07.72
Inf-Student, Uni Dortmund
Hobbys: Computer, Golf, Music





1.2	About STarCall features:

STarCall is the versatilest DT-Program for ATARI-Computers. It offers an 
easy graphical environment for beginners and many usefull functions and 
features which enable good work for experts. STarCall is a flexible 
program, running on all ST machines using all their power.
STarCall offers general features like VT100-Emulator, telephone list, 
macros, GEM, Shortcuts, Puffer and many usefull tools.

- Display in windows or fullscreen
- ANSI-compilant, all attributes incl. blinking
- Grayscale emulation
- GEM-Desktop with shortcuts
- Many fonts in different sizes useable with and without GDOS.
- Batch programming language
- Buffer management , quotes
- Moduls for protokolls and tools
- Moduls for FAX, Voice and a full BBS
- fast editor with many tools
- VT52,100,102,200,Ansi with autoswitch.
- List of numbers with individual setup
- Logile for telehone costs
- Passwort protection.
- Fullscreen-Chat
- Online-Help
- many extras like disk format, info, etc...
- MULTRIX, Multitasking-Tetris for fun

1.2.1	System configuration:
To run STarCall you need
- ATARI ST/STE/TT/FALCON or compatible.
- min. 1 Megabyte Ram
- Monitor
- Modem
- Harddisc or 2 Disk drives

1.2.2	STarCall includes:
- one installation disk 'STarCall',
- manual optional

Liste of files on the disk
 
INSTALL.PRG		To install STarCall
INSTALL.RSC		Rsc-file
INSTALL.EMU	used for unpacking STarCall
STARCALL.SET	STarCall Setup
STARC2++.LZH	STarCall as LZH-Arc
STARF1++.LZH	Fax-Modul
STARB1++.LZH	BBS-Modul
MULTRIX.LZH	Game Multrix
BITDISK.GTP		Ramdisk

++  is the current number of version.

1.3	What is DT ?

DT means data-transmittion. With a computer, a modem and a telephone line 
you may send data to other computers and read infos and files. There are 
many interesting uses of DT:

1.3.1	What is a Terminal ?

A terminal is a computer working place, which is controlled from a 
different computer. The terminal is used for data in- and output to a 
computer which may be far away and which is connected to you via cable or 
modem.
Terminals are often used with great Central Units, often running with unix. 
Of course, you can use STarCall as terminal for unix-servers.

1.3.2	BBS / E-mail

Perhaps the most interesting use of STarCall is to connect to a BBS (Black 
board System, sometimes called mailbox ). BBS is a system which can be 
compared to a post mailbox or a black board. Here you can write letters to 
other users or send public mails for all users. A fast and nice way to swap 
news, infos and software. You also will often find special areas for 
software, smalltalk, infos, discussion ...
Often BBS Systems are connected to a network, so you may write a letter to 
a user of a different BBS. The use of the BBS is often very different. 
There are command, shortcut and menue-controlled systems. For different 
actions you will need short commands ( for example "Area" to select a board 
) , Shortcuts ( "a" ) or you may use the cursor keys or mouse. Each of this 
system has advantages, for example it is faster to enter a command than 
using the cursor, but you will have to learn this commands. A list of some 
commands is added in the appendix.
STarCall includes the modul  "STARBOX", with this modul you can use your 
computer as public BBS System. STarBox uses menues and shortcuts.

1.3.3	Datex J / Btx / Teletex

STarCall does not support this way of communication, because there are no 
international standards. Perhaps we will make Datex J in future.

1.3.4	Telefax

The most known way of data transmitting is FAX. It is used to send a text 
or graphic.
A "normal" FAX-machine consists of 3 parts, a Scanner, a printer and a 
dialing keyboard. You put the document into the scanner and dial the 
number. The fax is soon printed at the receivers machine. A computerfax 
does not need a Scanner and a dialing keyboard, you will use your modem and 
your text or graphic program. You create your document as usual with your 
program, and send it directly with STARFAX,

1.3.5 Costs

For transferring data you will have to pay normal telephone charge. To keep 
your telephone bill low, here a hint: Its cheaper to dial only local 
numbers (distance zone 0) , and it is cheaper to do this in the evening / 
night after 6 pm.
To get a list of BBS-Numbers you should ask some friends or your telehone 
company for a list of near BBS-Systems. Having once connectet to one BBS, 
you will find there many other lists and ads of BBS systems.

1.3.6 What is the job of the telephone company?

Without a telephone line nothing is possible! This fact makes the telehone 
company to our important partner. All devices and modems connected to the 
line should have a license and be confirm to FTC-rules. Which modem you use 
does not matter, but it should offer a minimum of 9600 bps (Bits per 
second). When you want to transfer many data or when you do this regulary, 
you should use a highspeed-modem with 14400, 19200 or more bps. Please do 
not use old modems with less than 2400 bps.

1.3.7 Some laws

Perhaps you will ask yourself what you can do with your computer and modem 
and what is forbidden. Here some answers, because some freaks do illegal 
things.
- It is forbidden to collect illegal data of persons
- Do not give away passwords, do not try to get passwords of other users 
(hacker).
- Do not use other users name or passwort.
- Never give your password to other users.
- BBS Systems are a nice place for swapping software. Please remember: 
piracy is a crime, please only copy freeware. Ask your sysop (System 
operator) for more information.
Many companies, universities, banks, government etc. use BBS Systems or 
have networks. Normaly you will not get a free account there, or you will 
only get a personal account after a special ask. An often used network is 
the "Internet", it is used by many universities.
Trying to get an illegal account , for example by trying all possible 
passwords, is called "hacking"...


 
1.4 Installing STarCall step by step

First make a backup copy of your STarCall disk. Allready done? Ok, let us 
continue:
Installing STarCall is easy:Just follow the displayed messages, then you 
will have no problems. We assume that you know how to use your computer and 
that you know words like "Click", "File" and "Folder"

1.4.1	Installing hardware:

First you should install your modem. Here an example:
 
BILD Hardware:
 
If your modem has a phone jack, you should connect your telephone with it. 
When using online your modem, your telephone will be automatically locked. 
Please read your manual of your modem for more information.

1.4.2 Installation STarCall from Disk:

Installing STarCall is easy. Just run the programm "Install.Prg" from your 
disk with a double-click. Then select the function "Install STarCall"

 

 Please enter now, on which partition and folder STarCall should be 
installed. For example enter "C: " for Harddisc and "B: " for floppy B. You 
may enter a folder, for example "E:\DFUE, but this folder will not be 
created automatically.
 
 

Then select the moduls you want to use.
STarCall is the terminal and ring manager, it must be installed.
STarFax is a modul for fax. When you do not want to fax, you may disable 
this.
STarBox is a BBS Modul, it allows you to create your own BBS. This enables 
other users to use your computer and send e-mails.
Multrix is a Game, just for fun..

 After you select "OK", the selected moduls will be copied to your drive, 
this will take some minutes.
When you do not have a harddisk, you will need 2 formated disks to install 
STarCall.

Now StarCall has been copied to your drive. You will have to confirm some 
settings by clicking "OK". The setting of your telephone number and the 
registration code if very important.
When using FAX you will have to define two folders where the Fax files will 
be saved, you may accept the preset values, too, otherwise you will have to 
create the folders after this.
When you do not have a registration code, you may skip this question, it 
can be changed later.
You may modify this setup later using the option "Change Setup" in the 
first menue, or you can edit the file "STarCall.Set" with an editor.

STarCall supports GDOS-Programme. You can install GDOS every time, please 
refer to the chapter "GDOS".
Further installation procedures are printed in the next chapters.
STarCall is installed now, you can skip the next two paragraphs.

1.4.3 Installation manually

When you got STarCall allready unpacked (for example a backup) or you want 
to install STarCall manually, just copy all the files to any drive. Use an 
editor to edit the file "C:\StarCall.Set" , and use LHARC to unpack LZH-
files.

1.4.4 Installation as accessory

Some modules may be used as accessory, this modules are STARFAX and the 
STARCALL terminal. STarFax can be installed as ACC by copying the file 
STARFAX.PRG to your boot drive. Then rename it to STARFAX.ACC. Thats all.

STarCall can be installed as Accessory, too: Copy "Starcall.Prg", 
"Starcall.Rsc", "Starcall.Cnf", and "Starcall.Num" into your boot-partition 
(C:). Then rename "Starcall.Prg" to "Starcall.Acc". STarCall is now 
installed as Acc. Using the ACC-Mode there are some changes: The drop-down-
menu will be activated by pressing the right mouse button or selecting the 
ACC-Entry. The icons are not useable. STarCall now can be called everytime 
you want. Some Features are working as task now, for example dialing and 
answering.
Attention: On many TOS-Versions ACCs can not execute programs and moduls. 
Calling moduls can cause the system to stop or not to work propably. So I 
recommend to use the STarCall terminal as program only.

1.4.5 Support of Multi-Tos / Mag!X

When you have installed MultiTos or Mag!X , here is another reason to be 
happy: STarCall supports multitasking, it may be executed together wirh 
other programs. Most functions allow parallel processing. You can use your 
text-program while STarCall is answering a BBS-Call, dialing a number or 
waiting for fax.
As MultiTos (Version 1.0) is not very slow on old 8 Mhz Sts, you should 
have 16 MHZ for this. Mag!X is much faster and can be used with your small 
8 MHZ machine, too. Ask your distributer for more information.

1.4.6 GDOS- Whats that?

We often get this question, because only a part of ST-Programms support 
this. When developing Tos the developer "forgot" one Part of GEM. Later 
this part was added as an individual program. Without this program GEM is 
not able to load memory resistant fonts and cannot use many periphery. As 
StarCall needs more fonts than the systemfont to display 80*24 characters 
in a window, we support GDOS Fonts with STarCall to enable chars of any 
size. We recommend the Gdos-program NVDI, because it speeds up the graphic 
system. The program Speedo-GDOS ist distributed by ATARI with every new 
computer.
You need not install GDOS, because there are some fonts included on your 
STarCall, which may be loaded without GDOS.

1.4.7 Installing MULTRIX

MULTRIX is a modified version of the game-hit 'TETRIS'. It may be installed 
in the AUTO-folder of your system. Multrix can automatically be activated 
when dialing, up- or downloading. Also finishing Multrix is caused 
automatically when connecting to a BBS. The current game will be saved. 
Multrix is a Shareware program and should be registered when used regulary.

1.4.8 Installing modules

Most modules are installed automatically when installing STarCall. You may 
add own Modules, see chapter 4.5 and the readme-files.

1.5 Configuration files

STarCall uses 2 different files to save your settings.

1.5.1 The file  StarCall.Cnf 

The file STARCALL.CNF ist used to save settings of the terminal and 
internal settings of STarCall. Intern means that this settings are only 
used by the "STarCall.Prg", but not by modules. This are all the settings 
you will find in the "Config"-menue. To save this file you can use the 
option "Save settings" in the file menu.

1.5.2 Die Datei STarCall.Set

The file "STarCall.Set" contains global settings, used by STarCall and all 
modules as Ascii-Textfile. It will be created when installig STarCall, and 
can later be changed using the Install-Program or an text editor.
This file must be placed on partition A or C and called " C:\STARCALL.SET"
STarCall and its modules use this important entries:

SENDPATH	E:\STARFAX\OUTGOING		< Folder for "ready to sende" Fax 
files
RECPATH	E:\STARFAX\INCOMING		< for recieved Fax
FAXID		++49 2363 55629			< Your FAX-Id
FDIAL		ATX3DP				< Modem FAX-dialing command
FAXSPEED	19200					< What is the maximum Fax speed?
REGNAME	Vorname Name			< Your Name
REGCODE	1234567890123456			< Your registriation code

Perhaps you will ask yourself "why  a SET- and a CNF-file ?" . Every modul 
needs the settings from the SET-file, but not all the information saved in 
the CNF-file. And sometimes it can be usefull, to use more than one CNF-
file, but only one SET, for example when STarCall is used by many users on 
one system.

CHAPTER 2

2.1	The first time

Now you have installed STarCall with success. Please verify that all 
selected folders have been created. Then look for "STarCall.Prg" and start 
it from your desktop. After a short time the STarCall-desktop will appear. 
(You may disable it later)
After this first start please enter the code number, you got with your 
registration, again. Now the desktop, menus and windows of STarCall will be 
displayed. Now we want you to learn some things about the environment of 
StarCall.

2.1.1	Menu-bar

With the menubar you can select all important functions of STarCall. When 
you move the mousecursor to the menubar, the menus will roll down. You can 
select a function by clicking the left mouse button. Most entries of the 
menu can also be called by pressing a combination of keys. Entries marked 
with ^ can be used by pressing (SHIFT) & CONTROL and the shown key. The # 
represents the ALTERNATE-Key. You have to use SHIFT only when being online, 
because the CONTROL-KEY-combinations are sent to the modem and cannot be 
used for menus.
When you are using STarCall as ACC, the menu will be called by pressing the 
right mouse button.

2.1.2	Dialogs

We added some new features to the original ATARI Dialoges. In STarCall you 
can use all dialogs with the keyboard: Buttons can be selected by pressing 
"Alternate" and the underlined character of the button. You also can use 
the F-Keys. Bold buttons can be selected as usual by pressing the "Return"-
Key. The dialogs are displayed in a window and can be moved. Some dialogs 
will use POP-UP-menus.

2.1.3	The Desktop
 
Bild "Desktop"
When you are using STarCall as program, you can use many important 
functions (numbers, buffer, editor, trash) by clicking or moving the icons 
of the desktop:
Clicking on a icon will open its window.
Examples:

 * Click "Telephone" will open the list of numbers.
 * The typewriter opens the editor.
 * Terminal opens the terminal window.
 * The disk drive opens the file utilities.

Moving icons will execute some functions, too:

 * Moving the editor into the trash will erase the editor.
 * Moving the diskdrive to the typewriter will load a text.

You can disable the desktop icons in the "System"-menu. This may be usefull 
when using MultiTos or Mag!X, because you may get access to the system 
desktop. 

2.2	The Beginning:

In the following chapter we will describe all functions of STarCall. For 
beginners the many functions may be confusing, and it may be difficult to 
call and to use a BBS the first times.
Anyway, we cannot help you using the BBS, because there are many differnt 
BBS systems. We now want to show you how to use and to configure STarCall, 
before youstart calling a BBS.

2.2.1	Important Configurations

At first you have to check and perhaps to change some settings of Starcall 
to make it running with your modem. We have preconfigured STarCall that it 
will run with most modems connected to port MODEM 1. Nevertheless please 
see all the settings and verify it.
The best way will be to select step by step all of the functions of the 
menu "Parameter" and compare this settings with your computer and modem 
type.
The most important parameters for the first time are the options found 
under "RS232-Setup" , "Terinal-Setup" and "Modem". When you want to 
transfer files, the pathes should be configured, too.
Now: Select the first menu of "Parameter". Check the settings and confirm 
with "OK". Then continue this way with all the other menus.
The meaning of the settings and STarCall menus are described in chapter 3.

2.2.2	Test of the Configuration

In order to test your RS232-Settings - thats very important - just type 
something into the open terminal window. The DTR-LED of your modem should 
be on. After every key you pressed, the LEDs RD (Receive Data) and SD (Send 
Data) should blink a short time, the modem confirms this way the sending 
and receiving of signs.
Every character should be displayed on your terminal window. If the chars 
are displayed twice, you have to change terminal echo to "full". If nothing 
happens, your modem is not connected correctly or your RS232-Settings are 
wrong.
Now try this:
Type "AT" and press "RETURN". The modem should answer "OK", then everything 
is well. When no answer is displayed, your RS232-Settings may be wrong.
Check the DTR-LED: When it is off, your modem perhaps is connected to the 
wrong port, or your port-settings (see RS232-Setup) are incorrect.
Now check the CD-Led. While you are not connected to a BBS, it should be 
off. If it is on, you have to reconfigure your MODEM. Enter "AT & C1 & W" 
in the terminal window, this may solve this problem.

2.3	Example: Dialing a BBS

As first example we try to connect to any BBS. You will find some BBS-
Numbers for free private use in the appendix. Or try to connect to our 
support BBS: (+49) 02363 2610.
Now, before you can dial, you have to enter the phone number into the phone 
list. You can read chapter 4 how to do this.

2.3.1	Connect to the BBS.

Now it will be exciting... the modem has dialed, and perhaps after several 
tries you will hear the dialing tone and then a beep-tone while the modems 
are connecting. (Called "Handshaking" ). The dialing window will be closed. 
The terminal window displayed a "CONNECT" Message, often followed by the 
current bps-setting.
Now you are connected to the BBS, you are "ONLINE". The next steps are 
called "LOGIN", you will be asked for users name.

LOGIN. PRESS RETURN
USERNAME: GUEST

As a new user you will have to enter something like "Guest" or "Account". 
The BBS should display enough information about the way how to continue, we 
wish you much success. In many BBS it is usual to use a pseudo-name, you 
should think about it before your login. You also will need a password, you 
should consider this, too.
With each next login you will be asked for your username and password 
again. Your username will be sent with every message you write.

Here one hint: After getting your account try the BBS command "Operator" or 
"Chat". When you have luck, the system operator is near the computer, and 
he will help you and can talk to you using a text dialog. ("chat"). If the 
sysop does not answer, you can send him a letter using the "POST"-function. 
Often you will find this in the main menu of ths BBS or you have to enter a 
command like "SEND" or "PM". Entering a letter is often finished by 
pressing "..." or "control+C", followed by "Return".

2.4	Mouse Quotes:

Before describing all the menus we want to present you one usefull function 
of the mouse:
- It is possible to quote some lines directly from the terminal window. 
Move the mouse cursor on the word you want to send and click the left 
button. The selected word will be sent. This is usefull for example when 
selecting an area, you just type the command to select an area (You can use 
the F-Keys for this, see the chapter F-Keys) and click the name with the 
mouse.
CHAPTER 3

3	Menus

Now a description of all menus of STarCall follows.

3.1	Menu STarCall

Here you can call some information about STarCall, displaying the current 
versions number, the authors address and ordering informations. You can 
register or change your code here. You will find some more information 
about distribution of STarCall selecting "more infos".
The next entries are used by accessories and other tasks of Multitos.

3.2	Menu file

The title "FILE" includes all entries concerning with input and output to 
your drives. You also can execute batches and programs.

3.2.1	Open

This opens a text file and loads it into the editor. When entering a non 
existing file name, a new file will be created.

3.2.2	Save

This will save the top windows (editor, buffer, terminal) under its current 
name.

3.2.3	Save as

This will save the text of the current window (editor, buffer, tek) under 
any name you have to select with the file selector. It always will save the 
text of the current top window. When using this function for the buffer, 
the buffer will be erased after saving.


3.2.4	Load Settings

This function can be used to load a different CNF-file for STarCall, This 
file contains all important settings like fonts, numbers, modem settings. 
The files "STarCall.CNF" and "STarCall.Num" will be loaded automatically 
when running STarCall, so you need not do this every time.

3.2.5	Save Settings

This saves the current settings under any filename you have to select with 
the file selector, for example "StarCall.Cnf". This will save numbers and 
all settings of the menu "Parameter". The settings of moduls will not be 
saved. They use their own setup file and are running independend from 
STarCall.

3.2.6	File Utilities

Here you will find some usefull functions for managing files. You can 
select any drive, then STarCall will display information about free memory. 
Further you can select the following functions:

 

Erase file:

This erases one ore more files you can select using the fileselector. You 
will have to confirm with "OK" after doing this. Select "Cancel" when you 
do not want to erase more files.

Create folder:

This will create a new folder on your disc drive. Use the file selector to 
enter any name for the folder and click "OK" to create the folder.

Format disc

Please only use this function to format and erase a floppy disc. Select 
drive A or B and a disc format (DD or HD). Then click "Format" to format 
the disc, or "Soft format" to erase a formated disc. You can cancel 
formating with ESC.

3.2.7	Set time and date:

This function can be used to set the time and date of the systems clock. 
When starting STarCall with an invalid time (<1995) this dialog will be 
called automatically, because the correct date and time is important for 
calculating telephone costs. The date will also be used for the log file, 
therefore always enter the correct date!

3.2.8	Run program

Often, especially when not using multitasking, it can be usefull to launch 
other programs without quitting the terminal. After selecting "Run Program" 
you can select a program with the file selector. Then you can enter some 
optional parameters for this program. Remember that STarCall uses some of 
your memory and that the launched program has less memory as normal and may 
not run when memory is low.

3.2.9	Start Batch

This will execute a selectable Batch file. A batch file is a sequence of 
commands for your modem. See chapter 5 for detailed information about 
batches.

3.2.10 Quit

This will quit STarCall after a security question. You may save the buffer 
now. When quitting STarCall the logile "STARCALL.LOG" will be saved, and it 
is possible to save the buffer now.

3.3	Menu Transfer

Here you will find all functions needed for communication when being 
online.

3.3.1	Online

This function sets terminal to online. Depending on some settings the 
terminal window will be opened or fullscreen display is displayed. You now 
are directly communicating with the device you are connected with, this 
normaly will be the modem or BBS. Every char you enter will soon be sent to 
the modem. When terminal mode is "Half" it will be echoed soon (See 
Terminal). Every received char will be displayed soon.

STarCall automatically gets online when

- modem received data
- you press a key without opening any window
- after quitting a batch
- after dialing
- after pressing the HELP key.

In contrast do most other terminals STarCall supports two ways to display 
the received data. You may select this in menu "Window".

Display in a GEM Window:

STarCall uses GEM VDI routines to display chars. As it is not possible to 
display the usual 24 lines using the 8*16 system font, STarCall uses a 
smaller font. You can load other fonts or use any font using a GDOS 
program.

Fullscreen-Display with TOS:

When using this mode STarCall will switch the screen when receiving data. 
Menus, desktop and window will disappear, you can use the full screen 
without any borders of windows. This gives a nice BBS-feeling, but as GEM 
is not used now, you cannot use the mouse. You can exit this mode by 
pressing HELP or the right mouse button.

3.3.2 Command Shell

This will open the internal Command Shell of STarCall. The shell is used 
compareable to MS-DOS and UNIX to enter commands which will be executed 
soon. You will find a list of all commands with the description of the 
batches. Some commands are "DIR", "CD", "COPY" and "END".

3.3.3 Chat
 

This function can be used when you are connected directly with a person per 
modem or null-modem-cable. You can establish such a connection as described 
in your modems manual, often this is done with a switch of your modem or 
with the commands "ATA" and "ATD".
Most terminals have the disadvantage that you do not see your own entries 
when being connected this way. The only way was to select half-duplex mode, 
but this often caused chaos, and linefeeds were ignored.
With STarCall this chaos has not to be: Stay in full mode and select the 
CHAT function on one (!) computer. STarCall will cancel the function when 
trying it on both computers.
The screen will be devided in two parts, one for your inputs and one for 
your partner. You may chat as long as you want. Enter "LOGOFF" to hang up 
the modem. STarCall can call the chat automatically when detecting an 
incoming ring, see menu "Wait for ring"

3.3.4	Send file.

You can select a file with the file selector, it will be sent using the 
current protocol. The protocol can be selected in menu "Parameter". The 
best protocol for this is "ZMODEM", see the next chapters.
When you call a BBS you will be asked to transfer files. Do not try to send 
files, when the BBS did not ask you to send. Most BBS use the command 
UPLOAD (Send) and DOWNLOAD (Receive) for transfering files.
When you have installed the game MULTRIX, it may be called automatically 
when transfering files.
"ZMODEM" will be activated automatically when ths BBS is ready for UP or 
DOWNLOAD, you need not select the menu "send".

3.3.5	Receive file

A file will be received with the current protocol and saved in the 
download-folder. When using ZMODEM this function will be started 
automatically, too.

3.3.6	Send Ascii file

Select any file with the selector. This file will be loaded and sent 
without any protocoll. This function may be used for sending a text or a 
letter, you have stordes as ascii-file, quickly to a BBS, without using the 
editor. Many BBS offer as special function for this: For example when 
writing a letter, you are asked, whether you want to use the editor or 
ASCII-upload. Select "ASCII UPLOAD" and send your file using this function. 
Often you have to press CONTROL-X after sending top stop transmittion.

3.3.7	Send Clipboard

The clipboard is a part of the memory used for text blocks, which you can 
cut from the terminal or editor. This function can be used to send this 
clipboard.
To cut a text block from the terminal, move the mouse cursor to the first 
word, press the left mouse button, move to the end of the text and release 
the mouse button. When the current window is the terminal window, you will 
be asked, whether you want to send or quote the block now, or to keep it in 
the clipboard to use it later.
To cut a text block from the editor or buffer mark it with the mouse and 
select the function "CUT BLOCK" or "COPY BLOCK". You also can mark a block 
using the function "Mark start/end".

3.3.8	Quote Clipboard

This will send the clipboard, too. But now every line is marked with a '>'. 
This is usefull to show that the block is a quote, and not written by you.

3.3.9	Dialing

3.3.9.1	Numbers:
 
Bild "Nummern"

After calling this menu the telephone manager will be displayed. On the 
left side you will find your telephone book, where you can select empty or 
used slots using the mouse or the F-Keys. You can scroll this list using 
the arrow buttons, when it is longer than 10 entries. By the way this is 
possible with the arrow keys,too. At the right side you see information 
about the marked entry.
STarCall manages all types of numbers with only one dialog, these are 
modem, fax and normal voice numbers. You can select the type of the number 
using the "type" button. Numbers of the wrong type will be disabled.
The button "Edit" can be used to edit a selected number you to enter a new 
entry. Use "Erase" to delete a number of this list. You can sort the 
numbers with type and name using the two "Sort"-buttons, or move an entry 
manually using the other two arrow bottons.
When you want to dial more than one number, enable the option "dial many 
numbers", then you can select a list of numbers. STarCall offers an 
automatically repeat dial function, you can select the number of tries.

Examples:

To enter a new BBS number select a free entry, then click the edit button. 
(Later more infos)
To change a number do the same, but select a used entry.
To dial a number, select an entry from your list and click "DIAL". STarCall 
will dial the number, until you are connected. You can edit the number of 
retries.
To dial more than one BBS select "Dial many numbers" and select a list of 
entries. STarCall will dial all numbers until one connection was 
successfull. Later this entry will be deselected, the other numbers stay 
selected.

After you are connected, a calling sound will be played. So you have not to 
wait directly at your computer for a connection. Dialing is running in the 
background, you can use the editor and ACCs while STarCall is dialing.

When you want to dial at a later time, you may select "... at time" and 
enter a starting time. This is usefull when using a batch for automatical 
login, transfer and logout. When you know the purpose of a "Point", you 
will like this option, otherwise forget it or ask a sysop. (A description 
would be to big for this manual).

To erase an entry select it from the list and click "erase".

Now we show you how to edit numbers:

3.3.9.2	Edit Numbers

Clicking the "Edit" button will enable you to change entries or create a 
new one. A new dialog will be displayed:

 
"Numedit"

The field "Data" with the lines "Name" and "Number" is most important. The 
two entries "Sysop" and "Info" may be used for your individual notes, you 
can enter sysops name and address.
Then select the type of your entries, this are "Modem" (for BBS-Numbers), 
"Fax" (for telefax) and "Voice" (for voice numbers, you can use your modem 
for dialing voice numbers; when you here voice take your phone and cancel 
dialing with "Control") . You can use voice-modems to play an voice 
announcement, for example "Please wait a moment".
Use the entry zone to select the distance zone for calculating your 
telephone costs. 0 means local calls, 1-3 farer calls. You can define the 
values by changing the telephone entries of menu "configuration : 
telephone".

The following settings can optionally be changed !

With settings you can config some settings different from the default 
setup:
The "Init" command is a command, which will be send to your modem before 
dialing. You can use this for example to disable MNP 5. See the manual of 
your modem for a list of this commands.
You may modify the settings of the port and terminal for each number, when 
you want to use a different port configuration for this number. Choose 
"local" and change it using the two buttons.
Changing this parameters can be usefull when your default setup is 8 bit, 
and you want to dial an old BBS with 7 bit.
With batch you can define any batch file (see chapter 5), which will be 
executed after dialing.
You may define a sub dir/folder for up- and downloads, if you do not want 
to use the presets defined in the path-menu.

3.3.10	Hang up

After a security warning the connection will be canceled, the modem hangs 
up. This can be neccessary, when it is impossible to leave the BBS via 
command (ex. "LOGOFF" command) or when you are connected directly to a 
partner. Often this way of logging out is faster than using the LOGOUT-
command of the BBS, but be carefull, because many BBS think this is an 
error and do not save your userdata after that.
Hint: You can lift your phone before calling "Hand up", you can speek to 
your telephone partner when he does the same.

3.3.11	Break

After selecting this menu you may choose 3 functions:

erase I/O-Buffer: 
When you have a bad telephone line, sometimes greater transmittion errors 
can be caused. This can cause many "rubbish" on your screen. This function 
will erase the internal data buffer and stops displaying of more chaos.
Shortbreak:
sends 0.2 sec a "Short-Break-Signal" This can be used by some unix-
terminals.
Long-Break:
Same as above, but for 2 seconds. DTR will drop to low, the line will be 
canceled and the modem will reset.

3.3.12  Printer:

When enabling this entry, all received data will be sent to your printer. 
Some escape chars will be removed. You can disable printing by selecting 
this entry again.
3.4	Menu Windows

This menu includes all operations concerning to windows and their displays.

3.4.1	Open Buffer

The buffer window will be opened and can be handled in the same way as the 
editor. The buffer will be filled with the data you habe received per 
modem. You can read later what you have done during your connection, or to 
make a short review during a connection. You can save the buffer or parts 
of it using "Save" or "save block".

3.4.2	Open Editor

This is used to edit a text file. After calling this entry the editor 
window will open. You now can write your text and save or send it later.

RETURN
will put the cursor at the beginning of the next line and insert a new 
line.
BACKSPACE 
erases the char left of the cursor and moves the cursor one position back.
DELETE
erases the char at the cursors position, the chars right of the cursor will 
scroll left.
You may use the cursor keys to move the cursor within the text.
INSERT
Switches the cursor between INSERT and OVERWRITE mode.
CONTROL-DELETE
erases the current line.
CLR
moves the cursor to the beginning or end of the text.
CONTROL 1..6
You can define some marks using CONTROL 1-6 and jump to it with ALT 1-6

- The editor can be opened with the desktop icon.
- You can use the mouse to define block marks. Read the chapter "blocks"


3.4.3	Status

The status window show information about incoming calls. After installing 
STARBOX you will find a list of the enabled lines and you can call the BBS 
window. When using a hard disc the option "free memory" will be 
interesting. A partition with less than 1 MB will be displayed inverted. 
This function will be disabled when you are connected to a local network, 
because it would need many time.


 
"Status"

3.4.4	Open Tek

This will open a window for graphic displays. Some BBS of universities or 
technical systems will support the tektronix emulation. You can transfer 
vector graphics and display it directly. You can enable the TEK mode via 
the parameter menu.

3.4.5	Terminal in window

This will open the terminal window. Using windows has many advantages:

- STarCall will run with large screens
- You can choose many fonts
- You can use Multi-Tos
- You can use the mouse to cut and send text
- You can change its size up to 138 collums with 50 lines.

If you have closed the window, it will open automatically when data are 
received.


3.4.6	Terminal TOS

The window will be closed, all in and outputs will be displayed full 
screen. You do not have the advantages of the windows, but it gives a nicer 
"online-feeling" without windows and menus.


3.4.7	Find Text

This will search for any string in the text. You can start searching at the 
top of the text or at the current cursor position.


3.4.8	Marks

Marks are used to define a position in the text and to find it later. A 
mark can be defined by pressing "ALT" and a key between "1" and "8". Use 
"CONTROL" and "1" to "8" to reset the cursor to the defined position.

3.4.9	Clear Screen

The current window will be cleared.


3.5	Menu Editor

This menu includes functions for the editor and for the blocks.

3.5.1	Block start

This will define the start of a block.

3.5.2	Block end

Block functions can be used in the buffer and editor. Move the cursor to 
any position of the text and select "block start". Then move the cursor 
down and select "Block end". The area will be inverted and may be used with 
the follwing functions.
Blocks can be defined with the mouse, too: Move the mouse cursor at the 
first char. Keep the left button pressed, move the cursor to the end and 
release the button.
You may also define blocks in terminal window. But the block will not be 
inverted but copied into clipboard and can be used now.

3.5.3	Hide marks

This removes the inverted block marks

3.5.4	Erase Block

The marked text will be erased.

3.5.5	Cut Block

The marked text will be moved into the clipboard and can be duplicated 
later with "insert". The block will be erased.

3.5.6	Copy Block

The marked text will be copied into the clipboard, and can be duplicated 
later with "insert". The block will not be erased.


3.5.7	Insert Block

The clipboard will be inserted at the current cursor position.

3.5.8	Send Block , Quotes

The current block will be sent to the modem. If you choose quote, every 
line will be marked with a quoting char '>'. This is similar to "quote / 
send clipboard".

3.5.9	Save Block

The marked area will be saved as ASCII-file. You can choose any name using 
the file selector, you should choose a name ending with ".TXT".

3.5.10	Print block

The marked block will be printed.

3.6		Menu Parameter

This menu offers many functions to config your modem and your computer. 
Normally you will use this once when using STarCall the first time, and 
then save your settings with "Save settings". There are many functions 
which can be modified. We do not want to confuse you completely, so we 
placed only the important options in the parameter menu. You can call more 
options using the menu "config". This settings are less important for 
running STarCall. Now let us see the "important" options:

3.6.1		RS-232-Setup

Here the RS232 port can be configured. Which settings are possible depends 
on the modem, on the computer and BBS system, please see the manual of your 
modem. Generaly this settings will be correct:


Simple 2400 Bps-Modem (ex. Discovery 2400C) :
	2400 Bps, 8 Bit, No handshake, No parity.
2400er Modem with data compression MNP-5
	9600 Bps, 8 Bit, RTS, no Parity
Highspeed-Modem, FAX-Modem (z.B. Zyxel, TKR-Speedstar 144)
	19200 or 38400 Bps, 8 Bit, RTS, No Parity

Old Sts without extended hardware have a maximum bps value of 19200 bps. 
You can get some extensions for old Sts to increase their speed.
 
"Rssetup"
Now the meaning of the settings:

BPS is the data transfer speed between your computer and modem (!) in bits 
per second. When you have a slow modem up to 2400 bps this speed is equal 
to the transfer speed via telephone line. When you use a highspeed modem 
with 14400, 16800, 19200 or more bps, you allways should choose the maximum 
possible speed, because this modems offter a data compression and have a 
higher transfer speed. You should choose a minimum of 19200 bps and will 
get transfer rate up to 1500-1900 chars per second.

When using more than 19200 bps, you will need a driver for your port, which 
has to be installed into the AUTO-Folder of your harddisc or bootdisc. 
Please read the chapter about "HSMODEM". When using starcall the first time 
you should try it with 19200 bps,this setting will run with most STs.

BITS is the number of bits per char. Regulary 8 bits are used, but 
sometimes you will find BBS using 7 bit.

PARITY is not used very often. You will get no problems choosing "None".


STOPBITS: The modem inserts these bits between every send byte for 
synchonsiation. Normally one bit is used for this.

HANDSHAKE: As the data transfer speed between computer and modem is 
different from the speed used for the telephone line when using higspeed 
modems, the modem must tell the computer, when datas may be sent and when 
not. There are two ways for doing this: RTS/CTS uses an hardware protocol, 
XON/XOFF is controlled by software. You allways should choose RTS/CTS, 
because XON/XOFF makes problems when transfering files. When using slow 
modems you can disable handshake.

PORT: Here you can select the port your modem is connected with. The old 
Atari ST has only one port called MODEM 1. The STE/TT offers 3 or 4 ports.
When using MODEM 1 the maximum number of bps is 19200, this is to slow for 
voice transfer of Zyxel modems (except Zyxel plus model) . You can extend 
your old Sts hardware to get 38400 and more BPS (for example RS-SPEED, 
RSVE). You can select hardware extras with the next option.

EXTRAS: This can be used to enable hardware extras like RS-VE and RS-SPEED.

HARDWARE: This entry will be automatically set when choosing a port, you 
need not change it. Changing this may be interesting for future computers 
of ATARI (Falcon 040 ?) or for new hardware extras. It is not  defined 
clearly, which hardware is connected to a modem port. For example for Modem 
1 of Sts the MFP-chip is used, the Falcon uses SCC-B. Here is an overview 
of known hardware:

Computer			Modem-ports	max. bps	Hardware
ST, Mega-ST, 1040 STE	1 (Modem 1)	19200		ST-Comp.
MEGA-STE  3 Ports		1 (Modem 1)	19200		ST-Comp.
				2 (Modem 2)	76800		SCC-B
				3 (Serial 2)	76800		SCC-A
TT / STE  4 Ports		1 (Modem 1)	19200		ST-Comp.
				2 (Modem 2)	76800		SCC-B
				3 (Serial 1)	19200		TT-Mfp
				4 (Serial 2)	76800		SCC-A
Falcon 030			1 (Modem 2)	76800		SCC-B

When your ATARI does not support this settings or you have problems, try 
the setting "unknown". This option will use Ataris default settings and 
system functions only with a maximumum of 19200 bps.

Important: Nearly all known versions of TOS have a bug concerning the 
RTS/CTS Handshake, which should be used when unsing more than 2400 bps. 
This bug may be fixed using the driver "HSMODEM.PRG", you will find it on 
your disc.

3.6.2		Terminal

Here you can configure your terminal:

 
Bild "Terminal"

Echo:
Using "Half duplex" will send each character you enter to the screen and to 
the modem. This mode should be used when connecting 2 computers via a 
nullmodem cable or when dialing a BBS not supporting full echo,

When using full echo the characters only will be sent to the modem, the 
computer you are connected with will control screen outputs. Nearly every 
BBS and modem support this mode, you should prefer it.

Status line:
This line displays current information in the bottom line of your window. 
It contains information about the  current BBS, time, online time and 
costs.

Emulation:
This is used to select your terminal emulation. VT52 and VT100 are two 
normed sets, used for controlling cursor movement and text attributes. 
Nearly every BBS supports one of this modes. When both modes are available, 
you should prefer VT100. As STarCall offers auto detection of the mode, you 
need not think about it. VT200 and 220 are a newer version of this 
emulation and compatible to VT100, are also compatible with ANSI and VT102. 
We recommend to use VT100 or ANSI.

Window size:
You may change the size of the terminal window. The default setting is 24 
lines with 80 collums. The maximum value is 50 lines with 138 columns. This 
is only usefull when dialing BBS supporting the change of screen size.

Auto wrap
When the cursor moves to the last colum it may stop there (Wrapping of) or 
move to the next line (Wrapping on). Default is "off".

Change CR- CR+LF
This will change the CR-character to CR+LF. This option must be used only 
in some BBS. You will have to change this setting, when line feeds are 
displayed to often or when they are ignored. The default setting is "off".

Fine scrolling:
When transmitting lots of data often the screen is scrolled very fast when 
the cursor approaches the bottom line. When you are not able to read with 
this speed, this function will help you, because it slows down scrolling 
and makes it more smoothly.
 
3.6.3	Transfer protocol:

After selecting this function a dialog will appear showing all parameters 
concerning file transfer. Protocols are used for sending and receiving 
programs and binary files to avoid errors while transfering data. STarCall 
uses external moduls for transfering files. This is more flexible as an 
internal protocol, because you can install future protocols.


 

You can install a new transfer protocol this way: Select any entry of the 
left list. If it allready is used, the information will be displayed at the 
right side, otherwise you can enter new informations.

The first entry is the name of the modul, for example "ZMODEM". The next 2 
lines are the filenames for the moduls to send and to receive files, and 
some optional parameters.
With STarCall you will get two programs called "RZ.PRG" and "SZ.PRG", which 
will transfer files using ZMODEM. You will find a detailed description 
including the optional parameters on your disc. You can get a multitasking 
compatible version when calling the author of ZMODEM.

ZMODEM is one of the fastest and safest programs of this kind, other known 
programs are called "XMODEM" , "YMODEM" and "BIMODEM". You can use the 
program "STARTRAN.PRG" for XMODEM file transfer.
Some transfer moduls can be installed as accessory. STarCall supports this, 
too, by selecting the button GSZRZ.ACC.

Example:
You want to use ZMODEM RZ.PRG and SZ.PRG. Select name, enter "ZMODEM", then 
select receiver and enter "RZ.PRG" and "SZ.PRG" for sender.

Now, beginner often have this problem: "How can I send or receive a file or 
a program ?" Most times this is easy: Set your BBS to the used protocol 
(ZMODEM), often the command "SET" is used for this. Then select the area or 
group where the files are placed and display its file list.

- Sending a file into the BBS:
	enter "UPLOAD" or "SEND". Than select "send file" in the transfer menu 
of STarCall or press ALT+S. The file will be sent know.

- Reading a file:
	enter 'DOWNLOAD nr.' or 'READ nr.', where nr. represents a file number 
found in the file list. Start file transfer by pressing "ALT+E" or using 
"receive" in the transfer modul of STarCall.

When using ZMODEM the ransfer will start automatically.

Often the files you will find in BBS are packed. You will need special 
programs to unpack this files. Which program you need is depends the files 
extension:

.LZH:	use "LHARC.TTP". The parameter is "x filename.lzh"
	You will find this program on your STarCall disc.
.SFX:	rename this to .TOS and doubleclick it.
.ARC:	use "ARC.TTP"
.ARJ:	often used for DOS.

See readme files for detailed information. 
Other packers which are sometimes used are .ZIP, .ARJ and .MSA. You will 
find all this programs in nearly every BBS and on PD-discs.


3.6.4 Modem:

This are the commands for initializing the modem. 

 
Bild "Modem"

Example: Most modems ("Hayes compatible") use:

Dial: ATDP (or for tone dialing:) ATDT
Reset:  ATZ
Error: BUSY, NO CARRIER und NO DIALTONE, ERROR
Auto-Answer: ATA

See the manual of the modem for detailed information.

As STarCall offers repeated dialing, you should define a time between dials 
to protect modem and its relais. Also when using a telephone machine, this 
pause is important. Often a value between 2-10 seconds should be right. 
Even some BBS need a short pause after a user has logged out.
Some modems will need a pause greater 30 seconds, as this is a law of some 
countrys.

3.6.5	Function keys

 

You can define function keys with often used words, for example your name, 
password and BBS commands. To enter a line feed (RETURN) press CONTROL+M.


3.6.6		Set Path

Here you can define pathes to access files. As you will often tranfer many 
files, you should create some folders on your harddisc and set pathes. You 
can define a path by entering in with the keyboard or by clicking at the 
buttons and choosing a path with the file selector.

 
"Path"

We recommend folders like this.
	\STARCALL
for STARBOOT.PRG, STARCALL.CNF, STARCALL.EMU, STARCALL.FNT, STARCALL.LOG, 
STARCALL.TAG
	\STARCALL\DOWNLOAD
For files you receive when downloading.
	\STARCALL\UPLOAD
This will be the default path for the fileselector when sending files 
(upload)
	\STARCALL\TEXTE
for text files and buffers
	\STARCALL\BATCHES
for batches
	\STARCALL\SZRZ
for the transfer moduls (SR,RZ etc)

When using a harddisc, you must enter the drives name, for example 
'C:\STARCALL' etc.

Important: The correct settings of the pathes is neccessary for some 
functions ("send files"). You can check the settings using the "TEST" 
button.
Hint: The pathes for fax files and moduls are defined in file STARCALL.SET 
when installing STarCall, see chapter 1.)

3.6.7	Answer calls

This dialog informs you about incoming calls (FAX, MODEM & VOICE) and your 
own FAX-ID which is sent to the caller.

The buttons define which kind of calls (rings) STarCall can detect and 
whether to answer calls or ignore them. You have to select whether your 
modem can answer MODEM. MODEM+FAX or MODEM, FAX + VOICE (This is possible 
with Zyxel and Creatix modems). Voice modems can be used lika an answering 
machine and can receive FAX and MODEM calls.
Incoming FAX files will be saved into the folder youhave defined in 
"STARCALL.SET" by the fax driver, and can be viewed or printed later using 
"VIEWFAX.PRG". A description of viewfax will follow in the chapter for fax.
When detecting a modem call STarCall will try to run STARBOX or display the 
text file "STARCHAT.TXT" to the caller. To run STARBOX you must install 
STARBOX.PRG and verify the settings found under parameter: pathes. If the 
settings are wrong, STarCall will call the CHAT and enables the caller to 
enter a message and to upload files.

The options:
Detect
Modem:		STarCall answers all calls and establishes a modem 
connection.
Fax+Modem:		STarCall is able to detect FAX now.
Voice, Announcemet:	STarCall plays a voice announcement, then it will 
start a modem/Fax connection.
Voice Record:		STarCall starts the "answering machine" modul and can 
detect Fax/Modem
Voice Mail:		STarCall starts the batch "ANSWER.BAT"
			with this batch you can program yourself what to do with 
calls.
			For example you can program a voice BBS or control a 
telephone machine.
			(Digital Secretair)

3.6.8	Fonts

STarCall uses different Fonts. When starting STarCall the font STARCALL.FNH 
will be loaded automatically, the font STARCALL.FNL is loaded when using a 
low resolution. Fonts can be used for window and fullscreen display.
You will find some more fonts in the folder "DFUETOOL\FONTS\". Click the 
button "LOAD FONTS" to load these fonts and select a font with the file 
selector. The number which is shown with the filename is the size of the 
font counted in pixels. Remember that a font should be smaller than 14 
pixels to use it with windows. 16 Pixel fonts should be used for fullscreen 
mode.


 

To save a selected font choose the button "OK and save", the font will be 
saved and will be used always. When you want to test a font, choose "OK", 
the font will be used but not saved.

You can use "STAD"-Fonts for STarCall. STAD is an older graphic program, 
but you will find many fonts of this format.
When using GDOS, you can select GDOS.Fonts and a size.
Important: You should always be able to display 80*24 chars. Please choose 
a font size which is confirm with this.

3.7	Config

STarCall offers many functions,which are only interesting for experienced 
users. We have placed all these options in a sub menu. Here you have access 
to all options of STarCall including the options found in the parameter 
menu. Now we want to describe all this options.

 
Bild "Konfigurieren"

The settings "Port+Seriell, Path, Transfer, F-Keys, Modem, Terminal, Font, 
Time and Calls" have already been described in the previous chapter.

3.7.1   User-Moduls

You can define up to eight often used moduls and programs for the "EXTRA"-
menu. Enter any text for the name of the modul which will be used in the 
menu. Then define the program or modul by clicking the button and select it 
with the file selector. I recommend to place the modul "VIEWFAX.PRG" and 
"STARBOX.PRG" here. You can execute a modul by pressing ALT + F1..F8. You 
also can enter points and batches here. The moduls will be found in EXTRA-
menu after leaving this dialog. You optionaly can define a starting time 
for each modul.


 

3.7.2	Printer

Here you can select printer type and form feed after printing.


3.7.3	Register

You can change your code here.

3.7.4	Buffer

When being online, all in- and outputs are written down in the buffer, you 
can read later again or check your work and text. The buffer can be edited 
and can be saved to disc.

You can select the size of the buffer with this dialog. If the buffer is 
full, there are three ways to continue:

ERASE: The buffer will be erased without question.
SAVE: The buffer will be saved and erased.
ASK:	You will be asked whether to save or to erase the buffer.
When saving the buffer into an existing file, data will be appended.
SAVE SOON: Buffer will be automatically saved to PUFmm_dd.TXT and be erased 
then. 

When enabling the filter controll-characters will automatically be removed.

3.7.5	Colours

When using a colour display you can modify the colors here. You have to try 
a little bit to get the correct result. You will see the result in the 
window "Preview" to verify the setting. Often it is usefull to enable 
"invers" for a black background.


3.7.6	System-Password:

You can protect your settings against access with a password. After 
defining the passwort you have to save the settings.
When restarting STarCall now, you will be asked to enter your passwort. 
Without this password personal data will be locked (F-Keys). This is 
especially usefull for computers used by many persons. Who does not want to 
look for other peoples passwords.... ?

3.7.7	Telephone charge

Whenever you see the telephone costs, you will know that there are some 
tarif zones depending on distance. Also there are time tarifs for day- and 
night calls and weekends.
STarCall can calculate your telephone costs, when you enter your telephone 
charge here.
This works the following way:

First select zone 0 for local calls. Enter value and duration for one unit. 
Then enter the valid times for this.


 

Example (D):	Price of one unit: 23 Pf.
Zone:		0	1	2	3
Cheap  tarif::	720	120	42	16 Sec
Normal:	360	60	21	12

You will find a list of prices in your telephone book. 

3.7.8	Tek

Here you can enable TEK calls and define starting parameters and sequences 
STarCall should use.

3.7.9	Sounds

STarCall can connect some events like "Login, Logout, Transfer and Start" 
with sounds. Select which file should be played. Possible file types are 
.AVR, .ZYX, .X32 and .MOD. You have to install the extra porgram "PAULA" 
for playing ".MOD" file types. You will find it in many BBS systems.
When you do not define sounds, STarCall uses some internal beeps.

3.7.10	Desktop

Here you can set options for system and desktop:

Screen saver: When enabling this, STarCall will invert the screen after 1 
Minutem when you do not press any key durings this time. This will protect 
your monitor from getting a burned picture in its phosphor layer. When you 
continue working, the screen will be displayed normal.

DTR off when quit: This will allow STarCall to drop the DTR line when 
finishing STarCall. Some modems will switch off this way.

Editor word wrap: When the cursor approaches the right border of the 
editor, it will move to the next line.

Warning bell: The VT100 emulation knows a character for playing a short 
"beep" sound. You can disable this here.

Multrix: Enables StarCall to start multrix.

hide desktop: This will disable the STarCall desktop and icons and allows 
access to the system desktop.

No sound: You can disable sounds here.


3.8	Menu Extras

3.8.1	Logfile and Calculator

During every session with STarCall it will sum up calls and telephone 
costs. You can see the current counter here and calculate costs for other 
months. STarCall calculates automatically the costs of the current month, 
you can select other monthes with the buttons.
The list has a maximum length of 256 entries to avoid a memory overflow. 
When the list gets longer than 256 entry, the oldest entry will be removed. 
The list will be saved when you quit StarCall.
STarCall calculates the costs using the online time. As this time will 
never run 100% synchron to the real online time, STarCall perhaps 
calculates one unit more or less than you really have used. This can not be 
avoided because of hardware reasons.

The data is saved in the file "STARCALL.LOG". You can edit this file using 
a text editor.

3.8.2	Create Autologin

STarCall can generate and learn batches automatically. There are two 
possible ways, the "manual" and the "learn" mode:

When creating a batch manually , you have to enter a text the batch should 
wait for and a text which should be answered.
Example: You know, you are asked for your name and password when you log 
in. You can enter something like this:

Wait for...			Send
Username:			Mr. Bean
Password:			hello

Then click the button "Save batch". To use this batch now, you have to 
enter it into the list of telephone numbers.

When you like an easy way, StarCall can automatically learn a batch. 
Therefore enable this option before dialing a BBS. Then select the filename 
for your batch file with the file selector.
Now dial the BBS and log in as usual. Then select this option, which is 
checked now, again. The batch will be saved now, and can be entered in your 
telephone list, if you want to start it after the next dialing.
This method of creating a batch has one disadvantage: it is not very 
flexible, and will not run allways. Only simple commands like "WAIT", 
"PRINT" and "PAUSE" will be used. Of course you can edit the batch later 
with the editor.


3.8.3 Clean Desktop

This menu cleans the desktop. All icons will be moved back to their default 
position. By the way: The position of the icons is saved, too, when saving 
the settings.


3.8.4 Help

This will call the online help..

3.8.5 Fax

STarCall is able to send and receive FAX, when you have got a FAX CLASS 2 
Modem. FAX will be received automatically, when the option of "ANSWER 
CALLS" is enabled, otherwise you can receive a fax manually here.
This menu will be used for sending a fax, too. STarCall uses the modul 
"STARFAX.PRG" for sending fax files. You have to verify the path in 
"Parameter: Path" to use this function.
You will find more about sending fax in a later chapter.

3.8.6	Voice

When you are the owner of an ZyXEL or compatile voice-able modem this 
function will be interesting for you: It enables you using your modem as 
FAX, MODEM and answering machine. Read chapter 6 !

3.8.7	Moduls

The follwing menus are reserved for personal entries. You can define these 
entries with the function "config user moduls".

CHAPTER 4
4	Batch Files
4.1	What is a Batch ?

We equipped STarCall with an internal programming language. With these 
programs you can program often done jobs, for example logins. STarCall 
programs, called "Batch" are simple ASCII-files, every line contains one 
command. When the first character is an " ;" you can append a comment.
Batches are launched with the function "Load batch" or can be executed from 
the numbers list. A running batch can be canceled with the CONTROL-key.
STarCall batches are more efficient as they seem to be on the first view. 
Many special modem commands offer phantastic possibilities, for example for 
voice mode.
For example you can program:
- an automatic login.
- message polling
- a voice-mailbox
- a telephone information system
- a Fax-information system
- when owning a telephone machine you can use your computer like a digital 
telephone secretair:
   The computer answers calls, plays an announcement, and connects to a 
selectable partner which
   can be selected via tone dialing. Modem and Fax can be received.


4.2	Automatic Creation of Batches

To enable beginners writing a batch, StarCall can learn loginbatches 
itself. We allready have described this way in chapter "learn autologin".

4.3	Manual start of a Batch

Batches can be executed manually or automatically. To start a batch the 
first way is to select the menu "EXECUTE BATCH" , the batch will be started 
soon and can be stopped with CONTROL. You may skip batch commands with 
ALTERNATE.

4.4	Self-running Batches

When you enter a batch file name in the list of phone numbers, it will be 
executed after dialing.
A different way of running batches is the installation as an user modul. It 
is possible to enter a time there, this enables you to run a batch dayly to 
a certain time.


4.5	Programming your own Batch

Often, for example for a point job, a simple login-batch is not enough. 
Then you have to program your own batch. Programming ??? Dont worry, it is 
not very difficult. When you are already fit in data transmittion, you will 
like the features of batches.
Batches are usual ASCII-files and can be created with the text editor. A 
batch is a list of many commands. The batch language of STarCall can be 
compared to easy programming languages like BASIC or PASCAL. Every line is 
one command, STarCall executes these commands step by step. Many commands 
have optional parameters, we will describe this later.
A line can also contain comments and labels. A comment begins with a " ; " 
, a label with a " : " , you will see later.
STarCall can manage variables from A to Z. A variable is a place for a 
value STarCall can calculate with. STarCall calculates with integers which  
value  between +/- 2147483647.

So: A batch is a list of commands. There are different kind of commands, we 
define usual commands called procedure and functions. A command will be 
executed, a function will do the same but has a result value. Some commands 
may be used as function and as procedure, for example:

a function:
 X := ALERT "[1][Test][OK] "
or a procedure.
ALERT "[1][Test][OK]"

4.6	The commands:

Now the list of batch commands of STarCall.

First some functions of math:

Definitions:

X := 1

The variable X is set to the value 1.

Y := X+2

X was value 1, so  Y will be set to 1+2 = 3 .
+ is an math operator. Other operators you can use in StarCall are:

+ - * / ( )

Logical Operators:

This operators are used for comparison (see command IF ) 

 AND , OR

are logical AND and OR.
Example:
IF (X>5) AND (Y<2) THEN END 

 >=  <=  <>

When X>5 and Y<2 at the same time, then the batch will end.

Example:
X := 3
Y := X*2+1

here X ist set 3 and after that Y is set to 7.

FUNCTIONS

Now a list of commands and functions.

REM text

use this to insert a comment text. This command does nothing. You may use a 
semikolon for this, too.

Example:
REM This is a comment.
; This is an other comment.



VAR text

Var can be used to define a list of variables. In the current version of 
STarCall this is similar to a comment, but perhaps it can be used for local 
variables later.

CALC intexp

this will calcultate an expression and display its result.

ALERT alerttext

Displays an alertbox and waits, until you select one of three buttons with 
the mouse. An altertext has this format:
 [2][Line1|Line2|Line3][BUTTON1|BUTTON2|BUTTON3]
The number between the first brackets defines a graphical symbol. This 
values are possible:
0: No symbol, 1: ! , 2:  ?, 3: STOP-sign.
The maximum is 5 lines with 30 characters and three buttons with 8 
characters.
Alert can be used as command and function. 2 Examples:

ALERT "[1][Hello World][ OK ]" 
X  := ALERT "[1][Select YES or NO][ YES|NO ]"

The first example displays "Hello world" and waits for "OK".
The second example waits for YES or NO. When selecting YES, X will be set 2 
1, NO will give result 2.

ASCIISEND filename

This will send a ascii-file to modem.

BEEP

makes a beep-noise.

DIR filename 

Displays the current directory. You can optionally append a path and a file 
name (like MSDOS).
Example: DIR "*.*"

LS filename

Is similar to DIR.

CALL batchfile

The batch will be finished and a new batch will started.

CD path

Changes the current drive and path.
Example:
CD C:
CD C:\AUTO
CD 

CHDIR path

same as CD.

ECHO text

Displays the text or expression in terminal window.
Example: ECHO "Hello world"

END

The batch will stop.

GOTO Label

Jumps to the line of the batch with the label LABEL. A label is written as 
":" followed by one word.

:MARKE
ECHO "Hello World"
GOTO MARKE

This is a nice special case, a never ending loop. What happens? "Hello 
world" will be displayed. The next step is GOTO which continues at the 
label "MARKE". Then "Hello world" is displayed again, etc....

IF boolexp  THEN ... ELSE ....

This command is called "condition". When the expression after IF is true, 
then the command after THEN will be executed, otherwise the command after 
ELSE. Example:

X := 1
Y := 2
IF X>Y THEN ECHO "X is greater than Y" ELSE ECHO "X is smaller than Y"

What will be the result? As X is not greater than Y, "X is smaller than Y" 
will be displayed.
The part with ELSE is optional, you need not use it, if nothing should be 
done. Example:

X := 0
:COUNTER
X := X+1
ECHO X
IF X<10 THEN GOTO COUNTER
END

This program displays the number 1 .. 10. The variable X is used like a 
counter. X will be increased by 1 and displayed after that. Then we use IF 
to compare it with 10. When X is smaller than 10, we repeat at label 
COUNTER.

IF ... ENDIF

This is a different way of using IF:

IF boolexp
	...
ELSE
	....
ENDIF

The difference: You can insert more than one command between IF and THEN. 
You have to define the end of the condition with ENDIF.

BAUD bps

Sets transfer speed to modem.

MEM

MEM is a function, its value is the free memory in bytes.

DIAL number

This will dial the given number once. The possible results are defined as 
constant values. This example will dial the number "12345" until a connect 
was possible.

REPEAT
	D := DIAL "12345"
UNTIL D=CONNECT

DOWNLOAD path

This will call the modul for receiving a file. You can optionally define a 
path for downloading the file.

EXIST file

The result is TRUE, when the file exists, otherwise FALSE. Example:
IF EXIST *.TXT = FALSE THEN ECHO "Nothing found".

MV   s.move

MOVE file1 file2

renames file1 to file2.

CP   s.copy

COPY file1 file2

Creates a copy of file1 with the name file2.

KILL filename

The file will be erased without question.

NEW

Erases all variables.

UPLOAD file

Sends the file with the current protocol.

PAUSE seconds

Waits a number of seconds. Example: PAUSE 1 waits one second.

PRINT text

sends a text line to modem.

PUT byte

Sends one byte to modem. Example:
PUT 33

PUTCHAR Wert

same as PUT. Here some values:

1 = Control+A
3  = Control+C
13 = Return
24 = Control+X
27 = ESC
32 = Space
65..90 = A..Z

RUN filename

runs a programm "filename".

WAIT text1|text2|text3

Waits, until one of the text is received. Use | to seperate the text.
Example:

X := WAIT "OK|ERROR"

Waits for OK or ERROR. The result is 1, when OK has been received, or 2, 
when ERROR has been received.

TIME

The result is the current time as decimal value. 141529 means 14:15:29

DATE

The result is the current date as decimal value, 22.03.1995 will be 220395.
The functions date and time are usefull for voice commands, for example for 
time controlled announcements.

DAY

The current day ( 0 = Sunday, 6 = Saturday)

PLAY filename

A sound file will be played with speaker. You can use usual sound files ( 
.SAM, AVR und X32 ). You can use .MOD-files when PAULA is installed.

SAVE filename

Saves the buffer.

WRITE text

Sends the text to the modem without linefeed.

QUIT

Quits STarCall.

VOCINIT

Switches your modem to voice mode. This command must be used before using 
one of the other voice commands. The modem will be set to the default voice 
settings.

VOCOFF

Switches the voice mode off. This command must be used as the last voice 
command, and must be send before data transfer.

VOCPLAY "datei.zyx"

Plays a voice file.

VOCREC "datei.zyx"

Records a voice file. You can use "?" as wildcard, StarCall will insert 
random numbers.

VOCTEST n

Waits for the input of v digits per tone dialing, example

X:= VOCTEST 4	;Waits for 4 digits.

ANSWER FAX

Answers a fax or a modem call.

HOOK

will hang up.

HANGUP

will hang up.

Variables

The variables A to Z are memories for numbers. STarCall stores 32 bit 
integer values. You can set a variable using ":=" to a value or functional 
result. Example:

X := 1
X ist set to 1.

String variables:

String variables are used for text (Strings). They must begin with $
Example:

$X	:= "Hello,"
$TEST	:= "World"

You may connect 2 strings with ^ :

ECHO $X ^ $TEST

will write "Hello, World".


Constants:

For easy programming and better readable programs we defined some constants 
which are interesting for dialing and VOC.... commands.

BUSY TRUE ERROR   :=-1
FALSE             :=0
CONNECT           :=1
DATE		= current date (020295)
TIME		= current time (133024)
$NUM		= current BBS nr.
$SYS		= current BBS name


You can use F-Keys for batches between strings:

$F01 - $F10 represent F1-F10,
$F11 - $F20 represent SHIFT & F1-F10.

PRINT $F01

CHAPTER 5

5	Zyxel-Voice Functions

This chapter is interesting for owners of Zyxel or compatible modems with 
voice abilities. You will need an ATARI with 38400 bps on the serial port 
(For old Sts you may get new hardware for $40) or a Zyxel+ or creatix 
modem.
Some new modems (Zyxel, Creatix) are able to digitize language, record it 
and play it. This opens new phantastic possibilities:
Your computer and modem can be used like an answering machine, Fax and BBS 
at the same time, StarCall detects the type of incoming calls.
First you have to enable the mode "Record voice" or "Announcement" in the 
menu "Answer calls".
Check your RS232 Settings, you should use 38400 Bps. When using a ZYXEL+ or 
Creatix, 19200 may be enough.
Then call the "Voice Modul":

 
"Voice"

When you use this modul the first time, you have to configure some 
settings, please click the "parameter" button. You now have to select one 
of the voice compressons ADPCM2, ADPCM3 and CELP. ADPCM3 or CELP will give 
the best results. CELP is only available with ZyXEL+ Modems, for using 
ADPCM2 and 3 you will need a speed of 38400 bps, which is only possible on 
old STs with a hardware extension. (RS Speed, RSVE).
Next you have to select, whether you want to record your announcement per 
telephone line or with a microphone, later more about this.
Last you have to define the maximum file length for messages in Kbytes to 
avoid that someone will speak a megabyte story to your harddisc. The 
maximum time can be calculated by dividing the maximum length with 
Kbytes/sec. For example when using ADPCM2 (1.2 Kbps) and 120 KB file length 
a message can be up to 100 seconds that is enough,
Now all required settings have been done, you will have to record an 
announcement now. There are two ways to do this, you select your way in the 
parameter menu.

1.) Record with a RJ 11-Micro.
  Either you put a microphone (nearly every type can be used) with a 
correct connection into the "LINE" plug, or you can use the telephone 
receiver: Remove your receiver from your telephone and connect it with the 
line plug. Then you have to speak in the ear-piece phone.
You can order an adapter for microphones or do it yourself: You have to 
connect the inner two contacts of the line connection to your microphone.


2.) Record from telephone line.
Here you have again two ways:
Let someone call you or call yourself  and click "RECORD" when it is 
ringing. Or click "OK" and call yourself, STarCall will send one beep-sound 
and begins to record your announcement now.

You can record a finishing announcement the same way (for example "Your 
message is recorded") and an error message ("The tape is full"). Use the 
button "PLAY" to test your announcements. You may record many announcements 
and select one by changing the filename.
You can define a code for checking messages using a tone dialer.
Now leave this dialog with "OK".

STarCall will answer incoming calls now, play your announcement and check, 
whether the caller is a modem, fax or human voice. STarCall will digitize 
the message of the caller and save it in your voice folder. A fax will be 
detected and start the fax modul. Modem calls will call the chat or 
"STARBOX". Later you can check the messages using the voice modul.

A nice feature isthat it is possible to check messages from a different 
telephone. Call your number and send a " * ".  When the phone does not 
support tone dialing, you can use a tone dialer, which you get in your 
telecom or electronic shop.
You will hear 2 beeps (Low, high) and have to enter a 4 digit number. When 
you enter the wrong code, STarCall will beep again, otherwise all messages 
will be played.

During a message is played, you can call this functions:

<1> Back to first message
<2> Repeat message
<3> Next message
<8> Quit and erase all messages
<9> Quit.
CHAPTER 6

6.1	Receive Fax

STarCall can receive faxes, when you have got a CLASS-2 compatible FAX-
Modem, and is able to receive FAX and MODEM at the same time.
STarFax is a modul for the Terminalprogram STarCall, but it can be used as 
"stand-alone" programm, too.
STarFax can be used in your own programs, and a tool for own fax drivers is 
also included.

6.1.1	How to install STarFax

When you do now have the original disc, or you want to install STarFax 
manually, read this chapter, otherwise you can skip the next lines.

- Unpack STarFax in any folder
- Copy the file "STARCALL.SET" to your root directory ('C:\'). This file 
contains some global settings for STarCall.
- Use any editor to change the path "SEND" and "RECEIVE" for sending and 
receiving fax files. The lines REGNAME and REGCODE are reserved for name 
and registration code. Read the file "REGISTER.TXT" for more information 
how to get this code.

Now save the file. STarFax is prepared for work now.

6.2.1 Receive a Fax

There are two ways to receive a FAX with STarFax:
1.)	Use the answering options of  STarCall. This enables you to receive 
modem and fax, perhaps even voice, with one telephone line.
2.)	Use STarFax as ACCessorie. Then you may receive FAX every time, 
independend from STarCall, but you can not receive modem calls.

6.2.2	Receive a Fax with STarCall

You have to check and perhaps to change the following parameters:
- Path: You must set the path for STARFAX.
- answer calls: Enable MODEM+FAX and the number of rings.
- The file "STARCALL.SET" should be installed.
- The "AA" - LED of your modem should be off ! When it is on, please enter 
in your terminal window:
	"ATS 0 = 0 &W".


STarCall now is prepared for receiving FAX + MODEM.
When someone calls you, STarCall will...

- answer the call after the selected number of rings.
- send a carrier sound and check whether this is a modem or fax call.
- When this is a modem call, STarCall will call STARBOX, when it is 
installed.
- In case of a fax call, STarCall will run "STARFAX" and receive the fax.
	The fax will be saved to your harddisc.
- When you have a voice modem (ZyXEL o.e.) , the voice option will be used.

STarCall can only answer a fax, while it is loaded into memory. When you 
quit STarCall, or when you switch off your compter, STarCall of course is 
not able to answer a fax.
When your computer supports multitasking, for example with MultiTos or 
Mag!x, you can run STarCall as task in the background and load other 
programs.

Hint: When you only have one telephone line, and you want to use it for 
FAX, MODEM and normal calls: Set STarCall to answer calls after 5 or more 
rings. Then you can use your phone as usual. When you hear that the call is 
a fax call ( it will beep) , you can answer the fax manually.

6.2.3	Receive a Fax with STarFax

You can answer a fax directly with STarFax, you can choose manual and 
automatical operation.

Manually: Run STarFax and click "Answer"

HINT: When you are in STarCall, you can call STarFax by pressing "ALT + 
F10" and receive a FAX manually.

HINT: You may use this for changing from a voice call to FAX. You only habe 
to click "ANSWER".

Auto-Answer a call: Copy the file STARFAX.PRG to your boot partition C:\ 
and rename it to STARFAX.ACC. After restarting the system you will find 
STarFax in the desktop menu. Select this menu to call STarFax, and choose 
the button for "OPTIONS". There you habe to enable "FAX ACC-mode". STarFax 
is able to answer FAX only, you can not answer modem calls.

6.3	Create a Fax

Before you can send a fax, you firstly have to create it. You can use 
nearly every text, graphic or publishing program, or a simple ASCII-editor.
Write your document as usual, and save it. How you have to continue depends 
on your program now:

6.3.1	Ascii, 1st Word Plus 2.x / 3.x

Use the fax driver "ASCII.PRG".
This program converts ASCII and 1ST WORD documents to STARFAX-files. When 
using 1st Word, text attributes will be converted. Pictures can not be 
used.
Every page will automatically begin with the FAX_HEAD.FAH file.

Again you have two possibilties:

-1- Run "ASCII.PRG" and choose your text file with the file selector.

or...

-2- Use the desktop and move your text file onto the ASCII-program.

Your text will be converted to a fax, this will need 10-30 secons with a 8 
MHZ ST.
The FAX can be send now using STARFAX or STARCALL.

6.3.2	Tempus Word

Call the menu "File - Print". Select the output device "QFAX". Then run 
printing. The document will not be printed now, but saved as a fax file. It 
can be sent now with STARFAX.

6.3.3	Calamus

Install the driver found with STARFAX "CAL_FAX.CDT". 

CAL_FAX will convert calamus documents into fax files. "CAL_FAX.CDT" has to 
be installed as a printer driver in "Calamus", you should copy it into your 
calamus printer folder.
Now select the driver with Calamus. When calling the function "Print", your 
file will be converted to a FAX file.
The FAX now can be sent with STARFAX.

6.3.4	Script

Offers, like Tempus Word, an internal FAX function.

6.3.5	Signum 3

Offers, like Tempus Word, an internal FAX function.

6.3.6	Stad / Degas / Doodle

Use the converting program "BILDER.PRG".
This program converts pictures to STARFAX files. The following formats can 
be used:

DOODLE	(.PIC , 32000 Bytes)
STAD		(.PAC)
DEGAS	(.PI1)

You have two possibilities:
-1- Run "BILDER.PRG". Select your file you want to convert. Or...
-2- Use the desktop and move your picture file onto the BILDER.PRG.

Your text will be converted to a fax, this will need 10-30 secons with a 8 
MHZ ST.
The FAX can be sent now using STARFAX or STARCALL.


6.3.7	IMG Grafikprogramme

Most graphic programs and many text programs are able to create IMG-files. 
You can read and convert these files with VIEWFAX or the IMG-driver.

6.3.8		QFAX

When you did not find your program, please check, whether your text program 
offers an internal Fax function. STarFax is compatible to QFAX, many 
programs support QFAX.

6.3.9		Other Programs

When your program does not offer a FAX or IMG export, and there is no 
driver for converting, you may try to use the HPFAX emulator, please read 
the document file.
When you still do not have success, please contact your distributer or our 
support line.

6.4		Send a Fax

To send a FAX call the STARFAX modul:


 

When calling STARFAX it will display the number of ready pages. Now enter 
the Fax number and click "SEND". Starfax will dial the number now and send 
the fax after connection.


6.4.1	The list of numbers

STarFax offers like STarCall a list of phone numbers for managing your FAX 
numbers. The dialog of STARFAX is like the dialog of STARCALL. Select an 
entry at the left side.

 

Then you can enter name, number and informations in the right dialog and 
accept with "OK".

6.4.2	Select FAX

When you have created more than one FAX file, but want to send only some of 
them, click the "Select" button. Now you can choose fax files.

6.4.3	Jobs

When you want to send same or different Fax files to many people, the JOBS 
will help you:

 

Select a name from the number list. You should enter the names to the list 
before using this function. In the middle you can select the fax files, 
which will be send. You may use "VIEW FAX" to look into your Fax, when you 
do now know, whether you have the right file.
Then click ADD to add it to the job list. The number of jobs will increase. 
Now you can select a different name, again some files etc... When you are 
ready click "OK". You can save your jobs, when you want to use them later.

6.5	Fax Options

You can select some options for sending a fax:

 
Stamp line:
This will enable STARFAX to send a short information line with every Fax. 
This can contain you name and FAX-ID and the receivers name.

Send cover:
With every FAX you can send a cover sheet including a short message.


Erase Fax after quit:
This will erase all fax files, after you quit STARFAX.

High resolution:
Here you can select the quality when sending a FAX. A FAX allways has a 
horizontal resolution of 200 dpi, and a vertical resolution of 98 dpi (low) 
or 196 dpi (high). So sending a high resolution fax will take more time 
than a low resolution fax.

Retries:
Here you can select the number of retries for dialing.

Pause seconds:
This defines the time between 2 tries of dialing. I recommend to enter a 
value between 30 and 60 seconds, because the called fax will need a pause, 
too.

Edit cover:
Here you can edit the cover which is send with every fax.

6.6	Cover 

STarCall is able to send a cover sheet with every fax file. It is possible 
to send a cover sheet without a fax file, too, this is usefull for sending 
a quick, short message.

 

You can enter your message into the text lines. Use the arrow buttons to 
scroll the text. You can use some variables:

%Name	Dialed name
%Nummer	Dialed number
%Myname	Your name
%Myid		Your number
%Date		Date
%Time		time
%Pages	Number of pages

With every cover sheet you can send a logo, for example a header for your 
letter, and a signature. Enable the buttons LOGO and SIGNATURE for this 
function.
You can create logos and signatures using a graphic program. Save it as IMG 
and import the file with VIEWFAX. Then select the function "Save as logo" 
to save it. You will find some demo images on your disc.

You can export covers to text file using "EXPORT", and import a text file 
using "IMPORT". You can edit the default cover sheet with the option menu.

6.7	Using STarFax for own programs

When you are a programmer, you can use STARFAX for your own programs. 
Configure your modem with "AT+FCLASS=2" to enable FAX/MODEM detection. When 
you receive a "RING", send "ATA" to modem. Now wait for "CONNECT" or 
"+FCON". When you receive "CONNECT", a modem connection is done. When you 
receive "+FCON" execute "STARFAX.PRG" with parameter "A".

6.7	Viewfax

Viewfax is a modul which can be used for viewing received and outgoing fax 
files, for modifying them, printing and erasing. It also can be used to 
convert graphic files (.IMG) into FAX, into logos and signatures.


 

The functions:

Load incoming fax:
This will show you a list of all FAX files you have received.New fax files 
are marked with a clock symbol. You now can select some FAX files with the 
mouse and display them by clicking "OK". You also can print or erase a fax, 
or use the GEM fileselector to load a fax file.

View outgoing fax:
This will load a fax you have prepared for sending.

Load IMG-Graphic:
This loads a graphic file.

Save as logo:
This will save the current document under the default logo file name.

Save as signature:
Saves the current window as signature.

Save as any fax:
This will save the current window using any filename. This can be used to 
save a IMG as FAX file, or to copy a incoming fax for sending.

Print:

This will print the current Fax. You can choose 3 usual printer types: 9 
PIN, 24 PIN and HP Laser. It is possible to use GDOS drivers, too.

Print all Fax files:
This will print all received fax files. Especially when you have received 
many fax files, this will be usefull.

Delete:
This will erase the current window and the fax file. There will be no 
security question to enable you to erase old fax files very fast.

Quit:
This will quit VIEWFAX.

Work:
Viewfax offers many functions for modifying a fax image.
Use the menu "Work" or the icons to select a drawing function.

Erase single Pixels:
This will erase single pixels, often a result from bad scanns of incoming 
fax files. You will get a better image after this.

Double high / width:
This will double the size of the current image, this is usefull for small 
picture files.

Display 1:2 / 1:3
This will zoom out the current window to enable you to see a bigger area of 
the fax.

Show info:
This will display some information about the current file.

Mark block:
This tool can be used to mark a rectangle area of your fax. Select the menu 
and move the mouse cursor to the upper left corner. Press the left button 
and move the mouse cursor down.

Eraser:
You may use this for erasing parts of an image.

Scroll:
Now you can use the mouse cursor to scroll the window.

6.8	Using the Fax-modul for programing own programs

Hello software developers! You can use Starfax and the modules with your 
own program this way:

STARFAX:
Use AT+FCLASS=2 to set your modem for FAX mode. Then wait for a RING and 
answer with ATA. Now detect the incoming text: When you get a CONNECT 
message a modem called, +FCON shows a fax connection. Then you can call 
STARFAX.PRG with parameter 'A'.

VIEWFAX:
The parameter is a option and a filename of a fax file. The options are:
-O	outgoing fax
-I	incoming fax
-P	print all new fax
-Q	quit when ready.
Example: VIEWFAX.PRG -O TEST.FAX

CHAPTER 7

7.1	STarBox+STarPoint introduction

STarBox:

STarBox is a menu controlled BBS program. This enables your computer to 
answer modem calls and offers the caller an easy user environment for 
sending and receiving fax and e-mail. We have tried to develop an easy to 
use BBS, which does not need much memory of your hard disc. The size of the 
program should allow installation on every hardware with 1 MB and a 
harddisc. When installing a bigger BBS with more than 50 Users and boards 
you should have 2 MB RAM.
For configuration and work with your BBS you usually will use the module 
STarPoint.

STarPoint:

STarPoint has two purposes of use:
1. When you want to install a bbs, you use STarPoint for working with it 
and for configuration of your system.

2. With ZCONNECT STarPoint allows you to install a "point".
With a point you can order message boards of your home bbs. The message 
base will be transmitted into your computer and you can read everything 
offline, edit mails and answer them. This is more effective and is less 
expensive than reading mails online in a bbs.

7.2	STarPoint Installation

Now you should decide, wheather you want to install a BBS or a Point. The 
way of installation is equal in most parts, so we want to do it in one 
chapter. In both cases you will need STarPoint for installation and work.

Installing StarBox and STarPoint is - compared to other BBS systems - quiet 
easy. The program modules are installed automaticaly from the original 
disc, or can manually be unpacked in any folder. Now the system is nearly 
ready for work and can be started. We assume you have installed and 
configured STarCall, STarBox and STarPoint are on your harddisc.

Now run the program "STARPOIN.PRG".  You are asked for your username und 
some data. The user-id is a short name, for example your first name or a 
pseudonym. Accept your account with "OK". Now a board called "Lokal" and a 
private message box (PM) will be created for you.

Attention: Please do not use the name "SYSOP". When a user trys to send a 
PM to SYSOP, it will be automatically replaced with your user id.

Now the most difficult part, the => STarBox configuration.

7.2.1 STarPoint configuration

First, before you can work with STarPoint or STarBox, some settings have to 
be made. You will find them under the menu "option".

Call all the menu functions step by step and read the following 
information:

* Header and Footer

Here you can enter a head- and footline for your messages. Every message 
you send will automatically be added to this text.

* F-Keys

Same function as on STarCall: Often used text can be placed on the F-keys.

* Editor

STarPoint offers an internal editor. If you prefer a different editor for 
writing mails, you may select the program file here.
It is possible to quote the original mail when answering a message.

* Transferprotokoll

Same as in STarCall you have to define transfer modules for your BBS, for 
example ZMODEM This is very important.

* Path

Here you must define the folder for archiver (LHARC) and transfer modules.

* Poll

This setting is important for net and point operation.

 


With nodename you define the name of your bbs. This name allows letters "A-
Z" , digits "0-9" and the underscore "-", spaces are not allowed. When you 
are a point, you have to enter the name of the home bbs = the bbs where you 
want to call. (poll)

When your system is a point or a bbs in a network, the following is 
neccessary:

The Servername is the name of your server, the system, where your want to 
get your data from.
When you are a point, this is the same as the nodename.

The netaddress is the full address of your system in the (inter-) net. The 
address contains the bbs and domain name, seperated by points. The exact 
address you may ask from your servers sysop when getting a account as 
point.

When your bbs is not in a network, you may ignore server name and address.

The options for new boards can be used to define a path for new installed 
boards. When ignoring this option, the current folder will be used. 
Normally you must not change this.

With system type you select the type of your system : BBS or POINT.


* Mailbox options

This option is for bbs operation only. Here you can change this settings:
- Password: Enables the passwort question for local login. The passwort is 
allways asked when you login with a modem.
- Return: Enables the PRESS RETURN message when login.
- Guests: This allows guests to use your bbs with loginname GUEST.
- Create all imported groups: This option enables ZCONNECT to create new 
groups while importing mails.
- Offline times: Here you can define times when your bbs is offline. Nobody 
can login at this time, a user will get a message.
- Polltime: only points can login at this times.
- Shell password: Here you can define a password for the command shell of 
STarBox.

* Net PM Routing

The Net PM routing you will need, when you want to connect your bbs with a 
network, more you can find unter -> ZCONNECT.

7.3	Working with STarPoint

STarPoint is an complex tool for working with your bbs and for ordering 
(poll) data from a BBS. After  starting it you will see a window with the 
available boards. For first trys a board "local" will automatically is 
installed, more borads you can create yourself or order from your server. 
But, what on earth is the purpose of a board ?


7.3.1 Boards and mails

Every BBS needs a order, otherwise work in a bbs is no fun.For this reason 
a bbs is devided up in boards and groups. These are assigned to a certain 
subject or program groups. ( for example Local, Atari, Software etc...)
Most times boards are public, every user can read and write. In many 
systems (including STarBox) you may limit access to a board, this can be 
done with the user level ( a number between 1 and 9 ) or with the user id.
For private mails every user gets a private message board. (PM). So every 
user can send messages, and the owner can read it.

The way you can swap mails with a network and your server will be presented 
later in the chapter "ZCONNECT".


7.3.2	 STarPoint menus

In the menu of STarPoint you will find all important functions, let us look 
at them step by step.

File:
Here you can find everything concerning files: Use "open" to load a 
textfile into the editor. You can safe the file with "save" or "save as".
"Print" will print the text of the selected window.
"Info" will display information of a selected object in the mail list.
"Copy" can be used to make a file copy of a mail, this is like download 
from a bbs.
"Delete" will erase a selected mail.
"Quit" finished the program.

Work:
Here you can find the usual functions for the editor, they work same as in 
STarCall.

Mail:
This are the most important functions of STarPoint, as they are used for 
writing and answering mails.

Post:  This will show you a list of your private mails.

Public Mail: This will open a window showing the public mails (boards).

Send PM: Here you can send a private mail to an user.
Send AM: Here you can send a public mail into a board.

In both cases you will be asked for the address and a short message info. 
You can choose to send a prepared text file, or use the internal editor. If 
you want to use the internal editor you need not select a file.

Answer: This function can be used to send a answer to the author when 
reading a mail.
Comment: This will send a public comment when reading a public mail,

It is usual to use a message info beginning with "RE:" when you answer a 
mail, because other users want to see that your mail is a reply.

It is possible for the sysop to send a letter to all local  users of  the 
bbs. You have to enter "#" to send a mail to all users, or for example 
"#345" to send a mail to users with user level 3-5.

7.4	Management

Here you will find all functions for setting up your system. This is very 
important when running a bbs, but also a point needs some work, for example 
erasing old mails.

7.4.1	Boards

Create new board
With this function you can create a new board. This is important when 
running a BBS; but less interesting for points. A point will order his 
boards from the server. When you want to create a new board, choose a name 
showing the purpose of this board. This will allow users a better work.
When using STarPoint the first time, automaticaly a board "local" will be 
created. Now it is your job to create some more boards. This also can be 
done with STarBox, but STarPoint is more easy. To create a new board you 
have to do  the following steps:

In STarPoint select the menu "create new board". Or use the board manager 
of STarBox.
You will be asked to enter the name of a board. For example you want to 
create a board ATARI in the group NEWS. So you have to enter "NEWS/ATARI" 
and confirm with OK.

 


Now the board editor is displayed allowing more options:

Name of the board in Z-Net:
When your BBS is connected to a network (see later), the name of a 
board in the net may be different from your local name. Normally both 
name are same.
Path:
Here you can define the file path of the board.
This can be the folder name only (for example "ATARI.BER")
or a full path ("C:\BRETTER\ATARI.BER")
In the first case the board will be created in the STARBOX folder.
Code:
Every board needs a identfier code for access to the file 
description. You can use the default value for this.

Level for read, write and list.
Here you can define access rights of a board.
A user will only get access to the board, when his user level is high 
enough.
When you enter 0,0,0 every user and guest has access.
The value for read : A user with this level or higher may read and 
download mails.
write: The user can write messages and upload files.
list: The board is shown in the board list and the user may look into 
the file list.

Password:
You can protect a board with a password, this will be asked when a 
user wants access.

Manager:
Here you can define a user for managinf the board. 
This user may edit mails and infos, and erase mails.
You can let this entry endefined.

Cruch:
	After a certain period of days or a maximum number of mails STarBox 
will erase old files.

Board type:
ASCII:
This Board type should be used for boards containing many text 
messages. The text files will be compressed to one file MAILDATA.DAT 
to save space on your harddisc.

BINARY:
This type is for software and files of all kinds.

TEXT:
This type is for text files, when only a small number of messages 
comes in. The files will not be compressed but stored in the normal 
way.

CD-ROM:
This type is for all kinds of CD-Roms. The user will se the full 
directory of the CD and can open all folders. STarBox reads the data 
from the CD directory, you need not upload the files. It is possible 
to change the file infos.

FREE DIRECTORY:
This is a little bit abstract type for experts. You can store the 
path to a file, so the file is not really in this board, but only the 
path and filename. This allows to put files from different data 
sources in one board, or you can allow access to a part of a CD-Rom.
To place a file in this board use the "data import" function of the 
management menu.


Access: You may define access for a user independent from his level.

Now confirm with OK to create the board.

Edit board
When you want to edit board data later, select it with the mouse in the 
board list and call this function. In STarBox you can do this after 
selecting a board.

Please do not change the path or code, as the descriptions will not be 
moved automaticaly.
You can change the board name, net name and other data, groups will be 
renamed correct.

Clear board:
All mails of a board will be erase.

Delete board:
The board will be removed. You are asked, if you want to keep the files.

Delete group:
This will delete all files and board displayed in the board list.

Check:
This will check a board for new and killed files.

Hint: You can copy files into a board from desktop and then use Check to 
update the file list.
This is sometimes faster then a upload.

7.4.2	Edit Users

An user can create an account himself with the function in STarBox. He will 
get userlevel 1 and the rights you have defined. You will get a short mail 
when a new user has logged in.
STarPoint and STarBox offer functions for editing, erasing and listing 
users.

When you are operator of a bbs you also can create "points", the user must 
get a user and a point account for this.

7.5 Working with STarBox

When your system is a point, this chapter is not interesting, you can skip 
it.
Normaly you will do most work on your bbs with STarPoint. When you want to 
get an impression of the online user interface, you can do a local login 
"consol-login". You will get the same environment as a online user. It is 
possible to edit the online menus, you can do this by editing the text 
files in the STARBOX.DAT folder.

There are 3 ways of local login:

1.) Call STarBox from STarCall by clicking the arrow in the status window.
2.) Run it from the desktop
3.) Define STarBox as user modul of STarCall, then you can quickly start it 
by pressing ALT and the function key shown in the menu.

After login you will be asked for your user id and password. Log in with 
the name you have entered in STarPoint or enter "GUEST". The password will 
only be asked with modem login, for a local login you may disable the 
password question.
Now the main menu is displayed. We have prepared some menus, you can change 
this with the menu editor later.

 

Account:
Press "A" to enter your user address.

Infos:
Here the user can find some information about the BBS, for example a short 
manual, the user list and a information text

Configuration:
Here the user can define his special settings, for example transfer 
protocoll, archive method, terminal type and special fonts.

Private Mail (PM):
You can send a private mail to an user of your bbs, this may be a text or a 
file. Therefore you can choose between file upload and a text editor. The 
editor is easy to use like most editors, you can exit the editor by 
pressing CONTROL+C. Certainly you can send net e-mails, when the system 
allows this.

Boards:
You allready should know the purpose of boards from STarPoint.You can use 
the arrow keys or enter the number of a board. You can use the news scanner 
for finding new mails since last login.

System management:
Here you will find functions for managing your bbs online,  like adding 
boards and users... See STarPoint.

Relogin:
Use this function to log in with a new user name.

Logoff:
This will finish your session.

Press the F-Key for STATUS once. Enter user level 9 for full access to all 
sysop functions.

7.5.1	Function keys

The bottom line offers some often used functions when a user is online.

F1: LOCAL
This function sets the BBS to console mode. When this function is selected, 
There is no output to the modem, so a user logged in will not see, what you 
are doing. When you login from your concole, this will be enabled 
automatically.

F2: SYSOP
This key will give a online user full sysop rights for a short time. This 
can be used, when a user is online and you want to show him the sysop 
functions. After logoff or pressing this key again the user gets back his 
old level.

F3: USERCALL
This button shows, that the user has called you.

F4: +TIME
This will give the user some extra time. The online time and left time you 
can see in the top line. When the time is 0, the user will be logged of.
Hint: You can define the online time for a user in the STarBox.Set file.

F5: CHAT
This will call the chat mode and enable you to talk to the user. You cam 
leave the chat with CONTROL+C.

F6: LOGOFF
This will finish the session and hang up the modem. Usefull when a user 
makes nonsense or you must do important things with your computer.

F7: STATUS
Here you can change the user level.
The user level is a value between 1 and 8. The user level defines accessing 
rights and maximum online time. Userlevel 9 is reserved for the sysop, 
allowing free access to all boards and files.

F8: SHELL
reserved, without function.

Of course the function keys are not visible for the user.

7.5.2	Placing data in your BBS

Of course your BBS needs some data and files you can offter your users. 
When you want to place a file into your BBS, select the boards with 
STarCall or STarPoint and select Send Mail or upload.
For text files STarBox and STarPoint offer an internal editor.
When you want to upload a file with STarBox, STarBox will not call the 
transfer module, but open the file selector. Now you can select one or more 
files to be copied into the board. Remember that STarBox perhaps will erase 
old files, when you enabled the crunch function of this board or harddisc 
is full.
An other way of placing files in a board is to copy them with the desktop 
into the board. After that use the check function, it will find this files 
and add a list entry.

7.5.3	Modem Login

OK, now you have configured your BBS and copied some files. To allow users 
to call your BBS, configure STarCall for accepting modem and perhaps fax or 
voice calls. STarCall detects the type of the caller and starts STarBox for 
modem calls.

Hint: With a private telephone center and two modems you can call yourself 
and test your bbs. When you have two Computers you can use a nullmodem 
cable them. When you enter "*login" in STarCall terminal STarBox will 
simulate a connection.

7.5.4	STarBox online configuration

When you are absend and you want to configure your bbs from modem login, 
you can do this with the system manager from the main menu. Call the 
function "general settings", this will load the STARBOX.SET file into the 
editor.

The option "EXTERN" allows to install up to 8 external programs for your 
system. This can be used for online games and system programs. Every 
program must be defined with an user level for access, for example:

EXTERN Description, filename.ext, userlevel

example:

EXTERN TETRIS, TETRIS.PRG, 9

7.5.5	Menu editor

It is possible to edit the menus of STarBox. You will find the used .TXT 
files in the STARBOX.DAT folder. You can use the MENUEDIT.PRG or any ASCII-
editor to edit the .TXT files.
Warning: These files contain some characters for the buttons. You should 
not change them, when you do not know how to do it.

Hint for experts: For every .TXT file there is a .DAT file. Here you can 
redefine shortkeys and the userlevel for the functions. The shortkeys in 
both files must be the same.

7.5.6	Some more hints

STarBox runs with MagiC and MultiTos. During users are online you have full 
access to the system and can login wit hSTarPoint.
You should make a weekly backup of STarBox and the user / board files.
When STarBox is not running on your system, check your configuration files 
and system memory.

CHAPTER 8

8.1	Zconnect - Whats that ?

Zconnect (alias JANUS) is a method used by many bbs to swap data like mails 
with each other. Zconnect also is interesting for "normal" users:
You can create a "one man bbs" and call dayly or weekly your real home bbs, 
which will send all new messages. Your system works like a copy of  your 
home bbs. It is possible to select the boards, if you do not want to read 
all messages.

Transfering all interesting messages is much faster than reading only some 
of them online. This saves telephone costs and with STarPoint you get a 
more comfortable way reading the mails.

Zconnect is a special way of changing the data and is supported by many 
systems (including PC) Ask the sysop of your home bbs for "Janus" or 
"Zconnect" login.

One more advantage: Most BBS offering a net are connected world wide, they 
have gates to other networks. This enables you to send e-mails and messages 
worldwide to any use in any network (Internet, Fido ...).

8.2	Address

When you want to send an e-mail to an user, you need his address. An 
address consists of the name and the system address, seperated by the @ 
symbol. Every bbs, user and poijt has an address of this format:

User and Points: Pointname @bbsname.domain

BBS: bbsname.domain

8.3	Prepare polling

The first steps are still easy:

- The ZCONNECT.PRG should be placed in the STARBOX folder. This is 
automaticaly done after the installation.
- For data transfer you need a compression program, for example LHARC.TTP. 
For this purpose you should have a folder containing your LHARC.TTP. In 
STarPoint you have to check the option "Path" to define this folder.
- Ensure that you have defined a bbs name. This name must be without spaces 
and special characters !

When you are connected to a network, you must define the domain address. 
You will find this in STARPOINT in the options for bbs. You have to enter 
the net address like this:

bbsname.domain.de

Replace the domain.de wirh your address. You should ask the sysop of your 
server bbs for correct data.

Now the interesting part:

8.4	How can somebody poll at my bbs ?

Recieving messages from a bbs is called polling.

- The person who wants to poll must be user of your bbs with userlevel >= 
2. The user type must be set to "point".
- The user must order some interesting boards to receive new mails. There 
are 3 ways to do it:
1.) The sysop (YOU!) can do this with the user editor.
2.) The user can do this online in "configuration".
3.) The user orders boards with his point program using the MAPS function.

Thats it. Now the user can use his best point program (X-Point, The Dot, 
STarPoint...) to call your bbs and gets all new messages and mails.

8.5	I want to be point !

- Ask your sysop of the bbs you want to call to add you as point or bbs.
- As you want to send data to your server, you must tell STarPoint the name 
and address of your server.
You will find this in the polling options of STarPoint.
- Add an entry of type BATCH in the number list of STarCall. Define 
JANUS.BAT as batch name.
This batch organizes the call. You must exactly enter your username, 
password end the name of ths bbs you call.
When you run this batch from your number list, the following actions are 
done:
- "Export:" A buffer file is created containing all new mails for the 
receiver. The buffer will be compressed and stored in the "POINT" folder.
- "Dial:" STarCall dials and logs in.
- "Exchange" of the data with your definded protokoll, for example 
"ZMODEM".
- "Import:" The data will be uncompressed and imported.

Every action is protocolled in the file /STARBOX.DAT/ZCONNECT.LOG. When 
something gets wrong you will find a error list here.

8.6	How to connect a bbs to a network

When you want to connect your bbs to an network, you first should call the 
sysop of your server and ask him what do do at his bbs. After that you have 
to do the following steps:

Edit the file STARBOX.DAT\ROUTE.DAT or call the routing option of 
STarPoint. Here you have to define, to which systems a PM can be delivered 
(routed).

On the left side you have to enter a bbs or domain name, the right side 
defines the node where the mail is send to.

Example: Your bbs is called ICC.
You are polling at the system GANYMEDE, and you are called from a bbs 
called SSONIC.
Ganymede offers access to the domain DE and SUB, unknown addresses will be 
send to ganymede, too.

You have to enter:

DE	-> GANYMEDE
SUB	-> GANYMEDE
SSONIC -> SSONIC
*	-> GANYMEDE

The reason for this:

For example a user of your bbs writes a mail to "FRANK@do.maus.ruhr.de". 
Your system does not know the "do.maus.ruhr", but knows that ganymede has a 
way to the domian "DE".
So the PM will be placed in the file for GANYMEDE, and GANYMEDE will do the 
rest.

When you are a "end system" (No bbs is polling at your bbs) one entry is 
enough:

*	-> SERVER

Where server is the name of your server bbs.

Now the pollling can begin. You will need some time when doing this the 
first time.

Hint: Errors are listed in the ZCONNECT.LOG file.

8.6	MAPS

Maps is an "automatical" user in your bbs. Points and BBS can send a PM:

MAPS@bbsname

You should enter the comment "LIST". With the next poll you will get a list 
of all boards.

When you enter "ADD" as mal description, you can send a list of boards with 
this mail, maps will add this to your ordered boards. With "DEL" you can 
disable boards.

With "HELP" you will receive a mail with a detailed description of maps.

To complicate? No problem, there is a more easy way:

You can call the function "Order boards". STarPoint will generate a mail to 
MAPS and order the list of boards. With the next poll it will be send to 
the server, who generates a answer some minutes after your poll. When you 
poll next time, this list will be send to you as PM. Now you can call 
"Order baords" again, and see a list of the boards. STarPoint now generates 
ADD and DEL mails.

MAPS offers some more functions, try to send a mail to map with info "HELP" 
to get a full feature list of your server.

Remeber: MAPS generates the answer after logoff, you will get it with the 
next poll. You should allways get an answer.

8.7	Hints for experts:

A hint for experts: Zconnect can be called with a command line. Here a list 
of the features:
ZCONNECT.PRG IMPORT USERID		Import buffer file from the temp directory.
ZCONNECT.PRG EXPORT			Export of all new mails
ZCONNECT.PRG EXPORT CRUNCH:OFF	Skip crunch of old messages.
This is nice to modify the JANUS.BAT.
CHAPTER 9

9.1	VT-Emulation

This is a list of supported VT commands. This will not be interesting for 
beginners, but for programmers and experienced users, so we write it down 
here, too.

9.1.1		General ASCII-Codes


DLE  3      CONTRL+C
BEL  7      Beep
BACK 8      Cursor 1 Step left
TAB  9      Tabulator
LF   10     Next line
CR   13     Cursor to the left
ESC  27     enter escape-sequence


9.2.1	VT-52-Codes



ESC A       Cursor up
ESC B       ' down 
ESC C       ' right
ESC D       ' left
ESC E       Clear screen
ESC F       Special-Graphic
ESC G       US-character-set
ESC H       ' home
ESC I       up, scroll
ESC J       clear end of page
ESC K       clear end of line
ESC L       insert line
ESC M       remove line
ESC Y nl nc direct position, 
(s.Angang)
ESC b n     set color
ESC c n     background color
ESC d       clear begin of page
ESC e       Cursor on
ESC f       Cursor off
ESC j       save cursor pos.
ESC k       restore cursor pos.
ESC l       erase line
ESC o       erase begin of line
ESC p       Invers
ESC q       Normal
ESC v       wrap an
ESC w       wrap off
ESC =       Alternate keypad mode
ESC >       Normal

Printer:
ESC V       print line
ESC ]       screen
ESC ^       printer on
ESC _       printer off

Report:
ESC Z       Terminaltype test
  ESC / Z   report - type VT101
ESC <       VT-52 off VT100 
enable.




9.2.2		VT-52 Key table

This table shows speacial key codes and chars that will be sent. The 
original VT52 terminal has 4 F-Keys PF1-PF4, 4 cursor keys and a numeric 
keypad with "0-9", ".", "-", RETURN and ",".
The numeric keypad and the cursor keys can be set to standard mode and 
application mode by the host computer.


Normal Numlock
  0    ESC ? p
  1    ESC ? q
  2    ESC ? r
  3    ESC ? s
  4    ESC ? t
  5    ESC ? u
  6    ESC ? v
  7    ESC ? w
  8    ESC ? x
  9    ESC ? y
  -    ESC ? m
  ,    ESC ? l    Ins (shift 0)
  .    ESC ? n
Return ESC ? M

Cursor:

ESC A   (up)
ESC B   (down)
ESC C   (Right)
ESC D   (Left)
      
VT-52 F-Kkeys:

PF1  ESC P
PF2  ESC Q
PF3  ESC R
PF4  ESC S


9.2.3	VT-100 Codes


Scroll functions:
ESC [pt;pb r  set region
ESC [? 6 h    enable region 
(origin mode)
ESC [? 6 l    disable (full screen 
mode)

Cursor functions:
ESC [pn A     Cursor pn * up. no 
scrolling!
ESC [pn B     ' down, no scrolling
ESC [pn C     ' right
ESC [pn D     ' left
ESC [pl;pc H  Set cursor position
ESC [H        home
ESC [pl;pc f  set cursor position
ESC [f        home
ESC D         Cursor down, scroll!
ESC M         ' up, evt.scroll!
ESC E         = CR LF
ESC 7         store cursor 
position
ESC 8         restore position

Applications-/ normal Mode:
ESC [?1h    Cursor keys in 
Application mode
ESC [?1l    ' normal
ESC =       keypad keys in 
Application mode
ESC >       ' numeric

Character set:
ESC (A    UK char set as G0
ESC (B    US char set as G0
ESC (0    line char set as G0
ESC )A    UK char set as G1
ESC )B    US char set as G1
ESC )0    line char set as G1
ESC N     select G2 set for next 
character only
ESC O     select G3 set for next 
character only

ESC [0m   All attribute off!
ESC [1m   bold on
ESC [2m   light
ESC [3m   italic
ESC [4m   Underline
ESC [5m   blink
ESC [6m   blink fast
ESC [7m   invers on
ESC [8m   underscore on
ESC [22m  bold off
ESC [24m  Underline off
ESC [25m  Blink off
ESC [27m  Invers off
ESC [30m  black Foreground
ESC [31m  Red
ESC [32m  Green
ESC [33m  Yellow
ESC [34m  Blue
ESC [35m  Magenta
ESC [36m  Cyan
ESC [37m  White
ESC [40m  Black Background
ESC [41m  Red
ESC [42m  Green
ESC [43m  Yellow
ESC [44m  Blue
ESC [45m  Magenta
ESC [46m  Cyan
ESC [47m  White
ESC [48m  deep 
ESC [49m  high

ESC #3    Double High+width top 
half
ESC #4    Double High+width, 
bottom
ESC #5    Normal
ESC #6    Double width, normal 
high

Erase curor to... (Cursor doesnt 
move!)
ESC [K    end of line
ESC [0K   '
ESC [1K   begin of line
ESC [2K   erase current line
ESC [J    end of page
ESC [0J   '
ESC [1J   begin of page
ESC [2J   all screen

Tab stop:
ESC H     set Tab at cursor 
position
ESC [0 g  erase Tab at pos.
ESC [3 g  erase all Tabs.

Print:
ESC [i    * print page
ESC [0i   * print page
ESC [1i   * print line
ESC [?4i  * auto print aus
ESC [?5i  * auto print an
ESC [4i   * print controller off
ESC [5i   * print controller on

Requests / Reports
ESC [5n        request for 
terminal status
  ESC [0n      report - no 
malfunction
ESC [6n        request for cursor 
position report
  ESC [pl;pc R report - cursor at 
line pl, & column pc
ESC [?15n      request printer 
status
  ESC [?10n    report - printer 
ready
ESC [c         request to identify 
terminal type
ESC [0c        request to identify 
terminal type
ESC Z          request to identify 
terminal type
  ESC [? 1;0 c report - type VT100

Initial / Test:
ESC c       Reset
ESC [2;1 y  * power up test
ESC [2;2 y  * loop back test
ESC [2;9 y  * power up test till 
failure or power down
ESC [2;10 y * loop back test till 
failure or power down
ESC # 8     video setting (Text or 
many 'E's are shown)

Sets:
ESC [?2l    set VT52 on
ESC <       VT52 off
ESC [?3h    * 132 Spalten
ESC [?3l    80 Spalten
ESC [?4h    fine pixel-scrolling
ESC [?4l    fast scrolling
ESC [?5h    White background
ESC [?5l    black '
ESC [?7h    Wrap on
ESC [?7l    ' off
ESC [?8h    Key repeat on
ESC [?8l    ' off
ESC [?9h    * 480 scan line mode
ESC [?9l    * 240 scan line mode
ESC [?18h   * print form feed on
ESC [?18l   * print form feed off
ESC [?19h   * print whole screen
ESC [?19l   * Print only scroll 
region
ESC [20h    'newline' Mode:  LF, 
FF, VT, CR = CR/LF
ESC [20l    'normaler' Mode: LF, 
FF, VT = LF ; CR = CR)

LED Functions:
ESC [0 q    LEDs off
ESC [1 q    LED #1 on
ESC [2 q    LED #2
ESC [3 q    LED #3
ESC [4 q    LED #4

The original VT screen has a 
bottom line with this status data:
1) Status of  LED's
2) Status of keypads  (application 
mode /normal mode)
3) Status of cursor-keypad '

Control-Characters:
^O      shift out - selects G0 
character set
^N      shift out - selects G1 
character set


9.2.4	VT100 - Key table


Keypad:
0       ESC O p
1       ESC O q
2       ESC O r
3       ESC O s
4       ESC O t
5       ESC O u
6       ESC O v
7       ESC O w
8       ESC O x
9       ESC O y
-       ESC O m
*       ESC O l (PrtSc-Key)
.       ESC O n
Return  ESC O M

Cursor:  Normal    Numlock
   Up    ESC [A    ESC O A       
Up
  Down   ESC [B    ESC O B      
Down
  Right  ESC [C    ESC O C      
Right
  Left   ESC [D    ESC O D      
Left

   Up    ESC [A    ESC O A      
Alt 9
  Down   ESC [B    ESC O B      
Alt 0
  Right  ESC [C    ESC O C      
Alt -
  Left   ESC [D    ESC O D      
Alt =

Function keys:
PF1      ESC O P
PF2      ESC O Q
PF3      ESC O R
PF4      ESC O S


A '*' means, that function will be ignored.
ESC means decimal 27.
 Pn. pl and pc are variable of VT100.
They are send as digits ! A 0 can be ignored.
When Pn, pl, pc <= 1 , it may be ignored.

  N, n1, n2 are variablen of VT-52 emulation.
Here you send the value as byte+32 :
 1=!  2="   3=#    4=$   5=%   6=&   7='   8=(   9=)  10=*
11=+  12=,  13=-  14=.  15=/  16=0  17=1  18=2  19=3  20=4 etc.
All codes and reports will be handled correctly, sending key codes and 
status line is done by the terminal program.
You can get the VT100 emulator for own developments and own programs for 
the ATARI ST when asking the author.

9.2.5	The RS232 port

A normed V-24 port (=RS-232) offers 25 wires, which can be used.
They are connected as follows:

Pin  Name           Direction Use
1    -              -         Ground (Schutzerde)
2    TD             o         transmit data
3    RD             i         receive data
4    RTS            o         request to send
5    CTS            i         clear to send
6    DSR            i         data set ready
7    GND                      signal Masse
8    DCD            i         data carrier detect
9    keine          -         test
10   keine          -
11   QM             o         equalizer mode
12   SDCD           i         2.Carrier detect
13   SCTS           i         2.Clear to send
14   STD            o         2.transmit data
15   TC             i         transmit clock
16   SRD            i         2.recieve data
17   RC             i         receice clock
18   DCR            i         divided reciever clock
19   SSRTS          o         2.request to send
20   DTR            o         data terminal ready
21   SQ             i         signal quality
22   RI             i         ring indicator
23   -              -         -
24   TC             o         transmitter clock.
25   -              o         wait

The BAUD value of a port is the speed in bits per second (bps). The maximum 
number of chars (cps), which can be transferred per second, is 1 / 10 of 
this value: ( 8 Databits, 1 Start + 1 Stopbit)

CHAPTER 9

9.3.1	Troubleshooting

You have a problem? First read this chapter, before calling our hotline. We 
have collected some often done mistakes.

 
"My computer does not talk to me"
STarCall can not be installed
Check, whether you have selected a valid drive and directory when 
installing STarCall, and whether there is enough space on your 
harddisc.
STarCall can not be started
Has STarCall been installed completely? Are the files "STarCall.PRG", 
"StarCall.Emu" and "STarCall.Rsc" installed?
I get the message "... not registered !"
Enter your registration code again. Verify that the file 
"C:\STARCALL.SET" is installed, and check your registration code 
here, too.
The Modem does not accept data.
Press ome keys with open terminal window, and check the RD/SD Led. 
They should flash. Check your RS232-Setup. When this still does not 
work, connect your modem to Modem-Port1, and set the settings to 
2400/8/N/1/RTS, Modem1, Hardware: ST-komp. This setting should work 
allways. Now modify the settings step by step to your setting.
The Modem does not dial.
Check "Modem-Parameter". Enter "ATDP" for dialing.
Modem at telephone machine.
When using a telephone machine, change "ATDP" to "ATX3DP".
The Modem dials, but quitts soon, or responses "Connect" without connection
Your modem is set up wrongly. The CD-LED should be OFF when not 
connected. You can change this by entering "AT&C1&W".
I can not send or receive files
Verify pathes and transfer protocol.
I often get retry messages and timeouts.
This often is caused by a bad or overloaded telephone line. Try again 
a later time and a other BBS number. When this is allways, contact 
your modem distributer.
Uploading and sending fax make errors, but download is OK.
Please installl a patch, for example HSMODEM.

Hotline:	02363 - 55629 ,
Fax + BBS: +49  2363 2610

Perhaps the numbers will change end of 1996, try to send a letter or e-
mail.

9.3.2	Update service

STarCall will be updated monthly.
There are 4 ways to get an update:

1. Send a disc, stamps or money and an envelope with your address

Or...

2. When registered, send DM 5.- , and include
a note for "STarCall UPDATE,  Name"

Or...

3. You call our support BBS:

Update-BBS:	02363 - 2610	(+49 2363 2610)

Or...

4. You will find updates in some other BBS, for example.

Mailbox			Nummer		System

Maus DO:		0231 - 697214	Maus
			Stichwort: ATARI-TERMINALARG-SHAREWARE

You may send e-mails to Ingo Linkweiler@ DO or user INLI.

I recommend method 1 or 3.

9.3.3	Some BBS-commands

Some BBS do not use menus, but commands. These are commands for some BBS:

?		HELP
AREA *	  	Area list
AREA           new areas
AREA  <Name>   select area
DOWNLOAD <nr>  read file
HELP           HELP.
LIST           file list
LIST *         new files
READ <nr>      read message
WRITE          write message
POST Name      write to User
UPLOAD         upload a file
LOGOFF         Quit BBS
.              Leave editor

9.4	Modem-Commands

ATA		answer call
ATD	...	dial
	P	Pulse
	T	Tone
	,	Pause
	!	Flash
ATEn		Echo set
	E0	Echo off
	E1	Echo on
ATHn		Hang up
	H0	Hang up
	H1	Hook
ATIn	n=0..3	Infos
ATLn	n=0..7	set volume
ATMn		speaker
	M0	off
	M1	on until connect
	M2	on
	M3	on after dialing
ATO		get online (after +++)
ATSr=n		Set register r to value n
	S0=	Set auto-Answer to n (in STarCall please 0)
	S6=	Seconds before dialing (3)
	S7=	Time to wait for carrier (60)
	S8=	Pause for "," in Sec. (2)
ARSr?		read register r
ATXn		Result code options
	X3	Ignores  NO DIALTONE
	X5	Normal
ATZ		Modem Reset

AT&Cn		Carrier detect (CD) Option
	&C0	carrier allways on
	&C1	CD indicated Carrier
AT&Dn		DataTerminalReady (DTR) Option
	&D0	DTR ignore
	&D1	DTR off/on resets
	&D2	DTR off -> Modem hangs up
	&D3	DTR off -> Modem Reset
AT&Hn		Flow control
	&H0	off
	&H3	RTS/CTS
	&H4	XON/XOFF
AT&Kn		Error control
	&K0	off
	&K1	MNP3,4
	&K2	MNP4,5
	&K3	MNP4,  V.42
	&K4	V.42, V.42 bis
AT&Vn		Display profile n
AT&Wn		Store set in profile n

Read the manual of your modem for details.

9.5	Lexikon

ASCII     usual character format
ANSI      codes
BAUD      speed in Bits/sec.
BOOT-     System start
BTX       Service of (german) Telekom
BPS       Bit/Sec.
CPS       Zeichen/Sec.
DATEX-P   Netof (german) Telekom
DF       german for "Data transfer"
DEFAULT-  Standard.
DOWNLOAD  Receive a file
DUPLEX    Echo mode
HAYES     Modem command set
LOGIN     Connect to a BBS
LOGOFF    Leave a BBS
MAILBOX   German for BBS
ONLINE    being connected to a BBS
POINT     Program for swapping mails
SCROLLEN  Rolling screen
SHAREWARE Programs you may copy (PD)
STRING    Text
SYSOP     System operator
TERMINAL  Your computer
UPLOAD    Send a file
ZMODEM    Transfer protocol

9.9	Last words

Now I hope you have much fun using this program. As I allready said, we are 
waiting for further ideas. When you like STarCall, please show it your 
friends. STarCall can be copied and given to other users as demo without 
your code.
Copying an installed version is prohibited and usually not possible.

Ingo Linkweiler.

77


