home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Share Gallery 1
/
share_gal_1.zip
/
share_gal_1
/
UT
/
UT140C.ZIP
/
MODEM.EXE
/
MODEM.DOC
next >
Wrap
Text File
|
1992-02-24
|
15KB
|
295 lines
██████████████████████████████████████████████████████████████████████████████
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
█░▒░▒░▒░▒░▒░▒▌ ■■■■■■ "MODEM" ■■■■■ ▐▒░▒░▒░▒░▒░▒░█
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
█░▒░▒░▒░▒░▒░▒▌ by Pinnacle Software ▐▒░▒░▒░▒░▒░▒░█
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
█░▒░▒░▒░▒░▒░▒▌ A Modem Control Module ▐▒░▒░▒░▒░▒░▒░█
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
█░▒░▒░▒░▒░▒░▒▌ ─═ FOR ═─ ▐▒░▒░▒░▒░▒░▒░█
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
█░▒░▒░▒░▒░▒░▒▌ Batch Files and Application Programs ▐▒░▒░▒░▒░▒░▒░█
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
██████████████████████████████████████████████████████████████████████████████
MODEM enables you to perform basic modem operations within a batch file, and
check the results using DOS ERRORLEVEL processing. A high-level language
(such a C, Basic or Pascal) can "shell" or "exec" MODEM and check the results
via the DOS return code.
Thus, you can:
┌────────────────────────────────────────────────────────────────────────────┐
│ │
│ ■ Automate modem-oriented operations such as late-night file-transfers │
│ │
│ ■ Easily add the benefits of modem control to your application program │
│ │
│ ■ Run MODEM as a simple terminal program │
│ │
│ ■ Test your serial ports or modem with the TRACE facility │
│ │
│ ■ Use MODEM as an auto-dialer │
│ │
│ ■ Support BBS operations │
│ │
│ ■ and more ... │
│ │
└────────────────────────────────────────────────────────────────────────────┘
Using MODEM in a batch file, along with an external protocol such as the Omen
Technology's DSZ program, you can easily create your own communications
program, with upload and download capbility.
██████████████████████████████████████████████████████████████████████████████
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
█░▒░▒░▒░▒░▒░▒▌ QUICK REFERENCE ▐▒░▒░▒░▒░▒░▒░█
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
██████████████████████████████████████████████████████████████████████████████
Usage: Enter the MODEM command at the DOS prompt, call it from a batch
file, or shell or exec it from an application program.
Format: MODEM port command (See also Extended Support for another format)
Example: MODEM 1 TERM
Commands: MODEM port SETBAUD baudrate
MODEM port GETBAUD
MODEM port ATcommand
MODEM port WAIT ATcommand [greeting-string]
MODEM port DIAL ATcommand
MODEM port RAMDIAL ATcommand
MODEM port CARRIER
MODEM port DSR
MODEM port DROPDTR
MODEM port PAUSE time-in-seconds
MODEM port TERM
MODEM port TRACE
██████████████████████████████████████████████████████████████████████████████
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
█░▒░▒░▒░▒░▒░▒▌ MODEM COMMANDS ▐▒░▒░▒░▒░▒░▒░█
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
██████████████████████████████████████████████████████████████████████████████
┌──────────────────────────────────────────────────────────────┐
│ NOTE: The examples shown below refer to COM1 and COM2 -- see │
│ the section "Extended Support" for notes about COM3 and COM4 │
└──────────────────────────────────────────────────────────────┘
Enter one of the following commands at the DOS prompt...
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM port SETBAUD baudrate
Example: MODEM 2 SETBAUD 1200
Action: Initializes modem port and sets it to the specified baudrate.
Use this command before any of the other commands so that your
computer's serial port will know what speed it should be at. If
your modem acts oddly afterwards, you may have to turn it off and
on and issue an AT command so that it can figure out what the baud-
rate of the serial port is. External modems typically do NOT have
any way of figuring out the serial port speed except by looking at
the first characters received and trying to figure out what speed
would make them look like "AT".
Returns: 0
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM port GETBAUD
Example: MODEM 1 GETBAUD
Action: Displays the baud rate that the port is set to.
Returns: 11 = 300 baud; 12 = 1200 baud; 13 = 2400 baud; 14 = 4800 baud;
15 = 9600 baud; 16 = 19200 baud; 17=38400; 25=Over 38400
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM port ATcommand
Example: MODEM 1 ATH1
Action: Sends AT command to the modem and waits for OK.
Returns: 0 if OK; 200 for any other response
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM port WAIT ATcommand [greeting-string]
Example: MODEM 2 WAIT ATS0=1
Action: Sends AT command to the modem and waits for an incoming call.
Returns: 11 = 300 baud; 12 = 1200 baud; 13 = 2400 baud; 14 = 4800 baud;
15 = 9600 baud; 16 = 19200 baud; 255 if user pressed ESC to cancel
Notes: 19200 baud does not function reliably on 4.77 Mhz machines.
The greeting-string, if specified, is transmitted at connect time.
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM port DIAL ATcommand
Example: MODEM 1 DIAL ATDT1-514-345-8654
Action: Sends AT command to modem and waits for connection to remote system.
Returns: 11 = 300 baud; 12 = 1200 baud; 13 = 2400 baud; 14 = 4800 baud;
15 = 9600 baud; 16 = 19200 baud; 255 if user pressed ESC to cancel
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM port RAMDIAL ATcommand
Example: MODEM 1 RAMDIAL ATDT1-514-345-8654
Action: Same as DIAL, but dials until connection, or until ESC is pressed.
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM port CARRIER
Example: MODEM 2 CARRIER
Action: Checks for presence of carrier.
Returns: 0 if carrier present; 1 if not present
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM port DSR
Example: MODEM 1 DSR
Action: Checks for presence of dataset ready (modem turned on).
Returns: 0 if ready; 1 if not ready
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM port DROPDTR
Example: MODEM 1 DROPDTR
Action: Lowers Data Terminal Ready. This hangs up most brands of modem,
though you should follow up with a "PAUSE" command to give the
modem time to complete the disconnect.
┌─────────────────────────────────────────────────────────────────┐
│░ VERY IMPORTANT NOTE: If you are using a modem with built-in ░│
│░ error correction or compression, dropping DTR does not ALWAYS ░│
│░ hang up the modem -- if the protocol negotiation fails. This ░│
│░ exquisite little bug in the firmware of some modems has cost ░│
│░ some companies a lot of money in long-distance bills. Don't ░│
│░ let it catch you! When in doubt, follow up DROPDTR with a ░│
│░ PAUSE, then ECHO +++ >COM1, another pause, then ATZ. ░│
└─────────────────────────────────────────────────────────────────┘
You can restore DTR by issuing almost any other MODEM command, such
as setting the baud rate, entering TERM mode, etc.
Returns: 0
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM port PAUSE time-in-seconds
Example: MODEM 2 PAUSE 15
Action: Monitors the modem for incoming characters, which are displayed,
until the time is up or the user presses spacebar or ESC.
Returns: 0 for time-out; 254 if user hit spacebar; 255 if user hit ESC
(Some alternative pausing utilities are available from Pinnacle
in our "GO" package. Call us at 514-345-9578 for details.)
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM port TERM
Example: MODEM 1 TERM
Action: A simple terminal program for checking and setting modem parameters.
Returns: 0
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM port TRACE
Example: MODEM 1 TRACE
Action: Similar to TERM, but displays control codes.
Returns: 0
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
██████████████████████████████████████████████████████████████████████████████
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
█░▒░▒░▒░▒░▒░▒▌ PROGRAMMING NOTES ▐▒░▒░▒░▒░▒░▒░█
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
██████████████████████████████████████████████████████████████████████████████
Error Levels
────────────
Modem generates an ERRORLEVEL of 255 if the program aborts due to a detectable
program or hardware flaw, an invalid parameter, or some other unusual circum-
stance.
Dialog
──────
To send text to the modem, you can use DOS's ECHO command, as in this example:
ECHO Hello World! >COM1
If you require more sophisticated dialog support, contact Pinnacle Software
for information about a variety of options open to you.
██████████████████████████████████████████████████████████████████████████████
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
█░▒░▒░▒░▒░▒░▒▌ ENVIRONMENT VARIABLES ▐▒░▒░▒░▒░▒░▒░█
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
██████████████████████████████████████████████████████████████████████████████
For testing purposes, you may want the capability to bypass the MODEM command
and simply force it to return an ERRORLEVEL of 0. To do this, enter the
following DOS command:
SET MX=L
Afterwards, to restore MODEM to normal operation, enter this command:
SET MX=
██████████████████████████████████████████████████████████████████████████████
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
█░▒░▒░▒░▒░▒░▒▌ EXTENDED SUPPORT ▐▒░▒░▒░▒░▒░▒░█
█▒░▒░▒░▒░▒░▒░▌ ▐░▒░▒░▒░▒░▒░▒█
██████████████████████████████████████████████████████████████████████████████
The general format of the Extended Support MODEM commands is:
Format: MODEM [extended-support-parameters] port command
Example: MODEM /L /I3 4 TRACE
Action: Runs a logged trace on COM4, using the IRQ3 interrupt.
Extended Support parameters are optional. They may begin with a slash (/) or
a dash (-).
You are entitled to use the basic version of MODEM completely free of charge.
The following features may be obtained by purchasing the latest copy of MODEM
from Pinnacle Software. (Note: when you order your copy, we'll send you a
large collection of modem-oriented software - see the order form for complete
details.)
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM /I# port command
Example: MODEM /I3 3 TERM
Action: Allows you to specify the IRQ line used by the COM port. The
Extended Support version of MODEM lets you use COM3 and COM4, but
some modems do not use the generally used values for these ports,
which are:
╒═══════════════╤═══════════════╤═══════════════╤═══════════════╕
│ │ │ │ │
│ COM1 = IRQ4 │ COM2 = IRQ3 │ COM3 = IRQ4 │ COM4 = IRQ3 │
│ │ │ │ │
╘═══════════════╧═══════════════╧═══════════════╧═══════════════╛
Valid values are /I3 and /I4 (for IRQ3 and IRQ4).
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
Command: MODEM /L port command
Example: MODEM /L 1 TERM
Action: Writes all text from the modem to a file named MODEMLOG.TXT.
This is useful for saving the text of your session with your modem,
for later analysis. The size of the LOG file is limited to 64K.
It is always created in the current directory. The previous .TXT
file (if it exists) is renamed to .BAK.
Limits: Most useful with TERM, TRACE and AT commands. In TRACE mode,
Raise/Lower DTR is logged at [DTR+] and [DTR-] respectively.
·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
████▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀████
█▒░█ DO YOU HAVE ANY COMMENTS OR QUESTIONS? You can reach us as follows: █░▒█
█░▒█ █▒░█
█▒░█ Voice Support Line (9 AM to 9 PM Eastern Time) ······ (514) 345-9578 █░▒█
█░▒█ █▒░█
█▒░█ 24 hr/day FREE files BBS (up to 9600 baud v42bis) ··· (514) 345-8654 █░▒█
█░▒█ █▒░█
█▒░█ GEnie ·········· T.CAMPBELL11 CompuServe ·········· 70154,1577 █░▒█
████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄████