Dec 312017
A simple Comm program, and BBS program.
File PCMODEM.ZIP from The Programmer’s Corner in
Category Communications
A simple Comm program, and BBS program.
File Name File Size Zip Size Zip Type
BBS.BAT 154 88 deflated
CONFIG.BBS 225 61 deflated
HELP 639 337 deflated
HELP.BBS 257 164 deflated
MANUAL.TXT 47535 11906 deflated
PC-BBS.EXE 26624 13562 deflated
PC-EDIT.EXE 20992 10732 deflated
PC-MODEM.EXE 37376 18536 deflated
STD.DIR 7824 538 deflated

Download File PCMODEM.ZIP Here

Contents of the MANUAL.TXT file



V 2.0 Dec 1986

Feel free to copy and share PC-Modem/BBS/Edit with others
so long as it is distributed in its unmodified form and
as long as no disk copy or duplication fee is charged.
The Author reserves the sole right to distribute this
software for profit.

If you find this software to be useful, and would like to
registrate for future updates and documentation, fill out
the registration form at the end of the manual and send it
together with $35 to Xware at the adress below.

1104 Bismarck Lane
Alameda, CA. 94501

Acknowledgements: Special thanks to Jerry Weltner for his
many good ideas in this product.

Copyright (c) 1986, Lutz Mller
All rights reserved


Introduction ...............................3
Installation ...............................4


Starting PC-Modem, .........................5
Review the communications buffer ...........6
Terminating a connection ...................6

Directory and communication settings .......6
Change name, phone number and rates ..6
Move or copy a directory entry .......7
Create a new phone directory .........7
Change communication parameters ......7

Auto-log-on macros .........................8
Wait for a call ............................9
Answer a call .............................10
Transmit, Receive a file ..................10
Direct connections without modems .........10
Starting PC-Modem with a specific entry ...11

The X-menu ................................11
Write, Print, Clear,Dos .............11
Edit, Terminal, Modem ...............12
Summary of modem control codes used .......14


Starting PC-BBS ...........................15
Commands for all callers ..................16
Commands for authorized callers ...........18


Appendix A: More on Macros ................20

PC-Modem, PC-BBS p. 2



PC-Modem is a general purpose, easy-to-use communi-
cations program for data transfer between computers equipped
with a modem or directly connected through its serial ports.

PC-Modem is designed for the IBM PC or compatible
microcomputers equipped with a minimum of 128 Kbyte RAM and
a disk operating system version DOS 2.0 or later. PC-Modem
can auto-dial/auto-answer Hayes Smartmodems or compatible

PC-Modem can automatically dial and log on to remote
information services or microcomputers. Telephone numbers
and individual communication settings are stored in an easy
accessible "Directory". Two phone rates for the first and
additional minutes may be specified. PC-Modem shows you the
cost of your connection in real time on its status line.
Log-on, File transfer with Xmodem/CRC protocol and capture
of data may be preprogrammed with macros.

PC-Modem captures incoming data automatically in an
communications buffer which may be reviewed, saved to a file
or printed.

PC-Modem permits exiting to the disk operating system
keeping PC-Modem in memory without disconnecting.

PC-Modem comes with two other programs:


PC-BBS is a bulletin board system with password pro-
tection for an unlimited number of users, a message box and
capability of file transfers using the Xmodem protocol. PC-
BBS is well suited as an electronic post-office system in
commercial environments through its password and log fea-
tures. Log-on, log-off times and user identifications are
recorded individually to a logfile. PC-BBS works well as an
answering system with PC-Modem on the calling site.


PC-Edit is a full-screen editor accessible from inside
PC-Modem for easy editing of incoming data. PC-Edit may be
used also independently from PC-Modem as a general purpose

PC-Modem, PC-BBS p. 3


The PC-Modem package comes with 7 files:

PC-MODEM.EXE The communications program
STD.DIR A default phone directory

PC-BBS.EXE The bulletin board system
HELP.BBS A help file sent to callers
BBS.BAT A batch file to start PC-BBS

PC-EDIT.EXE The editor
READ.ME Contains essential information
not covered in this manual

