home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / TELECOM / KWIN_LinkUp_1_0.lzh / DOC / linkup.doc < prev   
Text File  |  1995-04-27  |  52KB  |  1,651 lines
  1.  
  2.                                                                               
  3.  
  4.  
  5.  
  6.         
  7.         
  8.         
  9.         
  10.         
  11.         
  12.         
  13.         
  14.         
  15.         
  16.         
  17.         
  18.         
  19.         
  20.         
  21.                               LinkUp For KWindows
  22.                                    Edition 10
  23.                                         
  24.                                 REFERENCE MANUAL
  25.                                         
  26.                                Updated April 1995
  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.  
  68. April 1995                 LinkUp Reference Manual                      Page 2
  69.  
  70.  
  71.                                     Foreword
  72.         
  73.              LinkUp  has  its  roots  in a programming project I started
  74.         several years ago on the Tandy Color Computer 3 under Multi-Vue. 
  75.         Tentatively named MVTerm, the program was never fully  developed
  76.         due  to  the limitations of the CoCo 3. However, the source code
  77.         was easily portable to KWindows, and  provided  me  with  a  new
  78.         opportunity to enhance my original work.  
  79.         
  80.              As  I  began  to  develop  LinkUp,  I  challenged myself to
  81.         exploit the KWindows environment as much  as  possible.    After
  82.         basic  functionality  was  in  place, I began to experiment with
  83.         more elaborate features such as icons, sound, and colors.    The
  84.         scope  of the project then changed to a quest for that "perfect"
  85.         introductory telecommunications program -- one which  maintained
  86.         a balance between the aesthetic and the practical.  
  87.         
  88.              The  result  is  a program which I feel excels in both user
  89.         friendliness and features.  It is not intended to  compete  with
  90.         more  capable  KWindows  based  communications  programs  on the
  91.         market; nonetheless, it is a testament that  user-friendly  OS-9
  92.         software is not an oxymoron, but a reality.  
  93.         
  94.         
  95.                                 Acknowledgements
  96.         
  97.              Many  thanks  go to the following people for their testing,
  98.         ideas and suggestions: Jim Pruyne, Steve Wegert,  David  Graham,
  99.         Joel  Hegberg, Tim Kientzle, Scott McGee and Colin McKay. Thanks
  100.         to Ken Scales  for  the  information  he  provided  me  on  ANSI
  101.         emulation.  
  102.         
  103.              Special  thanks  goes  to  Mike  Haaland for allowing me to
  104.         include GPort with  LinkUp,  to  Mark  Griffith  for  giving  me
  105.         permission  to  integrate his CompuServe B/B+ protocol routines,
  106.         to Andrzej Kotanski for making his sound programs  available  to
  107.         the  public  domain,  and  to Tim Kientzle for his permission to
  108.         incorporate his excellent XY and Z programs into LinkUp.  
  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.  
  134. April 1995                 LinkUp Reference Manual                      Page 3
  135.  
  136.  
  137.                                   Introduction
  138.         
  139.              LinkUp is an  easy  to  use  communications  program  which
  140.         allows  your  KWindows-based  OS-9  system  to  connect to other
  141.         computers and information services around  the  world.    It  is
  142.         fully  integrated  with  the  KWindows  environment,  giving you
  143.         access to all the resources that the windowing system provides.  
  144.         
  145.         
  146.              LinkUp features: 
  147.         
  148.                 o An easy to  use,  intuitive  graphical  user
  149.                   interface 
  150.                   
  151.                 o  Color  ANSI  emulation  which allows you to
  152.                   view color/animation screens found  on  many
  153.                   bulletin board services 
  154.                   
  155.                 o VT-100, KWindows, Wyse 50 and ADDS emulation 
  156.                   
  157.                 o X/YModem and Kermit upload/download support 
  158.                   
  159.                 o ZModem upload/download support with optional 
  160.                   auto detection 
  161.                   
  162.                 o CompuServe B/B+ upload/download support 
  163.                   
  164.                 o Phone Book for commonly used numbers 
  165.                   
  166.                 o  Fast  and  easy  setup  of modem parameters
  167.                   using GPort 
  168.                   
  169.                 o User selectable  fonts,  color  schemes  and
  170.                   digitized  sound for a personalized look and
  171.                   feel 
  172.                   
  173.                 o   Support    for    Hyper-Tech    Software's
  174.                   DeskTop(tm) resources, if available 
  175.         
  176.         
  177.         To run LinkUp, you need an OS-9 based computer equipped with: 
  178.         
  179.                   o KWindows (WindIO Edition #54 or greater) 
  180.                   
  181.                   o a modem (preferably Hayes compatible) 
  182.                   
  183.                   o at least 150K free memory 
  184.         
  185.         
  186.                                Installing LinkUp
  187.         
  188.              The  script  file 'install' will do the necessary setup for
  189.         your system.  To install, insert the LinkUp disk in your  drive,
  190.         and type the following (replacing /d0 if necessary): 
  191.         
  192.                               chd /d0; /d0/install
  193.         
  194.              As the  files are copied, you can monitor the progress.  Be
  195.  
  196.  
  197.                                                                               
  198.  
  199.  
  200. April 1995                 LinkUp Reference Manual                      Page 4
  201.  
  202.  
  203.         aware that the install script overwrites existing files  of  the
  204.         same name.  
  205.         
  206.              NOTE: /dd is the assumed target device 
  207.         
  208.         
  209.                                 Starting LinkUp
  210.         
  211.         From DeskTop: 
  212.              An AIF  and icon file for LinkUp are provided.  Once inside
  213.         DeskTop, navigate to the directory containing the AIF and double 
  214.         click on the LinkUp icon with your left mouse button.  
  215.         
  216.         From the Keyboard: 
  217.              At the command prompt, type: 
  218.         
  219.                                  linkup [ENTER]
  220.         
  221.         
  222.                        Running LinkUp for the First Time
  223.         
  224.              At  startup,  LinkUp  looks  for  the  configuration   file
  225.         .linkupcfg  in  your  home  directory  (if  the HOME environment
  226.         variable isn't set, the current directory is the used).  If  the
  227.         file is not found, LinkUp will look in /DD/SYS for a file called 
  228.         linkupcfg.   If  either file is found, LinkUp reads the contents
  229.         and sets parameters accordingly.  
  230.         
  231.              If no configuration file is found, LinkUp assumes  that  it
  232.         is  being  executed  for  the  first  time,  and  sets the modem
  233.         parameters to 2400 baud, 8 bits word size, no parity and 1  stop
  234.         bit with  hardware and software flow control turned on.  It then
  235.         creates a configuration file both the /DD/SYS directory  and  in
  236.         your  home  directory (see appendix B for a detailed look at the
  237.         configuration file).  
  238.         
  239.         
  240.         Selecting a Modem Port 
  241.              There are three ways of specifying a modem port for  LinkUp
  242.         to use: 
  243.         
  244.                 o  Set  the MODEM environment variable to your
  245.                   modem's port.  
  246.                   
  247.                              e.g.  setenv MODEM /t3
  248.                   
  249.                   
  250.                 o Use the -p option when running  LinkUp  from
  251.                   the  command  line (this overrides the MODEM
  252.                   environment variable).  
  253.                   
  254.                               e.g.  linkup -p=/t3
  255.                   
  256.                   
  257.                 o If the MODEM environment variable is not set 
  258.                   and there is no .linkupcfg file, LinkUp will 
  259.                   prompt you to  make  a  selection  from  the
  260.                   "Modem Ports" selection box.  Move the mouse 
  261.  
  262.  
  263.                                                                               
  264.  
  265.  
  266. April 1995                 LinkUp Reference Manual                      Page 5
  267.  
  268.  
  269.                   pointer onto the port you wish to select and 
  270.                   click.   If  the  port cannot be opened, you
  271.                   have the option to choose  another  port  or
  272.                   exit the application.  
  273.                   
  274.                        NOTE:  Both  the MODEM environment
  275.                        variable and the  -p  option  will
  276.                        override  the  port  saved  in the
  277.                        .linkupcfg file (the port you last 
  278.                        used).  
  279.         
  280.         
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                                                               
  330.  
  331.  
  332. April 1995                 LinkUp Reference Manual                      Page 6
  333.  
  334.  
  335.                                 Getting Started
  336.         
  337.              Once a connection to the port has been established,  LinkUp
  338.         displays the 'About' box.  To close the box, you may: 
  339.         
  340.                   o click on the 'OK' button with the mouse, 
  341.                   
  342.                   o press the [ENTER] key, or 
  343.                   
  344.                   o press the [ALT]-O key combination 
  345.                   
  346.                        NOTE:   Buttons   that   have   an
  347.                        underscore in the button name  can
  348.                        always  be activated by depressing
  349.                        [ALT] and then typing the  key  of
  350.                        the     character     which     is
  351.                        underscored.  
  352.         
  353.              LinkUp utilizes "pull-down" menus aligned  along  the  area
  354.         atop the  application  window (known as the "menu bar").  Moving
  355.         the mouse cursor to the menu name and clicking  the  left  mouse
  356.         button causes that menu name's pull-down menu to appear.  
  357.         
  358.              Each  pull-down  menu  has  a  given  number  of  "options"
  359.         associated with it.  Moving the mouse pointer  over  the  option
  360.         causes  an  option  to be "highlighted." To select a highlighted
  361.         option, click the left mouse button.  
  362.         
  363.              In addition to  accessing  options  through  the  pull-down
  364.         menu, some  options can be accessed through "hot keys."  Options
  365.         that can be activated via hot keys are have  two  characters  on
  366.         the right side of the option name (a lowercase 'a' character and 
  367.         an uppercase companion).  
  368.         
  369.              The lowercase a represents the [ALT] key, and the character 
  370.         next  to  it corresponds to the key that must be typed while the
  371.         [ALT] key is being held down (.e.g the  'About'  option  in  the
  372.         Files  menu contains an 'aA', indicating that this option can be
  373.         called by holding down the [ALT] key and pressing the [A] key) 
  374.         
  375.              Just below the menu bar is the title bar.   The  title  bar
  376.         gives you at-a-glance information on: 
  377.         
  378.                   o Baud rate 
  379.                   o Word size, Parity and Stop bits 
  380.                   o CTS/RTS Hardware handshaking status 
  381.                   o XON/XOFF Software handshaking status 
  382.                   o CAPTURE buffer status 
  383.         
  384.         The  CTS/RTS,  XON/XOFF  and  CAPTURE statuses are shown only if
  385.         they are activated; if they are not shown, they  are  considered
  386.         turned off.  
  387.         
  388.         Moving 
  389.              Clicking  on  the  double  horizontal bar at the upper left
  390.         corner of the LinkUp window allows the application window to  be
  391.         moved around on the screen or even to another screen.  
  392.         
  393.  
  394.  
  395.                                                                               
  396.  
  397.  
  398. April 1995                 LinkUp Reference Manual                      Page 7
  399.  
  400.  
  401.         Window Stacking 
  402.              The  icon  on  the  upper  right  hand corner of the LinkUp
  403.         window allows you to move the application window to the back  or
  404.         front of a stack of windows.  
  405.         
  406.         Resizing 
  407.              LinkUp  also  allows  dynamic  resizing  of the application
  408.         window with the resize icon,  found  on  the  lower  right  hand
  409.         corner.   When  the application window is resized, all scrolling
  410.         regions are deactivated.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.                                                                               
  462.  
  463.  
  464. April 1995                 LinkUp Reference Manual                      Page 8
  465.  
  466.  
  467.                                   LinkUp Menus
  468.         
  469.              Here  is  a  synopsis  of  each  menu  in  LinkUp  and  its
  470.         associated options.  
  471.         
  472.                                    Files Menu
  473.         
  474.              New Capture (ALT-N) 
  475.                        'New Capture' allows you to capture all 
  476.                   incoming  and  outgoing  data into a file on
  477.                   your system.  A dialog box appears prompting 
  478.                   you for a filename.  Type the  name  of  the
  479.                   file  you  wish to send captured data to and
  480.                   press either [ENTER] or [ALT]-[O], or  click
  481.                   on the  'OK'  button with the mouse.  If the
  482.                   file you specified does not  already  exist,
  483.                   CAPTURE  appears  highlighted  in  the title
  484.                   bar, notifying you that all  incoming  modem
  485.                   data is being captured to the file.  
  486.                   
  487.                        If   the   file  exists,  you  will  be
  488.                   notified with an error box.  Click the mouse 
  489.                   button or press a key, and type  in  another
  490.                   filename.   To cancel, press either [ESC] or
  491.                   [ALT]-[C], or click on the 'Cancel' button.  
  492.                   
  493.                   
  494.              Open Capture (ALT-O) 
  495.                        'Open Capture' works much the  same  as
  496.                   'New   Capture',   except  that  it  appends
  497.                   captured data to an existing file.   A  file
  498.                   selection   box  appears,  allowing  you  to
  499.                   navigate directories until you have selected 
  500.                   a file.    If  successful,  CAPTURE  appears
  501.                   highlighted  in the title bar, notifying you
  502.                   that capture mode is on.  
  503.                   
  504.                   TIP: Here's how you can  navigate  the  file
  505.                   selection boxes in LinkUp: 
  506.                   
  507.                                     Keyboard
  508.                   
  509.                        Up Arrow    - Move up one file
  510.                        Down Arrow  - Move down one file
  511.                        PgUp        - Move up one page of filenames
  512.                        PgDn        - Move down one page of filenames
  513.                        ESC         - Dismiss the file selection box and abort
  514.                        
  515.                                         Mouse
  516.                        
  517.                        Up Arrow    - Move up one file
  518.                                      (slightly above moves up one page)
  519.                        Down Arrow  - Move down one file
  520.                                      (slightly below moves down one page)
  521.                        <PARENT>    - Move up one level in the directory tree
  522.                        Filename    - Select the file
  523.                        Close Box   - Dismiss the file selection box and abort
  524.                   
  525.  
  526.  
  527.                                                                               
  528.  
  529.  
  530. April 1995                 LinkUp Reference Manual                      Page 9
  531.  
  532.  
  533.                   
  534.              Close Capture 
  535.                        When  you  are  finished capturing your
  536.                   data, you can  close  the  capture  file  by
  537.                   selecting this   option.    The  highlighted
  538.                   CAPTURE message  then  disappears  from  the
  539.                   title bar.    If  you  exit LinkUp while the
  540.                   capture file is open,  it  is  automatically
  541.                   closed.  
  542.                   
  543.                   
  544.              Change Folder (ALT-F) 
  545.                        Your default working directory is where 
  546.                   transferred files are referenced.  To change 
  547.                   your  default directory to another location,
  548.                   select this option.  This directory pathlist 
  549.                   will be saved when you exit LinkUp.  
  550.                   
  551.                        The dialogue  box  shows  your  default
  552.                   working directory  and an input field.  Type
  553.                   the name of the new directory  you  wish  to
  554.                   change  to, then type [ENTER] (or [ALT]-[O])
  555.                   or use the  mouse  and  click  on  the  'OK'
  556.                   button.  
  557.                   
  558.                        If  you  change  your  mind and wish to
  559.                   keep the  default  working  directory,  type
  560.                   [ALT]-[C]  or  press  [ESC], or click on the
  561.                   'Cancel' button.  
  562.                   
  563.                        NOTE: As you move around the  file
  564.                        system  in the file selection box,
  565.                        the current working  directory  is
  566.                        changed;  therefore,  your current
  567.                        may or  may  not  be  the  default
  568.                        working  directory at the time you
  569.                        select this option.  
  570.                   
  571.                   
  572.              OS-9 Shell (ALT-4) 
  573.                        This option will open an overlay window 
  574.                   and fork  an  OS-9  shell.    If  the  SHELL
  575.                   environment variable is set, that shell will 
  576.                   be  used;  otherwise the command interpreter
  577.                   'shell' is used.  When selected, the  cursor
  578.                   changes  to a sleep symbol, and LinkUp waits
  579.                   until you exit the shell program.  
  580.                   
  581.                   
  582.              Pipe Command (ALT-1) 
  583.                        This option will ask you for a  command
  584.                   line to  execute.  The output of the command
  585.                   will then be piped into LinkUp. This can  be
  586.                   useful if you want to upload the contents of 
  587.                   a  file  or  display the output of a command
  588.                   directly into LinkUp.  
  589.                   
  590.                   
  591.  
  592.  
  593.                                                                               
  594.  
  595.  
  596. April 1995                 LinkUp Reference Manual                     Page 10
  597.  
  598.  
  599.              About LinkUp (ALT-A) 
  600.                        The 'About' box shows the  LinkUp  icon
  601.                   and  copyright  information,  as well as the
  602.                   current  size  of  the  terminal  area   (in
  603.                   characters).   To  exit,  press  [ENTER]  or
  604.                   [ALT]-[O], or click on the 'OK' button  with
  605.                   the mouse.  
  606.                   
  607.                   
  608.              Quit (ALT-Q) 
  609.                        When  you  wish to quit LinkUp, you can
  610.                   select this option.   A  dialogue  box  will
  611.                   appear  to  verify  that  you indeed want to
  612.                   exit LinkUp. Move the mouse pointer  to  the
  613.                   'OK' button  and  click  to  exit.   To exit
  614.                   using the keyboard, press the  [ENTER]  key,
  615.                   or use the [ALT]-O key combination.  
  616.                   
  617.                        If  you  do  not want to quit, move the
  618.                   mouse outside of the 'OK' button and  click,
  619.                   or  using the keyboard, press the [ESC] key.
  620.                   You  will  be  returned  to   the   terminal
  621.                   screen.  
  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.  
  662. April 1995                 LinkUp Reference Manual                     Page 11
  663.  
  664.  
  665.                                  Settings Menu
  666.         
  667.              ANSI 
  668.                        This  option allows LinkUp to interpret
  669.                   ANSI escape codes  found  on  many  BBS  and
  670.                   on-line services.    In addition, ANSI color
  671.                   and arrow keys are  also  supported.    ANSI
  672.                   emulation is active when a checkmark appears 
  673.                   by the option.  
  674.                   
  675.                        NOTE: For notes on ANSI emulation, 
  676.                        see appendix A.  
  677.                   
  678.                   
  679.              VT-100 
  680.                        Using  this option, LinkUp behaves like
  681.                   a VT-100 terminal and the arrow keys produce 
  682.                   their respective ANSI character strings.   A
  683.                   checkmark  by  this option indicates that it
  684.                   is active.  
  685.                   
  686.                        NOTE: Most,  but  not  all  VT-100
  687.                        features  are  emulated by LinkUp.
  688.                        Specifically,  the  VT-100  keypad
  689.                        has    not    been    implemented.
  690.                        Scrolling   regions   have    been
  691.                        implemented.    When   the  LinkUp
  692.                        screen  is  resized,  any   active
  693.                        scrolling        regions       are
  694.                        deactivated.  
  695.                   
  696.              KWindows 
  697.                        Use this  option  for  native  KWindows
  698.                   emulation.    Only   a  subset  of  KWindows
  699.                   features   are   supported   (basic   cursor
  700.                   positioning and   line   manipulation).    A
  701.                   checkmark by this option indicates  that  it
  702.                   is active.  
  703.                   
  704.                        This  emulation mode is also compatible
  705.                   with the Tandy Color Computer  3/OS-9  Level
  706.                   II emulation codes.  
  707.                   
  708.                        NOTE:   For   notes   on  KWindows
  709.                        emulation, see appendix A.  
  710.                   
  711.                   
  712.              Wyse 50 
  713.                        This option  allows  LinkUp  to  behave
  714.                   like a  Wyse  50  terminal.    Most  Wyse 50
  715.                   behaviors are emulated.  A checkmark by this 
  716.                   option indicates that it is active.  
  717.                   
  718.                   
  719.              ADDS 
  720.                        This option  allows  LinkUp  to  behave
  721.                   like an    ADDS   terminal.      Most   ADDS
  722.                   capabilities are emulated.  A  checkmark  by
  723.  
  724.  
  725.                                                                               
  726.  
  727.  
  728. April 1995                 LinkUp Reference Manual                     Page 12
  729.  
  730.  
  731.                   this option indicates that it is active.  
  732.                   
  733.                   
  734.              Events 
  735.                        Events  allow  you  to associate sounds
  736.                   with certain LinkUp events.  You  may  chose
  737.                   not  to utilize events in LinkUp, or you may
  738.                   only want specific events to be triggered.  
  739.                   
  740.                        Upon selecting this option, a  dialogue
  741.                   box with  eight  text  areas  appears.   The
  742.                   first text area is the path to  sound  files
  743.                   that you  wish  to  use  for  events.    All
  744.                   remaining  boxes  are  associated  with  the
  745.                   labeled event.    LinkUp can play .WAV, .AU,
  746.                   .IFF and .VOC sound files.  
  747.                   
  748.                        To navigate inside the Event  box,  you
  749.                   can  click  on  the  area  where you wish to
  750.                   type, or use the down-arrow/TAB to move down 
  751.                   and up-arrow/SHIFT-TAB to  move  up  a  text
  752.                   box.   To  accept  the changes, click on the
  753.                   'OK' button,  else  click  on  the  'Cancel'
  754.                   button.  
  755.                   
  756.                   Events can be triggered: 
  757.                   
  758.                        o At startup
  759.                        o When a modem connection is made (CD goes high)
  760.                        o When a file transfer is completed
  761.                        o When a modem connection is dropped (CD goes low)
  762.                        o When a beep character is received from the modem
  763.                        o When an alert box appears
  764.                        o When the user exits LinkUp
  765.                   
  766.                   
  767.              ZModem Detect 
  768.                        If  this  option is on (as indicated by
  769.                   the    checkmark),    then    LinkUp    will
  770.                   automatically   invoke  ZModem  Send/Receive
  771.                   without the need for user intervention.  
  772.                   
  773.                   
  774.              7 Bit Mask 
  775.                        If  you  find  that  you   are   having
  776.                   problems   with   garbled  characters,  this
  777.                   option may help alleviate the problem.   The
  778.                   7  bit  mask  removes  the high order bit of
  779.                   each  incoming  character,  and   ultimately
  780.                   defeats parity  checking.    Use  it only if
  781.                   necessary.  
  782.                   
  783.                   
  784.              Sound 
  785.                        If this  option  is  checkmarked,  then
  786.                   sound  events  are activated; otherwise, you
  787.                   will not hear any sound when  an  associated
  788.                   event occurs.  
  789.  
  790.  
  791.                                                                               
  792.  
  793.  
  794. April 1995                 LinkUp Reference Manual                     Page 13
  795.  
  796.  
  797.                   
  798.                        NOTE:  Performance degradation can
  799.                        occur if  running  LinkUp  from  a
  800.                        floppy  disk  due to the necessary
  801.                        loading of  the  sound  file  each
  802.                        time it   is  played.    For  best
  803.                        performance, use a hard drive  and
  804.                        enable     disk    caching    with
  805.                        Microware's diskcache utility.  
  806.                   
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.                                                                               
  858.  
  859.  
  860. April 1995                 LinkUp Reference Manual                     Page 14
  861.  
  862.  
  863.                                    Modem Menu
  864.                   
  865.              Phone Book (ALT-P) 
  866.                        The Phone Book allows you to  store  up
  867.                   to   10   commonly  used  phone  numbers  of
  868.                   computer systems and  the  modem  parameters
  869.                   required to  connect to them.  These numbers
  870.                   are stored in a file in your home  directory
  871.                   called  .linkupdial  (see  appendix  B for a
  872.                   detailed look at the dial file).  
  873.                   
  874.                        Upon selecting this option, the  dialer
  875.                   dialogue box  appears.    If  there are dial
  876.                   entries in the entry portion of the box, you 
  877.                   may select one by moving the mouse over  the
  878.                   entry and  click.    A  selection  bar  will
  879.                   appear over the entry,  and  then  entry  is
  880.                   considered   "selected."   Clicking   on   a
  881.                   selected entry will cause the item to become 
  882.                   "deselected" and the selection bar  will  be
  883.                   removed.  
  884.                   
  885.                        Along  the  left  side  of  the box are
  886.                   four    buttons: 
  887.                   
  888.                        Dial 
  889.                             If a dial entry is  selected,
  890.                        it  can  be  dialed by clicking on
  891.                        this button.  Once  clicked  upon,
  892.                        LinkUp hangs up the modem if it is 
  893.                        off-hook   and  dials  the  number
  894.                        associated with the entry.  If  no
  895.                        entry  is selected, this button is
  896.                        inoperative.  
  897.                        
  898.                             The [ALT]-D  key  combination
  899.                        can  also  be  used  to  call this
  900.                        option.  
  901.                        
  902.                        
  903.                        Insert 
  904.                             You may  insert  a  new  dial
  905.                        entry  by clicking on this button.
  906.                        A new  dialogue  box  will  appear
  907.                        prompting  you  for  a  name and a
  908.                        number.     Terminal    emulation,
  909.                        ZModem  detection,  7  bit masking
  910.                        and sound for the entry  can  also
  911.                        be  changed  by  clicking  on  the
  912.                        button box next to the option.   A
  913.                        checkmark   indicates   that   the
  914.                        option is turned on.  No checkmark 
  915.                        indicates  that  the   option   is
  916.                        turned off.  
  917.                        
  918.                        Once  the  entry  has been filled,
  919.                        click on the 'OK' button (or press 
  920.                        [ALT]-O) to accept  the  input  as
  921.  
  922.  
  923.                                                                               
  924.  
  925.  
  926. April 1995                 LinkUp Reference Manual                     Page 15
  927.  
  928.  
  929.                        well    as    the   current   port
  930.                        parameters.  If you wish to change 
  931.                        the     serial  port   parameters,
  932.                        click  on  the  'Port' button (or,
  933.                        using    the    keyboard,     type
  934.                        [ALT]-[P])  and GPort will appear,
  935.                        allowing  you  to   modify   modem
  936.                        parameters for this entry.  If you 
  937.                        decide to cancel your entry, click 
  938.                        on  the  'Cancel' button (or press
  939.                        [ALT]-[C] or [ESC]).  
  940.                        
  941.                             If a dial entry  is  selected
  942.                        when   the   'Insert'   button  is
  943.                        clicked, LinkUp  will  insert  the
  944.                        new   entry   BEFRE  the  selected
  945.                        entry; otherwise,  the  new  entry
  946.                        will be inserted at the end of the 
  947.                        list.  
  948.                        
  949.                             The  [ALT]-I  key combination
  950.                        can also  be  used  to  call  this
  951.                        option.  
  952.                        
  953.                        TIP:  Here's  how you can navigate
  954.                        through the text entry fields: 
  955.                        
  956.                                     Keyboard
  957.                        
  958.                        Left Arrow    - Move cursor left
  959.                        Right Arrow   - Move cursor right
  960.                        HOME          - Move to the first character
  961.                        END           - Move past last character
  962.                        DEL           - Delete character under cursor
  963.                        BACKSPACE     - Delete character to left of cursor
  964.                        CTRL-X        - Erase entire field
  965.                        Up Arrow      - Move to previous field
  966.                        Down Arrow    - Move to next field
  967.                        TAB           - Move to next field
  968.                        ENTER         - Next field
  969.                        
  970.                        NOTE: You must fill in both fields 
  971.                        before  you  can  select  'OK'  or
  972.                        'Port'.  
  973.                        
  974.                        
  975.                        Change 
  976.                             If  a dial entry is selected,
  977.                        it can be changed by  clicking  on
  978.                        this button.    A new dialogue box
  979.                        will  appear  with  the   selected
  980.                        entry's  name, number and terminal
  981.                        type.  
  982.                        
  983.                             The  same  selection  options
  984.                        which applied to 'Insert' apply to 
  985.                        this operation as well.  
  986.                        
  987.  
  988.  
  989.                                                                               
  990.  
  991.  
  992. April 1995                 LinkUp Reference Manual                     Page 16
  993.  
  994.  
  995.                        
  996.                        Remove 
  997.                             If  a dial entry is selected,
  998.                        it can be removed by  clicking  on
  999.                        this button.  
  1000.                        
  1001.                             The  [ALT]-R  key combination
  1002.                        can also  be  used  to  call  this
  1003.                        option.  
  1004.                        
  1005.                             You  can  exit the Phone Book
  1006.                        by  clicking  on  the  close  icon
  1007.                        located  on  the  upper  left hand
  1008.                        corner or pressing the [ESC]  key.
  1009.                        Any changes made to the Phone Book 
  1010.                        will be saved at that time.  
  1011.                        
  1012.                        
  1013.              Hangup (ALT-H) 
  1014.                        Use   this  option  when  you  wish  to
  1015.                   terminate the current on-line session.    An
  1016.                   alert dialogue box will appear to notify you 
  1017.                   that the  modem  is  hanging  up.  After the
  1018.                   connection has been  severed,  you  will  be
  1019.                   returned to the terminal screen.  
  1020.                   
  1021.                        If  the modem is on-hook (not connected
  1022.                   to  a  host),  this  option  will   not   be
  1023.                   accessible.  
  1024.                   
  1025.                   
  1026.              Port Setup (ALT-S) 
  1027.                        This option calls up GPort, a simple to 
  1028.                   use  interface  which allows you to set your
  1029.                   modem port options.   For  more  information
  1030.                   about  GPort,  see  the  GPort documentation
  1031.                   file.  
  1032.                   
  1033.                   
  1034.              Modem Strings (ALT-M) 
  1035.                   
  1036.                        When  LinkUp  starts,   it   sends   an
  1037.                   initialization string to your modem (default 
  1038.                   is  ATZ). Many users want to customize their
  1039.                   modem to turn on certain features,  such  as
  1040.                   flow control,  timing  delays,  etc.    This
  1041.                   option  allows  you   to   input   a   modem
  1042.                   initialization    string   of   up   to   32
  1043.                   characters.  The  next  time  you  start  up
  1044.                   LinkUp,  that  string  will  be sent to your
  1045.                   modem.  
  1046.                   
  1047.                        The  dial  prefix  string  (default  is
  1048.                   ATDT) may  also  be  modified.    Users with
  1049.                   call-waiting and slow off-hook to  dial-tone
  1050.                   transition  can  insert strings to deal with
  1051.                   these problems.  See your modem  manual  for
  1052.                   more   information   on  modem  dial  prefix
  1053.  
  1054.  
  1055.                                                                               
  1056.  
  1057.  
  1058. April 1995                 LinkUp Reference Manual                     Page 17
  1059.  
  1060.  
  1061.                   strings.  
  1062.                   
  1063.                   
  1064.              Port Snooze (ALT-Z) 
  1065.                   
  1066.                        At times you  may  want  to  close  the
  1067.                   modem  port  without  disrupting your LinkUp
  1068.                   session.  This option will close the path to 
  1069.                   the modem, allowing other programs (such  as
  1070.                   external  transfer  protocols) to access the
  1071.                   port.  To reestablish LinkUp's connection to 
  1072.                   the port, press  [ENTER]  or  [ALT]-[W],  or
  1073.                   click  on  the  'Wake  Up!'  button with the
  1074.                   mouse.  
  1075.                   
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.                                                                               
  1122.  
  1123.  
  1124. April 1995                 LinkUp Reference Manual                     Page 18
  1125.  
  1126.  
  1127.                               Send & Receive Menu
  1128.         
  1129.              LinkUp gives you many options to transfer files to and from 
  1130.         your OS-9 computer.  Thanks to Tim Kientzle's XY and Z programs, 
  1131.         which are tightly coupled with LinkUp, you  can  choose  from  a
  1132.         number of  protocols.    Consult the XY and Z documentation file
  1133.         for more information on these fine programs.  
  1134.         
  1135.              Several protocols  are  available  in  LinkUp.  Should  you
  1136.         decide  to abort your transfer, you may do so by pressing [ESC].
  1137.         If the protocol has not aborted at that time, pressing  [ESC]  a
  1138.         second time will unconditionally terminate the program.  
  1139.         
  1140.              When any of the Send options are selected, a file selection 
  1141.         box will  appear.  Use the mouse or keyboard to select a file to
  1142.         send, or press [ESC] at the file  selection  box  to  abort  the
  1143.         send.   Both  send  and  recieve  create an overlay window which
  1144.         reports the progress of the transfer.  
  1145.         
  1146.              One protocol that doesn't show up on the menu is CompuServe 
  1147.         B/B+ protocol.  This protocol  will  auto-detect  an  upload  or
  1148.         download and is therefore not included in the protocol list.  
  1149.         
  1150.              Here are the available protocols: 
  1151.         
  1152.              XModem CRC XModem protocol with CRC checking 
  1153.                   
  1154.              XModem Checksum.br XModem protocol with checksum 
  1155.                   
  1156.              XModem-K.br   XModem   protocol   with  1K  block
  1157.                   transfers 
  1158.                   
  1159.              YModem.br Simple YModem protocol 
  1160.                   
  1161.              YModem-G.br Faster YModem protocol 
  1162.                   
  1163.              YModem Batch.br A multi-file YModem protocol 
  1164.                   
  1165.              ZModem.br ZModem is currently one of  the  faster
  1166.                   and more popular protocols; because of this, 
  1167.                   it was integrated with LinkUp.  Note that if 
  1168.                   ZModem  auto-detection  is turned on, a file
  1169.                   selection box appears immediately, prompting 
  1170.                   you for a file to send.  
  1171.                   
  1172.              Kermit Binary.br Kermit transfer for binary files 
  1173.                   
  1174.              Kermit Text.br  Kermit  transfer  for  ASCII/text
  1175.                   files 
  1176.                   
  1177.                   
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.                                                                               
  1188.  
  1189.  
  1190. April 1995                 LinkUp Reference Manual                     Page 19
  1191.  
  1192.  
  1193.                                    Fonts Menu
  1194.         
  1195.              The font in the terminal area can be changed to any of five 
  1196.         unique  KWindows  fonts:  Standard,  Macintosh,  Gothic, IBM and
  1197.         Cast. LinkUp remembers which font you last selected and will use 
  1198.         that font when it starts up.  The initial default is Standard.  
  1199.         
  1200.              NOTE:  LinkUp  expects  to  find  font  files  in  the
  1201.              standard  directory  /DD/SYS/.BITMAPS/FONTS.  You  can
  1202.              change  this  behavior   by   setting   the   FONTPATH
  1203.              environment variable to the directory where your fonts 
  1204.              are located.   However, each font file must conform to
  1205.              standard group/buffer number  assignments  and  naming
  1206.              conventions.   For  this reason, fonts are provided on
  1207.              the LinkUp distribution disk.  
  1208.         
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.                                                                               
  1254.  
  1255.  
  1256. April 1995                 LinkUp Reference Manual                     Page 20
  1257.  
  1258.  
  1259.                                   Colors Menu
  1260.         
  1261.              Menu colors  can  be  changed  to  one  of  nine  different
  1262.         colorsets provided: 
  1263.         
  1264.                   o Blue 
  1265.                   o Grey 
  1266.                   o Dark Grey 
  1267.                   o Green 
  1268.                   o Aqua 
  1269.                   o Red 
  1270.                   o Purple 
  1271.                   o Yellow 
  1272.                   o DeskTop 
  1273.         
  1274.              Your  last  selected  colorset  will be saved when you exit
  1275.         LinkUp. For DeskTop(tm)  users,  the  DeskTop  option  uses  the
  1276.         default colorset found in the /DD/SYS/deskrc or the .deskrc file 
  1277.         in your home directory.  
  1278.         
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.                                                                               
  1320.  
  1321.  
  1322. April 1995                 LinkUp Reference Manual                     Page 21
  1323.  
  1324.  
  1325.  
  1326.                                Feedback on LinkUp
  1327.         
  1328.         
  1329.              Like  any  other software author, I enjoy hearing ideas and
  1330.         criticisms on my software.  Feel free to send me  your  comments
  1331.         via the Internet: boisy@os9er.waukee.ia.us.  I am also on Delphi 
  1332.         as BOISY, and on CompuServe as 74464,3005.  
  1333.         
  1334.              I can also be reached via US Mail: 
  1335.         
  1336.                                  Boisy G. Pitre
  1337.                                    PO Box 523
  1338.                                Waukee, IA  50263
  1339.         
  1340.         
  1341.              If   you  should  encounter  any  strange  or  undocumented
  1342.         behavior that might be considered a bug,  please  let  me  know,
  1343.         with  as  much  detail  as possible as to how the problem can be
  1344.         duplicated.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.                                                                               
  1386.  
  1387.  
  1388. April 1995          APPENDIX A -- Terminal Emulation Notes             Page 22
  1389.  
  1390.  
  1391.  
  1392.                             Terminal Emulation Notes
  1393.         
  1394.         
  1395.         ANSI NOTES 
  1396.                      While  the  ANSI  engine  in  LinkUp  is  virtually
  1397.         complete,  there are a few behaviors that may not conform to the
  1398.         ANSI graphic standard: 
  1399.         
  1400.            o Some PC BBS's  use  ANSI  screens  with  embedded  IBM
  1401.              characters  from  01  to  26. KWindows does not have a
  1402.              corresponding character for this range;  hence,  these
  1403.              characters are replaced with spaces.  
  1404.              
  1405.            o KWindows does not currently support blink mode so ANSI 
  1406.              blinking is  not possible.  The ANSI blink sequence is
  1407.              ignored.  
  1408.         
  1409.              If you find that a particular ANSI screen is not displaying 
  1410.         properly in LinkUp, capture the  ANSI  file  using  the  capture
  1411.         feature in the File menu and e-mail the file to: 
  1412.         
  1413.                             boisy@os9er.waukee.ia.us
  1414.         
  1415.              Furthermore,  I would be interested in any ANSI graphic art
  1416.         that is available in order to more fully test the ANSI engine of 
  1417.         LinkUp.  
  1418.         
  1419.         
  1420.         KWINDOWS NOTES 
  1421.              The KWindows emulation engine in LinkUp covers  basic  text
  1422.         features of  the  KWindows  environment.  Specifically, commands
  1423.         dealing with  cursor  movement,  underline,  bold,  reverse  and
  1424.         character/line/screen deletion sequences are emulated.  
  1425.         
  1426.              KWindows emulation ignores font selection, overlay windows, 
  1427.         and other windowing commands.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.                                                                               
  1452.  
  1453.  
  1454. April 1995           APPENDIX B -- LinkUp Specific Files               Page 23
  1455.  
  1456.  
  1457.  
  1458.                              LinkUp Specific Files
  1459.         
  1460.         
  1461.              LinkUp  creates  two  files on your system disk: .linkupcfg
  1462.         and .linkupdial.  The former contains configuration  information
  1463.         for  LinkUp  and the latter contains system names, phone numbers
  1464.         and settings for each entry.  
  1465.         
  1466.              LinkUp attempts to reference and store these two  files  in
  1467.         your home directory.  If LinkUp is not successful in determining 
  1468.         your home directory (through the HOME environment variable), the 
  1469.         directory  /DD/SYS/LINKUP  will  be  created  to  store  the two
  1470.         files.  
  1471.         
  1472.         
  1473.                               The .linkupcfg file
  1474.         
  1475.              Although all options are settable from within  LinkUp,  you
  1476.         may  wish  to  edit  or consult the .linkupcfg file from time to
  1477.         time.  The format of the file is: 
  1478.         
  1479.                                   NAME = VALUE
  1480.         
  1481.              A '#' as the  first  character  in  the  line  indicates  a
  1482.         comment.  
  1483.         
  1484.              Here  is  an explanation of each entry in the configuration
  1485.         file: 
  1486.         
  1487.              Port 
  1488.                   This is a string value which is the name  of  the
  1489.              serial port.  
  1490.              
  1491.              BaudRate 
  1492.                   This  a  numeric  value  which specifies the baud
  1493.              rate of the serial port.  Valid values are 300,  1200,
  1494.              1800, 2400, 4800, 9600, 19200 and 38400.  
  1495.              
  1496.              WordSize 
  1497.                   This  is a numeric value which indicates the word
  1498.              size of each byte.  Valid values are 5, 6, 7 and 8.  
  1499.              
  1500.              Parity 
  1501.                   This is a string  variable  which  indicates  the
  1502.              parity.  Valid values are ODD, EVEN and NONE.  
  1503.              
  1504.              StopBits 
  1505.                   This  is  a  numeric  value  which  indicates the
  1506.              number of stop bits.  Valid values are 1, 1.5 and 2.  
  1507.              
  1508.              XOnXOff 
  1509.                   This  is  a  boolean  value  indicating   whether
  1510.              software handshaking  (XON/XOFF) will be used.  If set
  1511.              to ON or TRUE, software handshaking is active.  If set 
  1512.              to OFF or FALSE, it is inactive.  
  1513.              
  1514.              CTSRTS 
  1515.  
  1516.  
  1517.                                                                               
  1518.  
  1519.  
  1520. April 1995           APPENDIX B -- LinkUp Specific Files               Page 24
  1521.  
  1522.  
  1523.                   This  is  a  boolean  value  indicating   whether
  1524.              hardware handshaking  (CTS/RTS)  will be used.  If set
  1525.              to ON or TRUE, hardware handshaking is active.  If set 
  1526.              to OFF or FALSE, it is inactive.    Your  serial  port
  1527.              must  support hardware handshaking for this feature to
  1528.              work.  
  1529.              
  1530.              ModemInitString 
  1531.                   This is a  string  value  which  is  set  to  the
  1532.              initialization  string  that is sent to the modem when
  1533.              LinkUp first starts.    The  default  value  for  this
  1534.              string is ATZ.  
  1535.              
  1536.              ModemDialPrefix 
  1537.                   This  is  a string value which is set to the dial
  1538.              prefix string that is sent to the  modem  when  LinkUp
  1539.              dials a  number.  The default value for this string is
  1540.              ATDT.  
  1541.              
  1542.              ColorSet 
  1543.                   This is a numeric value which corresponds to  the
  1544.              colorset that LinkUp will use.  
  1545.              
  1546.              ZModemAutoDetect 
  1547.                   This  is  a boolean value which indicates whether
  1548.              ZModem auto-detection is enabled.  If  set  to  ON  or
  1549.              TRUE, auto-detection  is  active.    If  set to OFF or
  1550.              FALSE, it is inactive.  
  1551.              
  1552.              WorkDirectory 
  1553.                   This is the default working directory that LinkUp 
  1554.              changes to when it starts up.  
  1555.              
  1556.              Sound 
  1557.                   This is a boolean value which  indicates  whether
  1558.              sound   will  be  played  during  certain  application
  1559.              events.  If set to ON or TRUE, sound will  be  played.
  1560.              If set to OFF or FALSE, no sound will be played during 
  1561.              application events.  
  1562.              
  1563.              7BitMask 
  1564.                   This  is  a boolean value which indicates whether
  1565.              the high bit of all bytes coming from the serial  port
  1566.              will be  cleared.   If set to ON or TRUE, the high bit
  1567.              will be masked.  If set to OFF or FALSE, bytes  coming
  1568.              in will remain intact without masking.  
  1569.              
  1570.              Emulation 
  1571.                   This  is  a  string  value  which  LinkUp uses to
  1572.              determine which terminal emulation it will use.  Valid 
  1573.              values are ANSI, VT100, ADDS, KWINDOWS and WYSE50.  
  1574.              
  1575.              Font 
  1576.                   This is a string value which sets up the  default
  1577.              font  used  by  LinkUp  for  displaying  text  in  the
  1578.              terminal area of the application window.  Valid values 
  1579.              are STANDARD, MACINTOSH, GOTHIC, IBM and CAST.  
  1580.              
  1581.  
  1582.  
  1583.                                                                               
  1584.  
  1585.  
  1586. April 1995           APPENDIX B -- LinkUp Specific Files               Page 25
  1587.  
  1588.  
  1589.              SoundDir 
  1590.                   This is a  string  value  which  is  set  to  the
  1591.              directory where the sound files for the various events 
  1592.              are located.    This  must  be  a valid OS-9 directory
  1593.              pathlist.  
  1594.              
  1595.              The names of  the  following  variables  indicate  the
  1596.              event in  which  they play a sound file.  Their values
  1597.              are the names of the files which are played  for  that
  1598.              particular event.  
  1599.              
  1600.              Sound_Intro 
  1601.                   This sound is played when LinkUp first starts.  
  1602.              
  1603.              Sound_Goodbye 
  1604.                   This sound is played when the user exits LinkUp.  
  1605.              
  1606.              Sound_Bell 
  1607.                   This  sound  is played when a bell character ($7)
  1608.              is received.  If  sound  is  turned  off,  the  normal
  1609.              terminal bell sound will be generated.  
  1610.              
  1611.              Sound_Transfer 
  1612.                   This  sound  is  played  when a file transfer has
  1613.              completed.  
  1614.              
  1615.              Sound_Alert 
  1616.                   This sound is played when the user is alerted  to
  1617.              an error.  
  1618.              
  1619.              Sound_Connect 
  1620.                   This  sound  is  played  when LinkUp successfully
  1621.              connects (the carrier detect goes high).  
  1622.              
  1623.              Sound_Disconnect 
  1624.                   This sound is played when LinkUp disconnects (the 
  1625.              carrier detect goes low).  
  1626.         
  1627.         
  1628.         
  1629.                               The .linkupdial file
  1630.         
  1631.              This file contains system names,  numbers  and  information
  1632.         used by LinkUp's phone book.  Each line in the file is an entry, 
  1633.         with fields in the entry separated by a colon.  
  1634.         
  1635.              The format of an entry is: 
  1636.         
  1637.              Name:Number:Baud rate:Wordsize:Parity:Stop bits:Emulation: 
  1638.              CTS/RTS:XON/XOFF:ZModem Detect:7 bit mask:Sound 
  1639.         
  1640.              An example entry might look like this: 
  1641.         
  1642.             CompuServe:276-7231:38400:8:None:1:vt100:on:on:off:on:on
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.                                                                               
  1650.  
  1651.