home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / ezcom.zip / EZCOMM.DOC next >
Text File  |  1990-03-03  |  20KB  |  768 lines
  1.                         Page 1
  2.  
  3.  
  4.             EZCOMM Telecommunications Program Manual
  5.  
  6.  
  7.                 
  8.                        Version 1.0
  9.                     By:  Mitch Howard
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                         Page 2
  68.  
  69.                    TABLE OF CONTENTS
  70.     =================================================
  71.  
  72. CHAPTER 1: INTRODUCTION & PROGRAM OVERVIEW
  73.  
  74. CHAPTER 2: STARTING EZCOMM
  75.  
  76. CHAPTER 3: EZCOMM DIRECTORIES
  77.     Main Menu .................................. 5
  78.     Dialing Directory .......................... 6
  79.     Telephone Number Directory ................. 6
  80.     Protocol Directory ......................... 6
  81.     Emulation Directory ........................ 6
  82.     File Maintenence Directory ................. 6
  83.     Capture Directory .......................... 7
  84.     Online Communications Directory ............ 7
  85.     File Transfer Directory .................... 8
  86.  
  87. CHAPTER 4: EZCOMM SCRIPTS
  88.     Overview of Scripts ........................ 9
  89.     Creating Scripts ........................... 9
  90.     Script Commands & Usage .................... 9
  91.     Script Examples ............................ 9
  92.     Sample Script .............................. 10
  93.  
  94. CHAPTER 5: EZCOMM USAGE
  95.     Keyboard Commands & Features ............... 11
  96.  
  97. CHAPTER 6: EZCOMM PROGRAM REGISTRATION
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                         Page 3
  134.  
  135.  
  136.                        CHAPTER 1
  137.              INTRODUCTION & PROGRAM OVERVIEW
  138.    ====================================================
  139.  
  140. EZCOMM is a menu driven telecommunications program which runs in medium
  141. or high resolution on the ATARI ST.  This program has the power of
  142. many commercial programs of this type, yet is very easy to use.  The
  143. program can run on the 520ST, 1040ST or MEGA ST series. 
  144.  
  145. EZCOMM is copyrighted and may not be altered or changed in any manner
  146. or form without express written consent from the author.  
  147.  
  148. EZCOMM can be registered which will help support future releases and
  149. cover the time involved creating this program.  Registration information
  150. can be found at the end of this manual.  Regardless whether the program
  151. is registered, the author welcomes any comments or suggestions regarding
  152. this program.
  153.  
  154. EZCOMM Author:             Mitch Howard
  155. EZCOMM Version:            1.0
  156. EZCOMM Release Date:       03/01/90
  157. EZCOMM Program Status:     Shareware
  158.  
  159. EZCOMM Program & Documentation - Copyright 1990 by Mitch Howard
  160.  
  161. ATARI and MEGA are trademarks of Atari Corp.
  162. VT52 is a trademark of Digital Equipment Corp.
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.                         Page 4
  200.  
  201.  
  202.                        CHAPTER 2
  203.                     STARTING EZCOMM
  204.      ==============================================
  205.  
  206. Use the normal procedure to run a program on your ST.  From the
  207. DESKTOP, you would double click on EZCOMM.PRG.   EZCOMM will look in
  208. the current directory for 2 files, EZCOMM.PHN & EZCOMM.SYS.
  209.  
  210. EZCOMM.PHN is the main telephone number database.  If this file isn't
  211. found in the same directory, EZCOMM will create an EMPTY database.
  212.  
  213. EZCOMM.SYS is the file which holds the configuration information.
  214. This file can be created after entering the desired settings from the
  215. MAIN MENU.  The following information is saved:
  216. - Keyclick on/off
  217. - Key repeat on/off
  218. - Timeout feature on/off
  219. - Connect alarm on/off
  220. - Exploding menus on/off
  221. - # of redial attempts
  222. - # of seconds between attempts
  223. - Dialing string for modem
  224. - Function keys 1-5
  225.  
  226. After the above files are loaded, hitting any key will bring up
  227. EZCOMM's Main Menu.
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.                         Page 5
  266.  
  267.  
  268.                        CHAPTER 3
  269.                   EZCOMM DIRECTORIES
  270.      ============================================
  271.  
  272. MAIN MENU 
  273. The main menu is the starting point for all activities.  The other
  274. menus can be shown by choosing them from here.  By hitting <Esc>,
  275. at the MAIN MENU, you may quit the program after confirming your choice.
  276.  
  277. The menu selections can be chosen in 2 ways.  The first way is to use
  278. the up and down cursor keys to move the highlight bar onto the desired
  279. choice, then hitting <Return>.  The other way is to hit the key which
  280. corresponds to the 1st letter or number of the menu choice.  When nested
  281. several levels deep into the menus, hitting <Esc> will travel 1 menu
  282. out.
  283.  
  284. One important choice is to 'Resume Communications'.  This allows one
  285. to enter commands directly to the modem.  This can be used to dial
  286. a number not desired in the database or to set registers or configure the
  287. modem itself.  The most important use for this program is to enter BACK
  288. into an active session which was exited with the 'Leave Session' command.
  289. This allows other features within EZCOMM to be performed without hassle.
  290.  
  291. In the menu item 'EZCOMM OPTIONS', there are a couple choices which
  292. can be made to configure EZCOMM to your wishes.
  293.  
  294. The item 'ATARI ST OPTIONS' has a few configuration options for the
  295. ST.  One of the choices is to activate a 'Timeout Feature'.
  296. What this feature does is to sit in the background and activate every
  297. 20 seconds.  When activated it will send a space followed by a backspace.
  298. The purpose of this is to keep from timing-out while connected to
  299. another system.  Many Bulletin Boards will log a person off if there
  300. is no activity within 1 minute.  This feature will keep you active
  301. and never allow the system to log you off.  This feature only functions
  302. while you are online and is deactivated during file transfers.  This
  303. feature will stay activated while shelled out into another program though.
  304. The default setting for the Timer is OFF after loading EZCOMM.
  305.  
  306. Also in this section is the connect alarm.  This alarm can be used to
  307. signal a connection made with another system.
  308. This alarm also defaults to OFF after loading EZCOMM.
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.                         Page 6
  332.  
  333.  
  334. DIALING DIRECTORY
  335. This directory is the place to dial frequently used numbers.  The database
  336. holds 20 numbers and you may keep several different databases on disk.
  337. To load a different database, use the 'Load different Database' option,
  338. which is described in the next section.
  339. In this Dialing Directory, you may dial any of the 20 numbers stored in
  340. the database.  The settings associated with each number will be used
  341. for the number chosen. (Refer to protocol & emulation).
  342.  
  343. You may also mark and dial several in succession.  Once a connection
  344. is established, the ssequence will be ended.  To set the number of
  345. dialing attempts for the calls, adjust the figure from the main menu
  346. under 'Setup EZCOMM'.
  347.  
  348. The search mode can be used to dial several numbers in a sequence.
  349. The author of EZCOMM is not responsible for any damage or trouble
  350. resulting from the use of this feature.  Use it at your own discretion.
  351.  
  352. Choosing 'Auto Answer' will set the modem to wait for an incoming call.
  353. Clicking the LEFT mouse button will abort this mode.
  354.  
  355.  
  356. TELEPHONE NUMBER DIRECTORY
  357. This directory is where all changes and additions to the database are
  358. made.  The prompts are all straight forward and should not present
  359. any problems.  One option on this menu is to load another database.
  360. This is where you can load other databases stored on disk.  There is also
  361. a tracking report which will record the number of calls and minutes spent
  362. at each number.  This report can be viewed on the screen or printed
  363. out on paper.
  364.  
  365.  
  366. PROTOCOL DIRECTORY
  367. This menu is used to change any parameters needed to ensure correct
  368. communications protocol.  The protocol associated with each number
  369. in the database will automatically be set before dialing.  This option
  370. should be used when bypassing the dialing menus or to make a change
  371. to an incorrect protocol.
  372.  
  373.  
  374. EMULATION DIRECTORY
  375. This menu is used to set the computer to emulate another computer or
  376. terminal.  This feature is useful to communicate with other computers
  377. which use different codes to control screen output.  Communications
  378. with mainframes and mini-computers require different emulations unless
  379. they support VT52.  VT52 support is provided by the ATARI ST operating
  380. system automatically.  The emulation chosen for each number in the
  381. database will also be stored.
  382.  
  383.  
  384. FILE MAINTENENCE DIRECTORY
  385. The functions on this menu provide support for file maintenence and
  386. related activities.  These activities are explained in detail below:
  387.  
  388. Directory listing - Used to view or print the the directory contents.
  389. Files within subdirectories can also be seen.  Search patterns can be
  390. used to avoid showing all files on a disk.  To choose an existing sub-
  391. directory, click the LEFT mouse button directly on the subdirectory
  392. name.  The subdirectory chosen will now be shown.   This process can
  393. continue many folders deep.  When the desired path search path is found,
  394. click the RIGHT mouse button and the directory search will begin.
  395.  
  396.  
  397.                         Page 7
  398.  
  399.  
  400. Copy a file - Copies a file anywhere.  If the destination file exists,
  401. an alert box will appear and confirm the overwrite of the file.
  402.  
  403. Move a file - Copies a file anywhere and upon successful completion,
  404. deletes the source file permanently.
  405.  
  406. Rename a file - Gives an existing file a different name.
  407.  
  408. Erase a file - Permanently deletes the file chosen in the fileselector
  409. box until the "Cancel" option is chosen.
  410.  
  411. Folder creation - Creates a new folder to hold other files.
  412.  
  413. Space on disk - Shows the remaining free bytes on the drive selected.
  414.  
  415.  
  416. CAPTURE DIRECTORY
  417. This menu gives access to a capture buffer which holds the text transfered
  418. between the systems.  The capture buffer can also be used to create
  419. and send your lines of text.  Any ASCII text file can be loaded into
  420. the buffer and can be editted or sent directly to the other system.
  421. Any file which is saved will be added to the end of an EXISTING file
  422. This way, an entire online session can be saved and reviewed later.
  423. Remember when editting a file to save it under a new name or it will
  424. be added to the end of the old file.  
  425. Anytime the buffer is active and becomes full, the file will be saved
  426. and the buffer cleared for more data.
  427.  
  428. The commands for the capture editor are shown when one enters the screen.
  429. Most of the commands are self-explanitory. 
  430.  
  431. When you delete an entire line in the buffer, hitting <Undo> will
  432. restore that line back where the cursor resides.
  433.   
  434. The ONLY way into this menu is thru an Online Session.  Hitting <F10>
  435. will bring up this menu.  Hitting <Esc> will jump back into the current
  436. session.
  437.  
  438. ONLINE COMMUNICATIONS DIRECTORY
  439. This menu can only be invoked while in an online session.  This is
  440. the way to the File Transfer Directory which is described in the next
  441. section.  Also the current emulation     and protocols can be changed
  442. here if they are incorrect.  
  443.  
  444. Function keys 1-5 can each be programmed with up to 30 characters.
  445.  
  446. The <Undo> key can be used to send a break signal to the receiving
  447. system.  This signal sometimes is needed to communicate with older
  448. system.  Some different operating systems use the break signal to break
  449. a process which is running.
  450.  
  451. One important feature on this menu is the ability to call other programs
  452. and then return to EZCOMM.  Any programs can be called as long as memory
  453. for the new program permits.  EZCOMM will check to see how much initial
  454. memory the program needs to load.  If enough memory is available, the
  455. program will be executed.  There may be problems with programs which
  456. have enough memory to load but need to allocate additional memory later.
  457. If a program is called which has a .TTP extension, EZCOMM will ask
  458. for any parameters which can be passed to the program for execution.
  459. Using this feature, all types of programs can be called from EZCOMM.
  460.  
  461.  
  462.  
  463.                         Page 8
  464.  
  465. The 2 options to leave the session are important.  The 1st option only
  466. leaves until the 'Resume Session' option is chosen again.  The 2nd
  467. option will try to hang up the modem before leaving the session.  Use
  468. the 1st option along with the 'Resume' option on the main menu to jump
  469. into and out of EZCOMM without losing carrier with the receiving end.
  470.  
  471. While in a session, there are 4 special keys.
  472. 1) <F1> thru <F5> - executes a preprogrammed function key.
  473. 2) <F10> - brings up the Capture Directory.
  474. 3) <F8> - brings up the Online Communications menu.
  475. 4) <F6> - executes a script, if any, associated with the dialed number.
  476. Refer to Script section for more information.
  477.  
  478.  
  479. FILE TRANSFER DIRECTORY
  480. This menu is called to transfer files to a destination system.  Both
  481. systems must agree on a transfer protocol.  The most common protocol
  482. is XMODEM.  EZCOMM can receive and transfer files using XMODEM.  To
  483. use other protocols, there is a choice on the menu to shell out to
  484. another program.  The new program will then handle the transfer using
  485. its protocol.  Great flexibilty is gained from using this method. 
  486. You can use faster protocols as they are developed or just use your
  487. favorites.
  488. The Timeout feature is deactivated during any file transfers to ensure
  489. accurate transmissions.  It will be reactivated after the transfer
  490. is completed. 
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.                         Page 9
  530.  
  531.                       CHAPTER 4
  532.                     EZCOMM SCRIPTS
  533.        ========================================
  534.  
  535. OVERVIEW OF SCRIPTS
  536. Scripts are used within EZCOMM to automate repetitive tasks.  When
  537. telephone numbers are added or modified, the user will be prompted
  538. for a script to be associated with the number.  If a script is chosen
  539. for the number, it can be executed after making a connection by hitting
  540. <F6>.  Otherwise, a fileselector box will appear asking for a SCRIPT
  541. to execute.
  542.  
  543. CREATING SCRIPTS
  544. Scripts can be created with the capture buffer or with any text editor
  545. or word processor which creates straight ASCII text without control
  546. characters.  Script extensions by default end with '.SCR'.
  547.  
  548. SCRIPT COMMANDS & USAGE
  549. There are only 6 commands used in scripts. They are:
  550. PAUSE x
  551. SEND+ xxxxxx
  552. SEND- xxxxxx
  553. WAITI x
  554. WAITC x
  555. WAITW xxxxx
  556.  
  557. The 'x' indicates a variable desired.  Examples below will explain.
  558.  
  559. These commands must be entered in uppercase and should be the first
  560. word on a line.  There should be only 1 command per line.  A script
  561. which is being executed can be aborted by pressing both <Shift> keys
  562. together.  This avoids hanging up the computer while waiting for
  563. input or when testing a new script.
  564.  
  565.  
  566. SCRIPT EXAMPLES
  567. -----------------------------------------------
  568. ex) PAUSE 100
  569. This command waits for x/50 seconds.
  570. The above example waits 2 seconds.
  571. -----------------------------------------------
  572. ex) SEND+ 123456789
  573. This command sends the text "123456789" followed by a <Return>.
  574. -----------------------------------------------
  575. ex) SEND- AT
  576. This command send the text "AT" WITHOUT a carriage return.
  577. -----------------------------------------------
  578. ex) WAITI 3
  579. This command waits until the remote system stops sending data for
  580. 3 seconds, then continues with the script.
  581. This command is used to wait for a remote system to request input 
  582. before continuing.
  583. -----------------------------------------------
  584. ex) WAITC ?
  585. This command waits for the remote system to issue the character '?'
  586. before continuing.
  587. -----------------------------------------------
  588. ex) WAITW Logon ?
  589. This command waits for the words 'Logon ?' to appear before continuing.
  590. -----------------------------------------------
  591.  
  592.  
  593.  
  594.  
  595.                         Page 10
  596.  
  597. SAMPLE SCRIPT
  598.  
  599. Comments are shown between the '/' characters.
  600.  
  601. This SCRIPT is used to logon to a remote BBS and look for new files.
  602.  
  603. SEND+                / empty line will send only <Return> /
  604. WAITI 2              / waits for remote to stop for 2 secs /
  605. SEND+
  606. WAITI 2
  607. SEND+ 12345         / enter my user number + <Return> /
  608. WAITI 4             / gives remote system a few extra seconds to /
  609.                     / find my user # and then prompt for my password /
  610. SEND+ SECRET        / my password = 'SECRET' + <Return>  /
  611. WAITI 2
  612. SEND- F             / command to get to 'F'ile Section - No <RETURN> /
  613. WAITI 5             / give enough time to enter file section /
  614. SEND- S             / give command to 'S'earch new files  /
  615. WAITI 1             / wait for next prompt or 1 second /
  616. SEND- N             / tell BBS to show only 'N'ew files /
  617.                     / End of SCRIPT - EZ, Huh ??? /
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.                         Page 11
  662.  
  663.                        CHAPTER 6
  664.               KEYBOARD COMMANDS & FEATURES
  665.     =================================================
  666.  
  667. EZCOMM doesn't require you to memorize a lot of commands to learn to
  668. use it.  The keyboard commands that it uses are listed below along
  669. with the functions they perform.
  670.  
  671. <Esc> - Steps backwards in the menus or exits the program if at the
  672. MAIN MENU.
  673.  
  674. <F1> thru <F5> - Used while in a session.  Sends the Function-Key
  675. 1-5 which was programmed by the user.
  676.  
  677. <F6> - Used while in a session.  Sends the script associated with the
  678. number or allows execution of a SCRIPT on disk.
  679.  
  680. <F8> - Brings up the Online Communications Directory.
  681.  
  682. <F10> - Brings up the Capture Directory while in a session.
  683.  
  684. <Undo> - Sends a break signal to the receiving system.  Sometimes needed
  685. with mainframes, minicomputers and older systems.
  686.  
  687.  
  688. The following keys are used by the Capture buffer editor.
  689.  
  690. <Esc> - exits the Capture editor.
  691.  
  692. <Control>+<Delete> - deletes the line in which the cursor resides.
  693. This line can be restored with <Undo>.  Note that this function will
  694. scroll the remaining lines up 1.
  695.  
  696. <Control>+<Ins> - inserts a line where the cursor is.  If this function
  697. will lose a line at the end of the buffer, an alert box will warn you.
  698.  
  699. <Control>+<Clr> - clears the line in which the cursor resides.
  700.  
  701. <Cursor Keys> - The cursor keys move as shown below.
  702.  
  703. <Up> - moves the cursor up 1 line.
  704.  
  705. <Down> - moves the cursor down 1 line.
  706.  
  707. <Right> - moves the cursor right 1 character.  Stops at the end of
  708. the line.
  709.  
  710. <Left> - moves the cursor left 1 character.  Stops at the beginning
  711. of the line.
  712.  
  713. <Control>+<Up> - Pages up.
  714.  
  715. <Control>+<Down> - Pages down.
  716.  
  717. <Control>+<Right> - Cursor jumps to end of line.
  718.  
  719. <Control>+<Left> - Cursor jumps to line start.
  720.  
  721. <Control>+<T> - Tags or untags a line at a time.  This is used to highlight
  722. certain lines within the buffer. After tagging lines, the lines may
  723. be printed, or sent to the remote system.
  724.  
  725.  
  726.  
  727.                         Page 12
  728.  
  729.                    EZCOMM REGISTRATION
  730.        ===========================================
  731.  
  732. Please check any option(s) below and mail this sheet to the address
  733. listed.
  734.  
  735. (   )   Register me as a user and accept this check for $14.00.
  736.  
  737. (   )   I like the program but didn't feel like registering.
  738.  
  739. (   )   Inform me of any updates to this program.
  740.  
  741. (   )   Inform me of any future products.
  742.  
  743. (   )   I didn't like the program (Use comments).
  744.  
  745.  
  746. Comments: ___________________________________________________________
  747.  
  748.           ___________________________________________________________
  749.  
  750.           ___________________________________________________________
  751.  
  752.           ___________________________________________________________
  753.  
  754.           ___________________________________________________________
  755.  
  756.           ___________________________________________________________
  757.  
  758.           ___________________________________________________________
  759.  
  760.  
  761.  
  762.  
  763.                          Send this sheet to:
  764.  
  765.                              Mitch Howard
  766.                          1302 Oak Hill Dr #110
  767.                           Escondido, CA  92027