None of the programs is copy protected and they may be
backed up with the normal copy or diskcopy commands.

Copy all five files to a working diskette or harddisk
and guard the original in a safe place.

PC-Modem and PC-Edit must reside in the same sub-
directory. Add a copy of COMMAND.COM (the DOS command
processor) to the same directory. PC-Modem needs COMMAND.COM
in its directory to be able to exit temporarily to DOS while
retaining itself in memory.

Other necessary files are automatically generated by
both programs if not present:

PC-Modem generates 1 file:

- STD.DIR Phone directory and settings.

PC-BBS generates 4 files:

- USERS.BBS contains data of users
- LOG.BBS information of all callers
- CONFIG.BBS communication settings
- MAIL.BBS messages from users

Ignore these files; they are generated and maintained
automatically by the programs.

PC-Modem, PC-BBS p. 4



Start PC-Modem by typing PC-MODEM and . The
program starts initializing the modem.

The message "modem not ready - hit enter -" is
displayed if the modem does not respond. In this case either
your modem is disconnected, switched off or attached to
another communication port than COM1: . You may specify the
second port COM2: in the communication settings of the phone
directory. On start PC-Modem initializes using the first set
found in the directory.

PC-Modem now displays the main menu. Menu selections
are made highlighting the command option and pressing
. A faster method is provided by typing the first
letter of the command.

1. Select the "Directory" option in the main menu.

2. A directory with 16 entries appears. Select a commu-
nication set with cursor Up- and Down keys . Hit

The directory disappears and the control box in the
center of the screen indicates the communication set you se-

3. Select "Call" from the menu.

PC-Modem now initializes the modem and starts dialing.
The whole process is monitored in the controlbox. If no
connection can be made or no carrier is detected in 30
seconds, PC-Modem will automatically hang up and dial again.
Wait-for-carrier-time is 30 seconds by default, but can be
changed by the user. (See chapter "the X-Menu" ).

The program will redial until a connection is made or
until you enter any key interrupting the dialing process.

After a connection is made the menu screen disappears
and an empty screen appears with the message "Connected".
At this time you are connected and able to communicate with
the remote site.

If any log-on macros are specified in the settings,
they will start automatically the communication for you
entering names, passwords etc.

PC-Modem, PC-BBS p. 5

At any time you may switch back and forth between the
menu screen and the terminal screen:

F10 returns to the menu if you are in terminal mode.

ESC returns to terminal mode leaving the menu.


You may review your communications buffer at any time
looking back to information which scrolled already off the

PgUp jumps one page back in the buffer.

Home jumps to the beginning of the buffer.

End returns to where you left.


You may terminate a connection at any time by pressing
F10 to return to menu and then select "Hangup" to hang up
the phone.

You may leave PC-Modem by selecting "Quit". All of your
communications are saved in a buffer. On the bottom right
side of the menu screen you see the status of this buffer.
You can write the contents of this buffer to a printer or
save it to a disk file for further editing before quitting
the program. Your buffer can hold twenty to thirty pages
of text (48 Kbyte). If the buffer gets full it automatically
keeps the last 48 Kbyte for you. Option "X" in the main menu
selects a further menu with all of these options.


Change name, phone number and rates

After selecting "Directory", position the light bar
over a specific entry and hit the F2 key. The small cursor
will be visible inside the bar and you may now change the
name, phone number and phones rates of that directory entry.


Up to twenty seven characters may be entered for the

PC-Modem, PC-BBS p. 6


You may use spaces and the letters "- ( ) " to make
the phone number more legible, e.g. "(123) 456-7890".
Capital or lower case letters may be enterd instead of
numbers e.g. 800-PHONE would dial 800-74663. If the
twenty digits provided for the phone number are not
enough, you may enter more digits in the field 'Call2'
of the modem settings. (See "The X-Menu").


You can specify from 0.00 to 99.99 Dollars. The first
rate will be valid only during the first minute of
connection. The second rate will count after the first

Use BackSpace, Del and Cursor keys as usual to edit the
name of this entry, when finished hit and another
or the ESC key to leave the directory. The control
box in the center of the screen shows the new entry

