home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / hamradio / b_yapp.zip / YAPP.DOC < prev   
Text File  |  1993-01-01  |  7KB  |  174 lines
  1. Quick translation from finnish original files:
  2.  
  3.  
  4. BYAP.EXE / BYAPT.EXE
  5. --------------------
  6.  
  7. Latest versions of programs to receive and transmit files with YAPP protocol
  8. using BAYCOM software.
  9.  
  10. Some bugs from version 1 are corrected and transmit part of system is
  11. added to this version.
  12.  
  13. There might be more bugs, time shows....please report if you notice something!
  14.  
  15. -----------------------------------------------------------------------------
  16. The original idea of YAPP receive comes from IW0CTY's program BINYAPP.COM
  17.  
  18. I have written these programs with Turbo Pascal 5.5, based on IW0CTY's idea
  19. and my own tests with local bbs (FBB 5.14d) and Baycom.
  20.  
  21. Compared to BINYAPP, my programs:
  22.  
  23.                 - are LOT MORE faster !
  24.                 - are using YAPP-header for filename and lenght detection
  25.                 - can prepare files also for YAPP transmit !
  26.                 - are using ST-MACROs in Baycom for easier operation
  27.  
  28.  
  29.  73'Saku   OH1KH @ OH1RBF.FIN.EU
  30.                  @ UO22
  31.  
  32. -----------------------------------------------------------------------------
  33. -----------------------------------------------------------------------------
  34. -----------------------------------------------------------------------------
  35.  
  36. YAPP RECEIVING WITH BAYCOM  (ST-MACROS):
  37. ----------------------------------------
  38. If you are NOT using st-macros, just give BYAP at dos prompt to get help
  39. for manual download of YAPP files.
  40.  
  41.        Yapp receiving with ST-macros ALT-A and ALT-S :
  42.  
  43.                - Go to  FBBDOS
  44.                - Give  YGET TEST.EXE  (we want to take TEST.EXE with YAPP)
  45.                - BBS will reply "Ready to send......" ^E^A
  46.                  (chars ^E^A are control codes and they will be red at Baycoms)
  47.                  (screen, or inverse if monocrome display is used)
  48.                - Reply to this with  ALT-A
  49.                - BBS starts to send  TEST.EXE  and when it is finished, last
  50.                  characters will be ^C^A.
  51.                - At that point press  ALT-S
  52.                - BBS will answer ^X^FAbort and returns to FBBDOS.
  53.                  (There will be additional command "BUG" because my home bbs)
  54.                  (OH1RBF (FBB 5.14d) seems to go infinity loop sending prompt)
  55.                  (after succesfull download (?!?) "Wrong command" will release)
  56.                  (bbs from this loop and it works again normally. )
  57.                - There will now be "YAPP.IN" file in default directory and it
  58.                  is next processed with BYAP.EXE to dig out original name and
  59.                  data. After process "YAPP.IN is deleted".
  60.                - BYAP.EXE will prompt you if it founds out that file processed
  61.                  is different in size than BBS has reported in header. In this
  62.                  case you should repeat the download again.
  63.  
  64. -----------------------------------------------------------------------------
  65.  
  66. YAPP TRANSMIT WITH BAYCOM  (ST-MACROS):
  67. ----------------------------------------
  68. If you are NOT using st-macros, just give BYAPT at dos prompt to get help
  69. for manual transmit.
  70.  
  71.  
  72.        Yapp transmit with  ST-macros ALT-Q, ALT-W, ALT-E ja ALT-R
  73.  
  74.                  (we want to send file TEST.EXE to BBS)
  75.  
  76.                - At Dos, (outside of Baycom) start BYAPT.EXE using the transmit
  77.                  file name as parameter.   I.E.    BYAPT TEST.EXE
  78.                  (BYAPT prepares TEST.EXE into two files: YAPP.HEA)
  79.                  (and YAPP.OUT for transmit.)
  80.                - Goto Baycom
  81.                - At BBS prompt, goto FBBDOS
  82.                - Give  YPUT TEST.EXE
  83.                - BBS answers "Give description of file max 40chr"
  84.                - Reply with text needed for description (or just enter)
  85.                - BBS answers  "Ready to receive ......."
  86.                - Answer to this by pressing ALT-Q
  87.                - BBS will reply ^F^A
  88.                  (chars ^E^A are control codes and they will be red at Baycoms)
  89.                  (screen, or inverse if monocrome display is used)
  90.                - Then give  ALT-W
  91.                - BBS answers ^F^B
  92.                - Answer with ALT-E
  93.                - Look at data transfer. If bbs will suddenly send ^X^FAbort
  94.                  while transfer is still going on, press ALT-R and start all
  95.                  again from beginning.
  96.                - When transfer has gone to end without Abort BBS will
  97.                  send ^F^C at the end of transfer
  98.                - Answer to this by pressing ALT-R
  99.                - BBS will reply ^F^D, and soon after that it will send
  100.                  "File saved...." and FBBDOS prompt appear again.
  101.                  (There will be additional command "BUG" because my home bbs)
  102.                  (OH1RBF (FBB 5.14d) seems to go infinity loop sending prompt)
  103.                  (after succesfull upload (?!?) "Wrong command" will release)
  104.                  (bbs from this loop and it works again normally. )
  105.                - Transfer has been completed. YAPP.HEA and YAPP.OUT need not to
  106.                  be deleted, as BYAPT will rewrite them on next run.
  107.  
  108.  
  109.  
  110. ---------------------------------------------------------------------------
  111. SCC.INI additions:
  112. -----------------
  113. Add this to your SCC.INI file of Baycom . Change function keys if you have
  114. reserved ALT- A,S,Q,W,E,R for other purposes before !
  115.  
  116. You may also change file name of YAPP.IN , and paths to YAPP.IN , YAPP.HEA
  117. and YAPP.OUT.
  118. I expect you will put BYAP.EXE and BYAPT.EXE to Baycom subdir. If not,
  119. you have to change also path to BYAP.EXE on "ST S4"-line.
  120.  
  121. You may remove comment lines (;-chr at beginning).
  122.  
  123.  
  124.  
  125. ; Definition of the Standard Texts.
  126. ; --------------------------------
  127. ;
  128. ; YAPP start receiving --> answer to  ^E^A from bbs   (alt-a)
  129. st a0 \x:paclen 1
  130. ; Data is collected into "YAPP.IN" file
  131. st a1 wprg yapp.in
  132. st a2 \x
  133. ;
  134. ; YAPP stop receiving  --> answer  to ^C^A from bbs  (alt-s)
  135. st s0 \x
  136. st s1 \x:wprg off
  137. st s2 pacl 230
  138. st s3 \xbug
  139. ; !!at least my home bbs (FBB 5.14d) goes to loop, sending FBBDOS prompt
  140. ;after succesfull YAPPing. Text  BUG will produce "wrong command" and it
  141. ;will break the prompt loop. You can try without this line how it works
  142. ;with your home bbs  (???!)
  143. ; after succesfull receiving the "YAPP.IN" file is processed and deleted
  144. ; in dos shell
  145. st s4 \x:o byap yapp.in
  146. st s5 \x:o del yapp.in
  147. st s6 \x
  148. ;
  149. ; YAPP transmit--> answer to "Ready receiving file ......" from bbs (alt-q)
  150. st q1 \x:paclen 1
  151. st q2 \x
  152. ;
  153. ; YAPP transmit--> answer to ^F^A from bbs (Send header)   (alt-w)
  154. st w0 \x:paclen 256
  155. ; "YAPP.HEA" is produced by "BYAPT" transmit preparation program
  156. st w1 rprg yapp.hea
  157. ;
  158. ; YAPP transmit--> answer to ^F^B (send data)  (alt-e)
  159. ; "YAPP.OUT" is produced by "BYAPT" transmit preparation program
  160. st e \x:rprg yapp.out
  161. ;
  162. ; YAPP transmit--> answer to  ^F^C (end of transmit) (alt r)
  163. st r0 \x:paclen 1
  164. st r1 \x
  165. st r2 \x:rprg off
  166. st r3 \x:paclen 230
  167. st r4 \xbug
  168. ; !!at least my home bbs (FBB 5.14d) goes to loop, sending FBBDOS prompt
  169. ;after succesfull YAPPing. Text  BUG will produce "wrong command" and it
  170. ;will break the prompt loop. You can try without this line how it works
  171. ;with your home bbs  (???!)
  172. ----------------------------------------------------------
  173.  
  174.