home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 05B / MOD210A.ZIP / MODEM.DOC next >
Encoding:
Text File  |  1992-02-24  |  14.8 KB  |  295 lines
  1.  
  2.  ██████████████████████████████████████████████████████████████████████████████
  3.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  4.  █░▒░▒░▒░▒░▒░▒▌              ■■■■■■  "MODEM"  ■■■■■              ▐▒░▒░▒░▒░▒░▒░█
  5.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  6.  █░▒░▒░▒░▒░▒░▒▌               by Pinnacle Software               ▐▒░▒░▒░▒░▒░▒░█
  7.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  8.  █░▒░▒░▒░▒░▒░▒▌              A Modem Control Module              ▐▒░▒░▒░▒░▒░▒░█
  9.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  10.  █░▒░▒░▒░▒░▒░▒▌                     ─═ FOR ═─                    ▐▒░▒░▒░▒░▒░▒░█
  11.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  12.  █░▒░▒░▒░▒░▒░▒▌      Batch Files  and  Application Programs      ▐▒░▒░▒░▒░▒░▒░█
  13.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  14.  ██████████████████████████████████████████████████████████████████████████████
  15.  
  16.  
  17.  MODEM  enables you to perform basic modem operations within a batch file,  and
  18.  check the  results  using  DOS ERRORLEVEL  processing.   A high-level language
  19.  (such a C, Basic or Pascal) can "shell" or "exec" MODEM  and check the results
  20.  via the DOS return code.
  21.  
  22.  Thus, you can:
  23.  
  24.  ┌────────────────────────────────────────────────────────────────────────────┐
  25.  │                                                                            │
  26.  │  ■ Automate modem-oriented operations such as late-night file-transfers    │
  27.  │                                                                            │
  28.  │  ■ Easily add the benefits of modem control to your application program    │
  29.  │                                                                            │
  30.  │  ■ Run MODEM as a simple terminal program                                  │
  31.  │                                                                            │
  32.  │  ■ Test your serial ports or modem with the TRACE facility                 │
  33.  │                                                                            │
  34.  │  ■ Use MODEM as an auto-dialer                                             │
  35.  │                                                                            │
  36.  │  ■ Support BBS operations                                                  │
  37.  │                                                                            │
  38.  │  ■ and more ...                                                            │
  39.  │                                                                            │
  40.  └────────────────────────────────────────────────────────────────────────────┘
  41.  
  42.  Using MODEM in a batch file,  along with an external protocol such as the Omen
  43.  Technology's  DSZ program,   you can  easily  create  your own  communications
  44.  program, with upload and download capbility.
  45.  
  46.  
  47.  ██████████████████████████████████████████████████████████████████████████████
  48.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  49.  █░▒░▒░▒░▒░▒░▒▌                 QUICK REFERENCE                  ▐▒░▒░▒░▒░▒░▒░█
  50.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  51.  ██████████████████████████████████████████████████████████████████████████████
  52.  
  53.  
  54.  Usage:     Enter the  MODEM  command at  the DOS prompt,  call it from a batch
  55.             file, or shell or exec it from an application program.
  56.  
  57.  Format:    MODEM port command   (See also Extended Support for another format)
  58.  
  59.  Example:   MODEM 1 TERM
  60.  
  61.  Commands:  MODEM port SETBAUD baudrate
  62.             MODEM port GETBAUD
  63.             MODEM port ATcommand
  64.             MODEM port WAIT ATcommand [greeting-string]
  65.             MODEM port DIAL ATcommand
  66.             MODEM port RAMDIAL ATcommand
  67.             MODEM port CARRIER
  68.             MODEM port DSR
  69.             MODEM port DROPDTR
  70.             MODEM port PAUSE time-in-seconds
  71.             MODEM port TERM
  72.             MODEM port TRACE
  73.  
  74.  
  75.  
  76.  ██████████████████████████████████████████████████████████████████████████████
  77.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  78.  █░▒░▒░▒░▒░▒░▒▌                 MODEM  COMMANDS                  ▐▒░▒░▒░▒░▒░▒░█
  79.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  80.  ██████████████████████████████████████████████████████████████████████████████
  81.  
  82.  
  83.         ┌──────────────────────────────────────────────────────────────┐
  84.         │ NOTE: The examples shown below refer to COM1 and COM2 -- see │
  85.         │ the section "Extended Support" for notes about COM3 and COM4 │
  86.         └──────────────────────────────────────────────────────────────┘
  87.  
  88.             Enter one of the following commands at the DOS prompt...
  89.  
  90.  
  91.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  92.  Command:  MODEM port SETBAUD baudrate
  93.  Example:  MODEM 2 SETBAUD 1200
  94.  Action:   Initializes modem port and sets it to the specified baudrate.
  95.            Use this command before any of the other commands so that your
  96.            computer's serial port will know what speed it should be at.  If
  97.            your modem acts oddly afterwards, you may have to turn it off and
  98.            on and issue an AT command so that it can figure out what the baud-
  99.            rate of the serial port is.  External modems typically do NOT have
  100.            any way of figuring out the serial port speed except by looking at
  101.            the first characters received and trying to figure out what speed
  102.            would make them look like "AT".
  103.  Returns:  0
  104.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  105.  Command:  MODEM port GETBAUD
  106.  Example:  MODEM 1 GETBAUD
  107.  Action:   Displays the baud rate that the port is set to.
  108.  Returns:  11 =  300 baud; 12 = 1200 baud; 13 = 2400 baud; 14 = 4800 baud;
  109.            15 = 9600 baud; 16 = 19200 baud; 17=38400; 25=Over 38400
  110.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  111.  Command:  MODEM port ATcommand
  112.  Example:  MODEM 1 ATH1
  113.  Action:   Sends AT command to the modem and waits for OK.
  114.  Returns:  0 if OK; 200 for any other response
  115.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  116.  Command:  MODEM port WAIT ATcommand [greeting-string]
  117.  Example:  MODEM 2 WAIT ATS0=1
  118.  Action:   Sends AT command to the modem and waits for an incoming call.
  119.  Returns:  11 =  300 baud; 12 = 1200 baud; 13 = 2400 baud; 14 = 4800 baud;
  120.            15 = 9600 baud; 16 = 19200 baud; 255 if user pressed ESC to cancel
  121.  Notes:    19200 baud does not function reliably on 4.77 Mhz machines.
  122.            The greeting-string, if specified, is transmitted at connect time.
  123.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  124.  Command:  MODEM port DIAL ATcommand
  125.  Example:  MODEM 1 DIAL ATDT1-514-345-8654
  126.  Action:   Sends AT command to modem and waits for connection to remote system.
  127.  Returns:  11 =  300 baud; 12 = 1200 baud; 13 = 2400 baud; 14 = 4800 baud;
  128.            15 = 9600 baud; 16 = 19200 baud; 255 if user pressed ESC to cancel
  129.  
  130.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  131.  Command:  MODEM port RAMDIAL ATcommand
  132.  Example:  MODEM 1 RAMDIAL ATDT1-514-345-8654
  133.  Action:   Same as DIAL, but dials until connection, or until ESC is pressed.
  134.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  135.  Command:  MODEM port CARRIER
  136.  Example:  MODEM 2 CARRIER
  137.  Action:   Checks for presence of carrier.
  138.  Returns:  0 if carrier present; 1 if not present
  139.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  140.  Command:  MODEM port DSR
  141.  Example:  MODEM 1 DSR
  142.  Action:   Checks for presence of dataset ready (modem turned on).
  143.  Returns:  0 if ready; 1 if not ready
  144.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  145.  Command:  MODEM port DROPDTR
  146.  Example:  MODEM 1 DROPDTR
  147.  Action:   Lowers Data Terminal Ready.  This hangs up most brands of modem,
  148.            though you should follow up with a "PAUSE" command to give the
  149.            modem time to complete the disconnect.
  150.            ┌─────────────────────────────────────────────────────────────────┐
  151.            │░ VERY IMPORTANT NOTE:   If you are using a modem with built-in ░│
  152.            │░ error correction or compression, dropping DTR does not ALWAYS ░│
  153.            │░ hang up the modem -- if the protocol negotiation fails.  This ░│
  154.            │░ exquisite little bug in the firmware of some modems  has cost ░│
  155.            │░ some companies a lot of money in  long-distance bills.  Don't ░│
  156.            │░ let it  catch you!   When in doubt,  follow up DROPDTR with a ░│
  157.            │░ PAUSE, then ECHO +++ >COM1, another pause, then ATZ.          ░│
  158.            └─────────────────────────────────────────────────────────────────┘
  159.            You can restore DTR by issuing almost any other MODEM command, such
  160.            as setting the baud rate, entering TERM mode, etc.
  161.  Returns:  0
  162.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  163.  Command:  MODEM port PAUSE time-in-seconds
  164.  Example:  MODEM 2 PAUSE 15
  165.  Action:   Monitors the modem for incoming characters, which are displayed,
  166.            until the time is up or the user presses spacebar or ESC.
  167.  Returns:  0 for time-out; 254 if user hit spacebar; 255 if user hit ESC
  168.            (Some alternative pausing utilities are available from Pinnacle
  169.            in our "GO" package.  Call us at 514-345-9578 for details.)
  170.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  171.  Command:  MODEM port TERM
  172.  Example:  MODEM 1 TERM
  173.  Action:   A simple terminal program for checking and setting modem parameters.
  174.  Returns:  0
  175.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  176.  Command:  MODEM port TRACE
  177.  Example:  MODEM 1 TRACE
  178.  Action:   Similar to TERM, but displays control codes.
  179.  Returns:  0
  180.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  181.  
  182.  
  183.  ██████████████████████████████████████████████████████████████████████████████
  184.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  185.  █░▒░▒░▒░▒░▒░▒▌                PROGRAMMING NOTES                 ▐▒░▒░▒░▒░▒░▒░█
  186.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  187.  ██████████████████████████████████████████████████████████████████████████████
  188.  
  189.  
  190.  Error Levels
  191.  ────────────
  192.  
  193.  Modem generates an ERRORLEVEL of 255 if the program aborts due to a detectable
  194.  program or hardware flaw, an invalid parameter,  or some other unusual circum-
  195.  stance.
  196.  
  197.  
  198.  Dialog
  199.  ──────
  200.  
  201.  To send text to the modem, you can use DOS's ECHO command, as in this example:
  202.  
  203.  ECHO Hello World! >COM1
  204.  
  205.  If you require more sophisticated dialog support,  contact  Pinnacle  Software
  206.  for information about a variety of options open to you.
  207.  
  208.  
  209.  ██████████████████████████████████████████████████████████████████████████████
  210.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  211.  █░▒░▒░▒░▒░▒░▒▌              ENVIRONMENT VARIABLES               ▐▒░▒░▒░▒░▒░▒░█
  212.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  213.  ██████████████████████████████████████████████████████████████████████████████
  214.  
  215.  
  216.  For testing purposes,  you may want the capability to bypass the MODEM command
  217.  and simply  force it to return an ERRORLEVEL of  0.   To  do  this,  enter the
  218.  following DOS command:
  219.  
  220.  SET MX=L
  221.  
  222.  Afterwards, to restore MODEM to normal operation, enter this command:
  223.  
  224.  SET MX=
  225.  
  226.  
  227.  ██████████████████████████████████████████████████████████████████████████████
  228.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  229.  █░▒░▒░▒░▒░▒░▒▌                EXTENDED  SUPPORT                 ▐▒░▒░▒░▒░▒░▒░█
  230.  █▒░▒░▒░▒░▒░▒░▌                                                  ▐░▒░▒░▒░▒░▒░▒█
  231.  ██████████████████████████████████████████████████████████████████████████████
  232.  
  233.  
  234.  The general format of the Extended Support MODEM commands is:
  235.  
  236.  Format:   MODEM [extended-support-parameters] port command
  237.  Example:  MODEM /L /I3 4 TRACE
  238.  Action:   Runs a logged trace on COM4, using the IRQ3 interrupt.
  239.  
  240.  Extended Support parameters are optional.   They may begin with a slash (/) or
  241.  a dash (-).
  242.  
  243.  You are entitled to use the basic version of MODEM  completely free of charge.
  244.  The  following features may be obtained by purchasing the latest copy of MODEM
  245.  from  Pinnacle  Software.  (Note:  when you order your copy,  we'll send you a
  246.  large collection of  modem-oriented software - see the order form for complete
  247.  details.)
  248.  
  249.  
  250.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  251.  
  252.  Command:  MODEM /I# port command
  253.  Example:  MODEM /I3 3 TERM
  254.  
  255.  Action:   Allows you to specify the IRQ line used by the COM port.  The
  256.            Extended Support version of MODEM lets you use COM3 and COM4, but
  257.            some modems do not use the generally used values for these ports,
  258.            which are:
  259.  
  260.            ╒═══════════════╤═══════════════╤═══════════════╤═══════════════╕
  261.            │               │               │               │               │
  262.            │  COM1 = IRQ4  │  COM2 = IRQ3  │  COM3 = IRQ4  │  COM4 = IRQ3  │
  263.            │               │               │               │               │
  264.            ╘═══════════════╧═══════════════╧═══════════════╧═══════════════╛
  265.  
  266.            Valid values are  /I3  and  /I4  (for IRQ3 and IRQ4).
  267.  
  268.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  269.  
  270.  Command:  MODEM /L port command
  271.  Example:  MODEM /L 1 TERM
  272.  
  273.  Action:   Writes all text from the modem to a file named MODEMLOG.TXT.
  274.            This is useful for saving the text of your session with your modem,
  275.            for later analysis.  The size of the LOG file is limited to 64K.
  276.            It is always created in the current directory.  The previous .TXT
  277.            file (if it exists) is renamed to .BAK.
  278.  
  279.  Limits:   Most useful with TERM, TRACE and AT commands.  In TRACE mode,
  280.            Raise/Lower DTR is logged at [DTR+] and [DTR-] respectively.
  281.  
  282.  ·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·
  283.  
  284.  
  285.  ████▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀████
  286.  █▒░█ DO YOU HAVE ANY COMMENTS OR QUESTIONS?  You can reach us as follows: █░▒█
  287.  █░▒█                                                                      █▒░█
  288.  █▒░█ Voice Support Line (9 AM to 9 PM Eastern Time) ······ (514) 345-9578 █░▒█
  289.  █░▒█                                                                      █▒░█
  290.  █▒░█ 24 hr/day FREE files BBS (up to 9600 baud v42bis) ··· (514) 345-8654 █░▒█
  291.  █░▒█                                                                      █▒░█
  292.  █▒░█ GEnie ·········· T.CAMPBELL11       CompuServe ·········· 70154,1577 █░▒█
  293.  ████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄████
  294.  
  295.