Move or copy a directory entry

Pressing the F3 key, an entry may be moved or copied to
an other entry. Press F3, drag the entry to the new location
then press F3 again, to copy it to the new place.

Creating new phone directories

PC-Modem generates and uses a phone directory called
STD.DIR if nothing else is specified. You may create and
access additional directories when starting PC-Modem the
following way:

PC-MODEM filename

If a directory specified in filename does not exist,
PC-Modem will create it. Any time in the future you start
PC-Modem with this filename, PC-Modem will load this

Change the communication parameters

From the main menu select "Settings" a settings sheet
for the directory entry selected pops up and may be edited.
Highlited options may be changed with the '<-' and '->'
cursor keys.

PC-Modem, PC-BBS p. 7


This option selects the communication port you want to
use in this call. (1 and 2 are valid entries.)


Specify the baud rate; 110,300,600,1200,2400,4800
9600,19.2,38.4 and 115.2 are valid entries depending
on your modem and the remote site you are calling.

choose N,O,E for none,odd,even

Data Bits:
choose 7 or 8

Stop Bits:
choose 1 or 2

Most used settings are N,8,1 and E,7,1 with 1200 bauds
for speed.


Up to 12 wait-reply combinations may be chosen for
automatic log-on sequences. "Wait" specifies a character PC-
Modem is waiting for on the incoming line. If an incoming
character matches that specified in the wait column the se-
quence to its right of it (Reply) is sent over the line to
the other computer as a reply.

Wait characters are chosen from the complete ASCII set
of characters using the '<-' and '->' cursor keys and 'Home'
and 'End' keys. The first 31 characters are labeled by 2- or
3-digit abbreviations because these characters are not
visible. E.g. "LF" for linefeed etc..

Imagine the following dialog necessary to log on to the
data service XYZ:

Type your identifier ? QW1234

Enter your password > ASDFG

PC-Modem, PC-BBS p. 8

You would specify the following wait-reply sequences in
the setting sheet to call this service:

wait Reply
---- -----
? QW1234|

The "|" behind "QW1234" and "ASDFG" stand for the
key, one would hit after answering "QW1234" and

"NUL" as a wait character means "don't wait" but send
the characters specified in "Reply" immediately. This might
be useful logging on to some networks where one needs to
type one or two times .

Macro execution ends when PC-Modem encounters a NUL
wait character in combination with a reply line starting
with a space or which is totally empty.

Some commands of PC-Modem may be executed by log-on
macros as follows:

Command Reply sequence
------- --------------
Transmit file (textmode): {TT}filename
Receive file (textmode): {RT}filename
Transmit file (Xmodem): {TX}filename
Receive file (Xmodem): {RX}filename
Write buffer to file: {W}filename
Hangup: {H}
Exit PC-Modem: {EXIT}

See Appendix A: for more examples on macros.

The ESC-key finishes editing of the setting sheet all
changes are saved automatically by the program.


This command puts PC-Modem in answer mode. To any in-
coming call PC-Modem will answer the phone. If macros are
specified these will work as in call-mode.

Although PC-Modem can perfectly attend calls without
user intervention we suggest you use PC-BBS on the answering
side of the communications line. PC-BBS offers multiple
password protection and many other bulletin board features.

PC-Modem, PC-BBS p. 9


You may put PC-Modem immediately in answer mode on a
line already connected. This is necessary when the phone
connection is established manually and both sides agree
verbally in a modem connection at once without dialing or
waiting for a call. Selecting "Answer", PC-Modem switches
immediately to answer mode, both sides can hang up the phone
and let their modems and software continue the commu-


PC-Modem can exchange files with any other communi-
cations program or communication service capable of Xmodem-
protocol file-transfer or simple text file-transfer without
protocol. Xmodem is a popular technical protocol, standard
for transferring files error-free over the phone line. If no
error-correction is necessary a simple file-transfer for
text-files is provided by PC-Modem.

From the terminal screen return to the main menu using
the F10-key. Now select "Transmit" or "Receive". PC-modem
will ask you for the name of the file to transmit or the
name you want receive a file with. You may specify a drive
and directory pathname preceding the filename.

