home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / hamradio / bpqyapp.arj / BPQYAPP.DOC < prev    next >
Text File  |  1991-08-15  |  29KB  |  977 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                  BPQ Yapp File Server Program For IBM-PC/Clones
  8.                  ==============================================
  9.  
  10.  
  11.  
  12.                      Copyright Jon Welch - Ver 1.00 04/07/91
  13.                      ---------------------------------------
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                   Introduction
  25.                                   ============
  26.  
  27.              The BPQ Yapp File Server program is a software package which
  28.         provides a file server on a BPQ Node to enable users to upload or
  29.         download files from it using the YAPP file transfer protocol.  26
  30.         different  file  areas can be defined with access  restricted  to
  31.         upload  only,  download  only  or full  access.  Help  files  are
  32.         available  on  all commands plus an extra info  file  for  system
  33.         details.   The  system  name  and  command  prompts   are   fully
  34.         configurable by the user.
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                              DISCLAIMER OF WARRANTY
  51.  
  52.         THIS  SOFTWARE  AND  MANUAL  ARE PROVIDED  "AS  IS"  AND  WITHOUT
  53.         WARRANTIES  AS  TO PERFORMANCE OF MERCHANTABILITY  OR  ANY  OTHER
  54.         WARRANTIES WHETHER EXPRESSED OR IMPLIED.  BECAUSE OF THE  VARIOUS
  55.         HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH THIS PROGRAM MAY BE
  56.         PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.
  57.  
  58.  
  59.  
  60.  
  61.         BPQYAPP V 1.00                  1                        04/07/91
  62.  
  63.  
  64.  
  65.                                  C O N T E N T S
  66.                                  ===============
  67.  
  68.  
  69.              Chapter                                           Page
  70.              -------                                           ----
  71.  
  72.  
  73.                 1 System Requirements                            3
  74.                 2 Installing The Software                        4
  75.                   2.1 System Files and Usage                     4
  76.                 3 Configuring The Software                       5
  77.                 4 Setting up the Yapp File Server                7
  78.                 5 Using the Yapp File Server                     8
  79.  
  80.  
  81.              Appendices
  82.              ----------
  83.  
  84.  
  85.                 A - My BPQCFG.TXT File                          10
  86.                 B - Recognised Users                            16
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.                             Distribution Restrictions
  94.                             =========================
  95.  
  96.  
  97.              The  BPQ  Yapp  File Server program  is  NOT  public  domain
  98.         software  but  I am making no charge for you to use  it.  If  you
  99.         wish, you can make a contribution to the development of this  and
  100.         future  amateur radio software which I am currently  writing  but
  101.         feel under no obligation to do so.
  102.  
  103.              If you want to contribute or just contact me with  comments,
  104.         asking for help and advice etc. please write to :
  105.  
  106.  
  107.                                  Jon Welch,
  108.                                  50 Quarrydale Road,
  109.                                  Sutton In Ashfield,
  110.                                  Notts. NG17 4DR.
  111.                                  Great Britain
  112.  
  113.  
  114.              If  you  are  writing from  outside  Great  Britain,  please
  115.         remember to include your country in your address so I know  where
  116.         to reply to if necessary !
  117.  
  118.  
  119.  
  120.  
  121.  
  122.         BPQYAPP V 1.00                  2                        04/07/91
  123.  
  124.  
  125.  
  126.         1 System Requirements
  127.         =====================
  128.  
  129.              The software is designed to run in conjunction with the  BPQ
  130.         Node  software  and  Deskview and as such, will  not  work  as  a
  131.         standalone YAPP File Server package.
  132.  
  133.              The software will work on any 80x86 computer running  MS-DOS
  134.         3.00  or  above  with  a  window  size  of  at  least  36K  under
  135.         Deskview.
  136.  
  137.              The software has been tested on BPQ V 4.01 and Deskview 2.31
  138.         but should work with any compatible version.
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.         BPQYAPP V 1.00                  3                        04/07/91
  184.  
  185.  
  186.  
  187.         2 Installing The Software
  188.         =========================
  189.  
  190.              To install the software you will need to copy all the  files
  191.         from  the  distribution file to a directory on a floppy  disc  or
  192.         your hard disc.
  193.  
  194.              You will also need to modify your current BPQCFG.TXT file to
  195.         add the yapp file server as an application into the node. This is
  196.         done  my  modify  the  applications line in  the  file  and  also
  197.         creating a port definition for the program. See the example of my
  198.         current BPQCFG.TXT file in Appendix E for help on doing this.
  199.  
  200.              In   more  detail,  you  need  to  add  a  keyword  to   the
  201.         applications  line which the user will enter to access  the  Yapp
  202.         File Server. There is room for eight on the applications line  so
  203.         find a spare slot and add it in. Each of the keywords is numbered
  204.         starting  at $01, then going up to $02, $04, $08, $10,  $20,  $40
  205.         and $80 for the other seven. In my example below, my YAPP keyword
  206.         is  the fifth in the line and so it's number or APPLMASK is  $10.
  207.         This  needs  to  be defined in the  port  configuration  for  the
  208.         program as shown below also.
  209.  
  210.         TNCPORT                       APPLICATIONS=PMS,,*SYS,MH,YAPP
  211.                 COM=3
  212.                 TYPE=TNC2
  213.                 APPLMASK=$10
  214.                 APPLFLAGS=$00
  215.         ENDPORT
  216.  
  217.              Please  refer  to the relevant documention that  comes  with
  218.         your copy of the BPQ software for more information if required.
  219.  
  220.              You  will also need to create a DVP file for Deskview and  a
  221.         sample one is enclosed for you to work from.
  222.  
  223.  
  224.         2.1 System Files and Usage
  225.         --------------------------
  226.  
  227.              The files comprising the system, where they are located  and
  228.         their function are as follows :
  229.  
  230.  
  231.         BPQYAPP.CFG - Configuration file for program (mandatory)
  232.         BPQYAPP.HLP - Text file sent for H command   (optional)
  233.         BPQYAPP.INF - Text file sent for I command   (optional)
  234.         BPQYAPP.EXE - Main Program
  235.         YS-PIF.DVP  - Sample configuration file for Deskview
  236.         BPQCFG.TXT  - My BPQ configuration file
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.         BPQYAPP V 1.00                  4                        04/07/91
  245.  
  246.  
  247.  
  248.         3 Configuring The Software
  249.         ==========================
  250.  
  251.              The configuration for the program is stored in a single file
  252.         called BPQYAPP.CFG. This file is a standard text file and  should
  253.         be  edited  with  a  text editor that  does  not  add  formatting
  254.         characters to the text (such as Wordstar in non-document mode).
  255.  
  256.              The format of the file is given below :
  257.  
  258.              Line 1
  259.              ------
  260.  
  261.              This  tells the computer which virtual COM port your TNC  is
  262.         connected to in the BPQ Node software. It can either be from 1 to
  263.         16  depending  how you BPQCFG.TXT is configured.
  264.  
  265.              Line 2
  266.              ------
  267.  
  268.              This tells the computer which application number the program
  269.         is  based on it's position in the BPQCFG.TXT  applications  line.
  270.         For each of the available positions 1 to 8, this number will be :
  271.  
  272.                           1, 2, 4, 8, 16, 32, 64 or 128
  273.  
  274.              Line 3
  275.              ------
  276.  
  277.              This  line  is the name you wish to give to your  Yapp  File
  278.         Server.  This  is  displayed on the welcome screen  when  a  user
  279.         connects to your file server.
  280.  
  281.                   eg.      Jon's Megga Fabbo Yapp File Server
  282.  
  283.  
  284.              The  following lines identify the file upload  and  download
  285.         areas  you  wish to set up. Each line comprises of  five  fields,
  286.         each separated by a comma.
  287.  
  288.              Field 1 - File Area Designator. This is a single letter from
  289.         A  to Z which uniquely identifies the area. You need not  specify
  290.         the areas in alphabetical order.
  291.  
  292.              Field 2 - File Area Directory. This is the complete pathname
  293.         (including  drive if necessary) of the directory  containing  the
  294.         files for this area.
  295.  
  296.              Field 3 - File Area Description. This text string is used on
  297.         the  W command to tell the user what type of files are  contained
  298.         in the file area.
  299.  
  300.              Field  4  - Download Flag. This can be either a Y or  N  and
  301.         tells the system if file downloads are allowed from this area.
  302.  
  303.  
  304.  
  305.         BPQYAPP V 1.00                  5                        04/07/91
  306.  
  307.  
  308.  
  309.              Field 5 - Upload Flag. This can be either a Y or N and tells
  310.         the system if file uploads are allowed to this area.
  311.  
  312.                   eg.  A,C:\TNC\PMS\DOWNLOAD,Download Area,Y,N
  313.  
  314.              You must terminate the list of file areas with a single line
  315.         containing a '*'.
  316.  
  317.              The final line in the configuration file is the prompt  sent
  318.         to the user.
  319.  
  320.                           eg.        Cmd:B,D,H,I,U,V,W >
  321.  
  322.  
  323.              A sample BPQYAPP.CFG file is thus :
  324.  
  325.         3
  326.         16
  327.         Jon's BPQ Yapp Server
  328.         A,C:\TNC\PMS\DOWNLOAD\GENERAL,General Download Area,Y,N
  329.         C,E:\GRPHCGA,CD-ROM CGA Graphic Programs     89 files,Y,N
  330.         E,E:\GRPHEGA,CD-ROM EGA/VGA Graphic Programs 94 files,Y,N
  331.         G,E:\GRPHUTIL,CD-ROM General Graphic Programs 47 files,Y,N
  332.         H,E:\GAMEADVE,CD-ROM Adventure Games         143 files,Y,N
  333.         I,E:\GAMEARCA,CD-ROM Arcade Games            270 files,Y,N
  334.         J,E:\GIFS,CD-ROM GIF Pictures            336 files,Y,N
  335.         T,C:\TNC\PMS\DOWNLOAD\TNC,TNC Driver Support Files,Y,N
  336.         U,C:\TNC\PMS\UPLOAD,Upload Area,N,Y
  337.         V,E:\VIRUSERS,CD-ROM Virus Protection Programs,Y,N
  338.         *
  339.         Cmd:B,D,H,I,U,V,W >
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.         BPQYAPP V 1.00                  6                        04/07/91
  367.  
  368.  
  369.  
  370.         3.1 Setting up the Yapp File Server
  371.         -----------------------------------
  372.  
  373.              There  is  very  little to do in setting up  the  Yapp  File
  374.         Server.
  375.  
  376.              If  you have not done so already, configure the  BPQYAPP.CFG
  377.         file accordingly.
  378.  
  379.              You   may  also  want  to  customise  the  main  help   file
  380.         BPQYAPP.HLP and the info file BPQYAPP.INF
  381.  
  382.              For  all  your file areas, you can also create  an  optional
  383.         'area information' file. Again, this is a plain ASCII text  file,
  384.         must  be  called AREA.INF and stored in any file  area  that  you
  385.         require. When the user issues a 'W <area>' command, the  AREA.INF
  386.         file is also displayed below the header line and before the  list
  387.         of  file  names. This feature can be used to tell the  user,  for
  388.         example,  that all files in the area are .ZIP files and  must  be
  389.         decompressed with PKUNZIP before use.
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.         BPQYAPP V 1.00                  7                        04/07/91
  428.  
  429.  
  430.  
  431.         3.2 Using The Yapp File Server
  432.         ------------------------------
  433.  
  434.              Assuming  you have installed the software correctly,  loaded
  435.         the  BPQ code, Deskview, a suitable terminal driver  program  and
  436.         opened  up the Yapp File Server program, the Yapp File Server  is
  437.         accessed  by  connecting to the node and typing the  keyword  you
  438.         defined in the BPQCFG.TXT applications line.
  439.  
  440.              You  will then be welcomed to the file server and  be  given
  441.         the command prompt.
  442.  
  443.              All  the time a remote user is logged onto the file  server,
  444.         the  sysop still has control over the keyboard in the  window  as
  445.         well. This means that the sysop can enter commands as though they
  446.         were  coming from the remote user. This can be used to guide  new
  447.         users through the program by showing them what commands do  what,
  448.         or  the  remote user can be logged off if he  mis-uses  the  file
  449.         server etc.
  450.  
  451.              To  close down the file server, simple use the close  option
  452.         of Deskview or press Alt X whilst in the file server window.
  453.  
  454.              The  different commands available whilst in the file  server
  455.         are :
  456.  
  457.  
  458.          B - Log off the Yapp File Server.
  459.  
  460.              Disconnecting  has  the same effect. The program  will  then
  461.         revert back to waiting for the next user to connect.
  462.  
  463.          D <area> <file> - Download file.
  464.  
  465.              This  is  used to download a file using YAPP  transfer.  The
  466.         area  can  be A to Z if setup in the configuration  file  by  the
  467.         sysop.
  468.  
  469.                 eg. D B HELP.COM
  470.  
  471.          H - Display help file.
  472.  
  473.              This  command will display the BPQYAPP.HLP file to the  user
  474.         if one exists.
  475.  
  476.          I - Display info file.
  477.  
  478.              This  command  will  display the  BPQYAPP.INF  file  if  one
  479.         exists.   Use   it  to  show  your   stations   hardware/software
  480.         configuration and anything else you may wish to tell the user.
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.         BPQYAPP V 1.00                  8                        04/07/91
  489.  
  490.  
  491.  
  492.          U <area> <file> - Upload file.
  493.  
  494.              This is used to upload a file using YAPP transfer. The  area
  495.         can be A to Z if setup in the configuration file by the sysop.
  496.  
  497.                 eg. U A MYPROG.EXE
  498.  
  499.          V - Show version.
  500.  
  501.              This  will  show  what version of the Yapp  File  Server  is
  502.         running.
  503.  
  504.          W - List file areas.
  505.  
  506.              This will list the file areas as configured by the sysop  in
  507.         the  BPQYAPP.CFG  file. Each area will indicate whether  you  can
  508.         download and upload to it.
  509.  
  510.          W <area> (filespec) - List files (matching filespec).
  511.  
  512.            This  will list all the files matching the  optional  filespec
  513.         (defaulting to all files) contained in that particular area.  The
  514.         area can be A to Z if setup by the sysop.
  515.  
  516.                 eg. W A *.ZIP
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.         BPQYAPP V 1.00                  9                        04/07/91
  550.  
  551.  
  552.  
  553.         Appendix A - My BPQCFG.TXT File
  554.         ==========   ------------------
  555.  
  556.         ; For Version 3.59
  557.         ;
  558.         ;
  559.         ; CONFIGURATION FILE FOR G8BPQ SWITCH SOFTWARE
  560.         ;
  561.         ; The program which converts this text file to binary
  562.         ; form is currently very crude - be VERY careful when
  563.         ; editing this file!
  564.         ;
  565.         ;
  566.         ; The order of parameters in not important, but they
  567.         ; all must be specified - there are no defaults
  568.         ;
  569.         ;
  570.         ;
  571.         ; Memory Usage. If EMS=1, the system will attempt to put its
  572.         ; data area into EMS Memory. At the moment it makes no attempt
  573.         ; to manage sharing of the EMS window, so you must not run any
  574.         ; other software using EMS.
  575.         ;
  576.         ; It seems to work ok when used with Desqview, at least on my
  577.         ; AST, but it is primarily intended for use with AA4RE BBS, which
  578.         ; needs a great deal of space.
  579.         ;
  580.         ;
  581.         EMS=0                           ; dont use EMS RAM
  582.         ;
  583.         ; I seem to have problems with systems not using DESQVIEW -
  584.         ; especially NNA BBS's. The DV calls SHOULD be ignored if DV is
  585.         ; not loaded, but just in case, if you set DESQVIEW=0, the
  586.         ; 'Release Timeslice' call wont be used. MAKE SURE that you set
  587.         ; DESQVIEW=1 if using DV, or performance will be seriously
  588.         ; affected.
  589.         ;
  590.         DESQVIEW=1
  591.         ;
  592.         ;
  593.         ; Station Identification.
  594.         ;
  595.         ; If a user connects to the NODE Callsign or Alias, he is linked
  596.         ; to the switch code, and can use normal NetRom/TheNet commands
  597.         ;
  598.         ; If he connects to the BBS Callsign or Alias he will be connected
  599.         ; directly to a BBS port. If none are available, the connect will
  600.         ; be rejected.
  601.         ;
  602.         ; Note that of you are running only a NODE (ie BBS=0), or
  603.         ; or just a BBS (NODE=0), then you must still put in two pairs of
  604.         ; calls, but they MUST be the SAME.
  605.         ;
  606.         ; If you are running both, the calls MUST be different
  607.  
  608.  
  609.  
  610.         BPQYAPP V 1.00                  10                        04/07/91
  611.  
  612.  
  613.  
  614.         NODECALL=G7JJF-8                ; NODE CALLSIGN
  615.         NODEALIAS=IP0423
  616.  
  617.  
  618.         BBSCALL=G7JJF                   ; BBS CALLSIGN
  619.         BBSALIAS=JJFPMS                 ; BBS ALIAS
  620.  
  621.         ;
  622.         ; 'ID' MESSAGE - SENT EVERY IDINTERVAL MINS
  623.         ;
  624.         ; WILL BE ADDRESSED FROM THE PORT CALLSIGN (IF DEFINED)
  625.         ;      ELSE FROM THE NODE CALL
  626.         ;
  627.         ; The following format allows KA nodes to include your system in
  628.         ; their 'Nodes' lists.
  629.         ;
  630.         IDMSG:
  631.         Network node (IP0423) running TNCBPQ V1.40 and BPQ Yapp Server V1.00
  632.         ***
  633.         ;
  634.         UNPROTO=MAIL                         ; DEFAULT UNPROTO ADDR
  635.  
  636.         ; 'I' COMMAND TEXT
  637.         ;
  638.         ; Note that the bit about needing a port param in connects is only
  639.         ; necessary if you are running more that one (radio) port.
  640.         ;
  641.         INFOMSG:
  642.         G7JJF Packet Switch, Sutton In Ashfield, Notts. IO93IC
  643.         Commands are basically the same as NET/ROM, but to connect to
  644.         another normal station (not another node), you must specify a
  645.         port number before the callsign. Use PORTS command to list
  646.         available ports. The PMS command connects you to the associated
  647.         Mailbox and the YAPP command takes you to a Yapp File Server
  648.         for downloading/uploading of files.
  649.         ***
  650.         ; CTEXT - If specified, will be sent when someone connects to
  651.         ; the NODE ALIAS at level 2. It is not sent on connects to the
  652.         ; NODE callsign, as this could confuse BBS forwarding connect
  653.         ; scripts.
  654.         ;
  655.         CTEXT:
  656.         Welcome to G7JJF's Packet Switch in Sutton In Ashfield
  657.         Type ? for list of available commands.
  658.         ***
  659.  
  660.  
  661.         ;       Network System Parameters
  662.         ;
  663.         OBSINIT=5               ; INITIAL OBSOLESCENCE VALUE
  664.         OBSMIN=4                ; MINIMUM TO BROADCAST
  665.         NODESINTERVAL=60        ; 'NODES' INTERVAL IN MINS
  666.         IDINTERVAL=15           ; 'ID' BROADCAST INTERVAL (UK Regs require
  667.                                 ; an AX25 ID every 15 mins)
  668.         ;
  669.  
  670.  
  671.         BPQYAPP V 1.00                  11                        04/07/91
  672.  
  673.  
  674.  
  675.         BTINTERVAL=15           ; NO BEACONS
  676.         L3TIMETOLIVE=25         ; MAX L3 HOPS
  677.         L4RETRIES=3             ; LEVEL 4 RETRY COUNT
  678.         ;
  679.         ; I have seen suggestions that L4TIMEOUT should be increased to very
  680.         ; high values (even as long as seven mins). Although 60 may be a bit
  681.         ; short in some cases, I STRONGLY advise that you dont go much above
  682.         ; 120 secs unless you understand ALL the implications.
  683.         ;
  684.         ; I've set TTL and TIMEOUT to the values agreed by the latest SYSOPS
  685.         ; meeting - this does not imply that I agree with them!
  686.         ;
  687.         L4TIMEOUT=120           ; LEVEL 4 TIMEOUT
  688.         L4DELAY=10              ; LEVEL 4 DELAYED ACK TIMER
  689.         L4WINDOW=4              ; DEFAULT LEVEL 4 WINDOW
  690.         ;
  691.         MAXLINKS=30             ; MAX LEVEL 2 LINKS (UP,DOWN AND INTERNODE)
  692.         MAXNODES=120            ; MAX NODES IN SYSTEM
  693.         MAXROUTES=35            ; MAX ADJACENT NODES
  694.         MAXCIRCUITS=64          ; NUMBER OF L4 CIRCUITS
  695.         minqual=10              ; MINIMUM QUALITY TO ADD TO NODES TABLE
  696.  
  697.         BBSQUAL=250             ; BBS Quality relative to NODE - used to
  698.                                 ; limit 'spread' of BBS through the
  699.                                 ; network to your required service area.
  700.                                 ; I've been asked to set a low default to
  701.                                 ; encourage you to think about a suitable
  702.                                 ; value. Max is 255
  703.  
  704.         BUFFERS=255             ; PACKET BUFFERS - 255 MEANS ALLOCATE AS MANY
  705.                                 ; AS POSSIBLE - NORMALLY ABOUT 130,
  706.                                 ; DEPENDING  ON OTHER TABLE SIZES
  707.         ;
  708.         ;       TNC DEFAULT PARAMS
  709.         ;
  710.         PACLEN=128                      ; MAX PACKET SIZE
  711.         ;
  712.         ; PACLEN is a problem! The ideal size depends on the link(s) over
  713.         ; which a packet will be sent. For a session involving another node,
  714.         ; we have no idea what is at the far end. Ideally each node should have
  715.         ; the capability to combine and then refragment messages to suit each
  716.         ; link segment - maybe when there are more of my nodes about than 'real'
  717.         ; ones, i'll do it. When the node is accessed directly, things are a
  718.         ; bit easier, as we know at least something about the link. So, from
  719.         ; Version 3.11 onwards, there are two PACLEN params, one here and
  720.         ; one in the PORTS section. This one is used to set the initial value
  721.         ; for sessions via other nodes, and for sessions initiated from here.
  722.         ; The other is used for incoming direct (Level 2)       sessions.
  723.         ; In all cases the TNC PACLEN command can be used to override
  724.         ; the defaults.
  725.         ;
  726.         ; The main reason for changing this now was a request from someone
  727.         ; wanting to run an HF port.
  728.         ;
  729.         ;
  730.  
  731.  
  732.         BPQYAPP V 1.00                  12                        04/07/91
  733.  
  734.  
  735.  
  736.         ;
  737.         TRANSDELAY=1            ; TRANSPARENT MODE SEND DELAY - 1 SEC
  738.         ;
  739.         ;       Level 2 Parameters
  740.         ;
  741.         ; T1, T2 and N2 are now int the PORTS section
  742.         ;
  743.         T3=180                  ; LINK VALIDATION TIMER (3 MINS)
  744.  
  745.         IDLETIME=900            ; IDLE LINK SHUTDOWN TIMER (15 MINS)
  746.         ;
  747.         ;
  748.         ;       Configuration Options
  749.         ;
  750.         BBS=1                   ; INCLUDE BBS SUPPORT
  751.         NODE=1                  ; INCLUDE SWITCH SUPPORT
  752.         ;
  753.         HIDENODES=0             ; IF SET TO 1, NODES STARTING WITH # WILL
  754.                                 ; ONLY BE DISPLAYED BY A NODES * COMMAND
  755.         ;
  756.         ;
  757.         ;
  758.         ;       'COMBIOS' Port definitions.
  759.         ;
  760.         ;       This section defines the virtual TNC's that the code supports.
  761.         ;
  762.         ;       I'm afraid this is now rather more complicated than it was!
  763.         ;
  764.         ;       You can now define any COMBIOS port to run in normal (TNC2)
  765.         ;       mode, PK232 HOSTMODE (with varients for UFQ and AA4RE), or KISS
  766.         ;       mode. KISS mode allows you to run things like TCP/IP, STATS
  767.         ;       packages, PACSAT Telemetry decode, etc above the switch.
  768.         ;
  769.         ;       The basic format is:
  770.         ;
  771.         ;           TNCPORT
  772.         ;               COM=n           ; COMBIOS port number
  773.         ;               TYPE=TNC2|KISS|PK232/AA4RE|PK232/UFQ
  774.         ;               KISSMASK=nn     ; Required only for KISS
  775.         ;               APPLMASK=nn     ; Defaults to 1 (BBS)
  776.         ;           ENDPORT
  777.         ;
  778.         ;       TYPE defaults to TNC2. See file KISSMODE.DOC for full details
  779.         ;       of facilities available in KISS mode.
  780.         ;
  781.         ;       The two PK232 modes are equvalent to the old HOSTMODE=1 or 2,
  782.         ;       but can now be used on any port. See HOSTMODE.DOC for more
  783.         ;       details
  784.         ;       Dont try to define more than 16 ports.
  785.         ;
  786.         ;       For my software, you must decide on the port for the PMS to be
  787.         ;       accessed from. This can be anything from 1 to 15.
  788.         ;       You must then set this port, plus the following to the settings
  789.         ;       shown below :
  790.  
  791.  
  792.  
  793.         BPQYAPP V 1.00                  13                        04/07/91
  794.  
  795.  
  796.  
  797.         TNCPORT
  798.                 COM=1
  799.                 TYPE=TNC2
  800.                 APPLMASK=$03
  801.                 APPLFLAGS=$07
  802.         ENDPORT
  803.  
  804.         TNCPORT
  805.                 COM=2
  806.                 TYPE=TNC2
  807.                 APPLMASK=$08
  808.                 APPLFLAGS=$00
  809.         ENDPORT
  810.  
  811.         ;       This is the setting for my BPQ Yapp File Server if you
  812.         ;       want to install it eventually.
  813.  
  814.         TNCPORT
  815.                 COM=3
  816.                 TYPE=TNC2
  817.                 APPLMASK=$10
  818.                 APPLFLAGS=$00
  819.         ENDPORT
  820.  
  821.         PORT
  822.         ;       ID=144.625 Mhz 1200 baud
  823.                 ID=Not Active
  824.                 TYPE=ASYNC
  825.                 PROTOCOL=KISS
  826.                 IOADDR=2F8H                     ; COM1 - FOR COM2 PUT 2F8H
  827.                 INTLEVEL=3                      ; COM1 - FOR COM2 PUT 3
  828.                 SPEED=9600
  829.                 CHANNEL=A
  830.                 QUALITY=10
  831.                 MAXFRAME=2
  832.                 TXDELAY=500
  833.                 SLOTTIME=100
  834.                 PERSIST=64
  835.                 FULLDUP=0
  836.                 FRACK=7000
  837.                 RESPTIME=2000
  838.                 RETRIES=10
  839.                 PACLEN=120
  840.  
  841.         ENDPORT
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.         BPQYAPP V 1.00                  14                        04/07/91
  855.  
  856.  
  857.  
  858.         ;
  859.         ;       2ND PORT OF KPC4/KAM (FIRST PORT IS DEFINED AS ABOVE)
  860.         ;
  861.         PORT
  862.         ;       ID=432.675 Mhz 1200 baud
  863.                 ID=144.625 Mhz 1200 baud
  864.                 TYPE=ASYNC
  865.                 PROTOCOL=KISS
  866.                 IOADDR=2F8H
  867.                 INTLEVEL=3
  868.                 SPEED=9600
  869.                 CHANNEL=B       ; this is the special bit for KAM/KPC4
  870.                 QUALITY=10
  871.                 MAXFRAME=2
  872.                 TXDELAY=500
  873.                 SLOTTIME=100
  874.                 PERSIST=64
  875.                 FULLDUP=0
  876.                 FRACK=7000
  877.                 RESPTIME=2000
  878.                 RETRIES=10
  879.                 PACLEN=120
  880.  
  881.         ENDPORT
  882.  
  883.         ROUTES:
  884.         ;
  885.         ;       ROUTES TO LOCK IN
  886.         ;
  887.         ;       specify Callsign, Quality and Port. You can now also specify
  888.         ;       MAXFRAME, FRACK, PACLEN (in that order) to override the port
  889.         ;       defaults.
  890.         ;
  891.         ;
  892.         ***
  893.         ;
  894.         ;       APPLICATIONS SUPPORTED
  895.         ;
  896.         ;       UP TO 8 ENTRIES OF UP TO 12 BYTES EACH
  897.         ;
  898.         ;       THE FIRST 3 ARE RESERVED FOR BBS, HOST, AND REMOTE SYSOP
  899.         ;       YOU CAN DEFINE THE OTHERS AS YOU LIKE.
  900.         ;
  901.         ;       FOR COMPATIBILITY WITH EARLIER VERSIONS, JUST ENTER
  902.         ;       APPLICATIONS=BBS
  903.         ;
  904.         ;       NAMES STARTING WITH * ARE NOT INCLUDED IN 'VALID COMMANDS'
  905.         ;       DISPALY
  906.         ;
  907.         APPLICATIONS=PMS,,*SYS,MH,YAPP
  908.         ;
  909.         ;
  910.  
  911.  
  912.  
  913.  
  914.  
  915.         BPQYAPP V 1.00                  15                        04/07/91
  916.  
  917.  
  918.  
  919.         Appendix B - Recognised Users
  920.         ==========   ----------------
  921.  
  922.  
  923.  
  924.              Jon      G7JJF
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.              If  you have any problems using the software, first  of  all
  937.         please  read this manual thoroughly. The answer to most  of  your
  938.         questions  will  be hidden somewhere. If all else  fails,  please
  939.         contact me at the address given below or G7JJF @ GB7FLG for  help
  940.         and advice.
  941.  
  942.  
  943.              I  would  also appreciate any input you would care  to  give
  944.         concerning  the program.  If you have any ideas or comments  that
  945.         would make it a better program, then please let me know.
  946.  
  947.  
  948.  
  949.  
  950.               *****************************************************
  951.               **** Remember To Support Your Local Packet Group ****
  952.               *****************************************************
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.         Jon Welch,                 G7JJF @ GB7FLG.#23.GBR.EU
  960.         50 Quarrydale Road,        CompuServe ID : 100012,2607
  961.         Sutton In Ashfield,
  962.         Notts. NG17 4DR.
  963.         Great Britain
  964.  
  965.         4th July, 1991
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.         BPQYAPP V 1.00                  16                        04/07/91
  977.