After entering the filename PC-Modem asks for the
method of filetransfer. Select between "Text" and "Xmodem"
using the cursor-keys. After selecting the method of file-
transfer PC-Modem switches back to the terminal screen and
monitors the file-transfer in progress.

You may cancel a file-transfer with the ESC-key. Using
Xmodem it may take up to 10 seconds until the program quits.
PC-Modem will cancel automatically if in 10 retries it was
impossible to transmit or receive a block (128 Bytes of

Receiving a file in text-mode is finished after
reception of an "SUB" - character (decimal 26) or after 10
seconds of no activity on the incoming line.


When computers are wired directly without using modems,
the initial "- message modem not ready -" might be annoying.
Apart from that time is wasted trying to initialize and
reinitialize the modem.

PC-Modem, PC-BBS p. 10

If the modem init string (see 'X-Menu' 'Modem') is
deleted or filled with spaces then modem initialization will
not be attempted by PC-Modem. This is only true for the
specific directory entry for which an empty init string is
specified. PC-Modem uses it's first directory entry on

startup as a default. (This may be changed on the
commandline starting PC-Modem.


You may specify the directory entry to be used directly
on the command line:


This would start PC-Modem loading the sventh directory
entry and would immediately starting calling (dialing the
phone). If the init string of this entry is empty PC-Modem
would switch directly to the terminal screen and start
executing macros (wait reply sequences) if those were
entered on the settings sheet.


By selecting "X" you enter another menu with a few
other options:


Writes the contents of the buffer to a file.


Prints out the contents of the buffer.


After writing the buffer to a file or printing it you
should clear the buffer to make space for the capture of
more information.


This option lets you exit to the disk operating system
without interrupting an existing connection. To return to
PC-Modem type "Exit" and . PC-Modem needs a copy of

PC-Modem, PC-BBS p. 11

the file "COMMAND.COM" in the same directory it was started
to make use of the DOS-option.


This selection invokes PC-Edit, a full screen editor
suited for editing received information written from the
buffer to a file. Beside its use in PC-Modem you can use
this editor outside of PC-Modem for other editing purposes.
Exiting PC-Edit returns you automatically to PC-Modem.


Some services need special settings regarding linefeeds
and or carriage returns. If your cursor does not advance to
following lines, but stays writing on the same line, or if
your cursor advances to following lines but does noit return
to the beginnign of the line try "LF-Auto" or "CR-Auto".
These options will insert missing linefeeds or carriage-
returns. If the text received text appears double spaced you
probably specified "LF-Auto" or "CR-Auto" when you shouldnt.
"VT52" emulates an VT52 terminal, "ANSI" an ANSI terminal


This option should only be used by experienced users
and users who know to use the HAYES modem instruction set.
Below we print only a short summary of options used in this
program. See the documentation of your modem for more

Init: ATE0V0Q0|

This string is sent to the modem every time
"Initializing modem" is displayed in the control box in
the center of the screen. This option should not be
changed. PC-Modem relies on digit result codes set by
"V0" for internal control.

If you use a HAYES modem supporting dial tone
detection, you may specify: ATE0V0Q0X4| for automatic
dial tone- and busy line- detection.

Call 1: ATF1S0=0S7=30D

This string is sent to the modem just before dialing.
You may change "30" to an other number between 0 and
255 which means the number of seconds PC-modem will
wait for a connection after dialing. 30 second might be

PC-Modem, PC-BBS p. 12

too long for local calls. Use the following string for
a simple modem selftest: ATF1S16=1C1D .

Call 2: |

This is the dial suffix sent after the phone number to
the modem. ("|" means ).

Wait: ATF0S0=1S7=30|

This string specifies the half duplex answer mode and
lets the modem answer the phone after the 1st ring.

Answer: ATF0S7=30A|

This control string switches the modem immediately to
answer mode.

Hangup: ATH|

This string instructs the modem to hang up the phone.

escape: +++

When on line the modem must be switched to local
command state to understand the hangup command. The
escape sequence switches the modem to the local state.

PC-Modem, PC-BBS p. 13


AT Start of commandline

A Answer call immediately

Cn n=0,1 Transmitter ON=1, OFF=0

En n=0,1 0=No echo, 1=Echo

Fn n=0,1 0=Half duplex, 1=Full duplex

Hn n=0,1 0=Hang up (ON hook), 1=OFF hook

Vn n=0,1 0=Digit , 1=Word result codes

Qn n=0,1 0=Result codes sent, 1=not sent

S0 0-255 Number of rings to answer call

S7 0-255 Waiting time for carrier

S16 0..2 Self-test

PC-Modem, PC-BBS p. 14


PC-BBS should be started with the provided batch file
BBS.BAT. To start PC-BBS type:


Starting PC-BBS this way is important for two reasons:

If a caller disconnects from PC-BBS the program
terminates but has to load again and wait for the next
caller. BBS.BAT provides a loop which guarantees reloading
of PC-BBS.

The second reason is the possibility of authorized
callers leaving PC-BBS and entering to the disk operating
system of the remote computer. BBS.BAT provides the dos-
command "CTTY". Under DOS-access "CTTY" controls the commu-
nications port.

Only for training purposes you may start PC-BBS
directly by typing PC-BBS and . Starting PC-BBS this
way permits exploring it without using a modem.

PC-BBS starts showing its copyright notice and tries to
initialize the modem. After 3 retries without success PC-BBS
starts operation as if a caller were connected.

If initialization was successful PC-BBS displays the
message "Waiting for call ..." and displays current date and
time. You may leave PC-BBS alone now. It will attend all
incoming calls and hang up and reload automatically. Typing
ESC would interrupt waiting and enter the program as if

PC-BBS hangs up and reloads when a caller logs out or
when the program recognizes 3 minutes of no activity.

After connecting, PC-BBS shows a sign-on message and
asks for the name of the caller and for confirmation of it:


Please enter your name ? ABCDEFG

ABCDEFG Is this correct Y/N ? Y


PC-Modem, PC-BBS p. 15

PC-BBS searches for the name in a file named USERS.BBS
and asks for the password if the name was found. Otherwise
PC-BBS will disconnect and reload.

The caller gets 3 chances to enter a correct password;
after 3 incorrect passwords PC-BBS will disconnect and


The first time PC-BBS is loaded and generates a new
USERS.BBS -file, the program only accepts the name NEW
and the password NEW. After this you may rename NEW to
your name by means of the command /CHANGE.

After successful identification of the caller PC-BBS
displays date and time the user was on the last time and
writes the user name, connect date and time to a logfile
named LOG.BBS. If this file does not exist PC-BBS will
create it.

After logging on the program shows the contents of a
file named HELP.BBS. This file contains a list of all
commands from PC-BBS. This file may be modified by the user.



This command lets you disconnect from PC-BBS. After
execution of this command PC-BBS shows you the time you were
on and disconnects. Disconnect time is logged in the file


A Caller may change his password by means of this
command. His old password is displayed and he may enter a
new one. Up to 8 digits are accepted.


A user of PC-BBS may send messages to other users.
After execution of this command the program will ask for the
name of the user the message is directed to. PC-BBS will
verify that this user is in its database (USERS.BBS). After

PC-Modem, PC-BBS p. 16

verification up to 15 lines may be entered, listed, edited
and saved. These messages may serve to inform other users of
specific files ready for them on the board and other short


A caller may read messages directed to him or written
by himself. After execution of this command all message
headers of messages written by the user or directed to him
are displayed. Message headers consist of the user's name,
the name of the sender and date and time the message was

A user may delete messages directed to him or written
by him. Only authorized users may read and delete any


Type this command if you want to send a file to PC-BBS.
PC-BBS uses the Xmodem protocol for errorfree filetransfer .
PC-BBS will ask for the name of the file to receive.
Existing files of the same name are overwritten. (But all
PC-BBS files are protected). After preparing PC-BBS to
receive the file with /XUP the user would initiate the
transmission of the file at his end (using "Transmit" in PC-


This command prepares the bulletin board for
transmission of a file. PC-BBS asks you for a file name to
transmit. (All PC-BBS files are protected from reception by
normal users). After preparing PC-BBS to transmit the file
the caller would initiate reception of the file on his side
(using "Receive" in PC-Modem).


Any filename preceded by the slash "/" will cause PC-
BBS to display this file. This feature may be used to set up
a complete information service with menus etc..

Files must not have extensions, drive identifiers or
pathnames. Only authorized users may see files with
extensions or on other drives or directories.

PC-Modem, PC-BBS p. 17


Each user in the programs database is identified by a
field called "status". Authorized users have status "0".
Normal users are identified by status "1". Status is defined
entering new users with /APPEND or when changing user
information with /CHANGE.


An authorized user may change name, password and status
of any other user. After entering /CHANGE , PC-BBS asks for
the user to be updated and displays his actual name,
password, status and the last log-on date and time.


New users may be entered to the bulletin board's user
file USERS.BBS by this command.


Authorized users may exit to the disk operating system
of the host computer entering this command. After exiting to
the DOS you may use all DOS-commands and may execute all
programs which do not use direct video addressing.

After using DOS the caller must return to PC-BBS typing
BBS . DOS-access should only be used on good
communication lines. In DOS a lost line causes the host
system to "hang" and PC-BBS cannot reload itself.


Any filename preceded by a slash "/" will cause PC-BBS
to display it. Authorized users may look in files with
extensions in their name e.g.:

/USERS.BBS shows users and their last log-on time.

/LOG.BBS shows history of all calls with names
and log- on/logoff date/times.

/CONFIG.BBS current configuration of PC-BBS.

/ shows a file named ""

PC-Modem, PC-BBS p. 18

Together with /APPEND and /CHANGE this command permits
full maintenance of the bulletin board from a remote site
through an authorized caller. Authorized users may use drive
and pathnames in file-specifications.


PC-BBS is initially configured for communications port
COM1:, 1200 Bps, no parity, 8 data bits and 1 stop bit. As
initial log-on message you will see only two dotted lines
with a blank line in between. You may change all these
settings with the command /SETTINGS. PC-BBS presents the
actual settings and you may accept them hitting enter or
change them to your taste.

Communications parameters and log-on message are
maintained in a file called CONFIG.BBS. If this file is not
encountered PC-BBS will generate it with the default

Changes in all settings will be effective the next time
somebody logs on.


This command maintains the modem control strings. They
should not be changed under normal circumstances. Following
settings are generated as default in the file CONFIG.BBS :

Init: ATE0V0Q0|
Wait: ATF1S0=1S7=30|
Hangup: ATH|
Escape: +++

After entering /MODEM, the program presents the actual
control strings and you may enter the new sequences. See the
"Modem" command in PC-Modem for more details on this

PC-Modem, PC-BBS p. 19


Study the following macro sequence to log on to PC-BBS
and then send a file called "INVOICES" to PC-BBS and receive
a file named "REPORT". The name of the user is "OFFICE X"
and password "XYZ12345".

wait reply
---- -----
? Y|
: XYZ12345|
> /XUP|
> /BYE|

The following macro logs on to the SOURCE data service
on Tymnet:

wait reply
---- -----
= D1|
@ C 12345|

"12345" stands for your terminal identifier, "ABC123"
for your Source-ID and "QRSTUV|" for your password.

You can try out your macros when you set up your modem
to testmode. Not all Hayes compatible modems can do this.
Put "ATF1S16=1C1D" as modem control string in "Call 1:".
Select "Call" from the main menu of PC-Modem and enter the
wait characters from the keyboard. You will see your macros
playing back the replies.

PC-Modem, PC-BBS p. 20


PC-MODEM, PC-EDIT, PC-BBS Registration Form

Please register my copy of PC-MODEM/BBS/EDIT Version 2.0 (SMM)
and send me the latest update and documentation.

name _______________________________________

address _______________________________________




telephone _______________________________________

Send this form and $35 to:

1104 Bismatck Lane
Alameda, CA. 94501


 December 31, 2017  Add comments

Leave a Reply