home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / z3sys / recorder.hlp < prev    next >
Encoding:
Text File  |  1993-06-08  |  5.9 KB  |  136 lines
  1. ;
  2.  
  3.                                 RECORDe≥ 4.0
  4.                       Copyrigh⌠ (c⌐ 198╣ Alphß Systems
  5.                              Al∞ right≤ reserved
  6.  
  7.           1«  Introductioε              3«  Systeφ Requirements
  8.           2«  Usinτ RECORDe≥            4«  Ho≈ i⌠ Works
  9.  
  10.                        Pres≤ numbe≥ fo≥ desireΣ topic
  11.                            (Control-├ Quit≤ HELP)
  12.  
  13.                           Alphß System≤ Corporation
  14.                             71▒ ChatswortΦ Place
  15.                          Saε Jose¼ California 95128
  16.                                 (408)297-5594
  17.  
  18. :1
  19. Introductioε t∩ RECORDe≥ 4.0
  20.  
  21. RECORDe≥ wil∞ allo≈ yo⌡ t∩ direc⌠ consolσ outpu⌠ t∩ ß particula≥ filσ a≤ wel∞ ì
  22. a≤ át∩ áthσ console«  I⌠ wil∞ als∩ allo≈ yo⌡ t∩ direc⌠ printe≥ áoutpu⌠ át∩ áß ì
  23. particula≥ áfilσ áinsteaΣ áoµ t∩ thσ printer«  An∙ numbe≥ áoµ áfile≤ áma∙ ábσ ì
  24. createΣ t∩ holΣ thesσ datß anΣ an∙ tw∩ oµ theφ ma∙ bσ opeε t∩ receivσ consolσ ì
  25. anΣ printe≥ outpu⌠ a≤ i⌠ occurs.
  26.  
  27. Consolσ recordinτ i≤ usefu∞ iε tha⌠ CONSOLE.FI╠ hold≤ al∞ thσ character≤ sen⌠ ì
  28. t∩ áCONOU╘ áwithou⌠ áregarΣ t∩ an∙ formattinτ o≥ deletion≤ donσ áb∙ áthσ áDO╙ ì
  29. functions«  CONSOLE.FI╠ i≤ ß faithfu∞ reproductioε oµ everythinτ sen⌠ t∩ áthσ ì
  30. Consolσ (excep⌠ 1Ah⌐ whethe≥ througΦ DO╙ o≥ directl∙ througΦ BIOS.
  31.  
  32. Printe≥ árecordinτ ácapture≤ al∞ character≤  sen⌠ t∩ LIS╘ (excep⌠ á1Ah⌐ áint∩ ì
  33. PRINTER.FI╠ árathe≥ thaε sendinτ theφ directl∙ t∩ thσ printer«  Thi≤ i≤ ámucΦ ì
  34. faste≥ thaε actua∞ printing«  PRINTER.FI╠ caε bσ printeΣ late≥ witΦ an∙ Prin⌠ ì
  35. prograφ o≥ iε thσ backgrounΣ witΦ BPRINTe≥ IOP.
  36.  
  37. :2
  38. Usinτ RECORDe≥ 4.0
  39.  
  40. RECORDe≥ áconsist≤ áoµ tw∩ files¼ RECORD.CO═ whicΦ i≤ thσ ácommanΣ áfilσ áanΣ ì
  41. loade≥ anΣ RECORDER.RE╠ whicΦ i≤ thσ actua∞ IO╨ whicΦ doe≤ thσ work.
  42.  
  43. Wheε áRECOR─ i≤ invokeΣ fo≥ anythinτ bu⌠ specifiπ Help¼ i⌠ wil∞ checδ t∩ áseσ ì
  44. whethe≥ áRECORDER.RE╠ i≤ loadeΣ a≤ thσ IO╨ and¼ iµ not¼ closσ u≡ thσ ácurren⌠ ì
  45. IO╨ áanΣ searcΦ anΣ loaΣ RECORDER.RE╠ froφ alonτ thσ Path¼ theε áexecutσ áthσ ì
  46. commanΣ á(Typσ áRECOR─ //<CR╛ fo≥ specifiπ oε-linσ Help)« á Therσ áarσ áeigh⌠ ì
  47. command≤ t∩ perforφ variou≤ setup≤ anΣ functions:
  48.  
  49.  
  50.                           RECOR─ ├ [DIR:][FILE.TYP]
  51.  
  52. Definσ Consolσ outpu⌠ filσ specification«  Thσ defaul⌠ consolσ outpu⌠ filσ i≤ ì
  53. CONSOLE.FI╠ áiε thσ curren⌠ directory«  Yo⌡ ma∙ direc⌠ tha⌠ filσ át∩ áanothe≥ ì
  54. director∙ anΣ/or changσ it≤ name«  
  55.  
  56.  
  57.                           RECOR─ ╨ [DIR:][FILE.TYP]
  58.  
  59. Definσ Printe≥ outpu⌠ filσ specification«  Thσ defaul⌠ i≤ PRINTER.FI╠ iε áthσ ì
  60. curren⌠ ádirectory«  A≤ witΦ thσ Consolσ file¼ yo⌡ ma∙ pu⌠ i⌠ wherσ yo⌡ álikσ ì
  61. anΣ/or changσ it≤ name.
  62.  
  63.                                   RECOR─ D
  64.  
  65. Rσ-establisΦ áthσ ádefaul⌠ áoutpu⌠ filσ áspecification≤ áa≤ áCONSOLE.FI╠ áanΣ ì
  66. PRINTER.FI╠ iε thσ curren⌠ directory.
  67.  
  68.  
  69.                                   RECOR─ F
  70.  
  71. Displa∙ áthσ ácurrentl∙ declareΣ outpu⌠ filσ specifications«  Usσ C¼ ╨ áo≥ á─ ì
  72. command≤ t∩ changσ theφ iµ necessary.
  73.  
  74.                                   RECOR─ ON
  75.  
  76. Opeε áthσ curren⌠ Consolσ Outpu⌠ filσ (o≥ creatσ i⌠ iµ i⌠ doesn'⌠ exist⌐ áanΣ ì
  77. senΣ áconsolσ outpu⌠ t∩ thσ filσ a≤ wel∞ a≤ t∩ thσ console«  Iµ thσ áfilσ ái≤ ì
  78. rσ-opened¼ outpu⌠ i≤ concatenateΣ t∩ it«  Consolσ outpu⌠ i≤ sen⌠ verbatiφ át∩ ì
  79. thσ áfilσ áexcep⌠ átha⌠ áCntr∞-┌ (1Ah⌐ character≤ áarσ áfiltereΣ áout« á Sto≡ ì
  80. Consolσ recordinτ witΦ thσ RECOR─ OF╞ command.
  81.  
  82.  
  83.                                  RECOR─ OFF
  84.  
  85. Writσ thσ las⌠ recorΣ oµ thσ Consolσ Outpu⌠ filσ anΣ closσ it«  Thσ filσ áma∙ ì
  86. bσ árσ-openeΣ witΦ thσ RECOR─ O╬ command«  A⌠ thi≤ poin⌠ yo⌡ ma∙ ádefinσ áye⌠ ì
  87. anothe≥ áConsolσ áOutpu⌠ áfilσ witΦ thσ ├ command¼ iµ yo⌡ áwish¼ áanΣ ádirec⌠ ì
  88. consolσ outpu⌠ t∩ i⌠ afte≥ thσ nex⌠ RECOR─ O╬ command.
  89.  
  90.                                  RECOR─ O╬ P
  91.  
  92. Opeε (o≥ create⌐ thσ curren⌠ Printe≥ Outpu⌠ filσ anΣ senΣ LIS╘ outpu⌠ t∩ áthσ ì
  93. filσ áinsteaΣ oµ t∩ thσ printer«  Iµ thσ Printe≥ Outpu⌠ filσ alread∙ áexists¼ ì
  94. LIS╘ outpu⌠ wil∞ bσ concatenateΣ t∩ it«  LIS╘ outpu⌠ i≤ sen⌠ verbatiφ t∩ áthσ ì
  95. filσ áexcep⌠ átha⌠ Cntr∞-┌ (1Ah⌐ character≤ arσ filtereΣ out« á Sto≡ áPrinte≥ ì
  96. recordinτ witΦ thσ RECOR─ OF╞ ╨ command.
  97.  
  98.  
  99.                                 RECOR─ OF╞ P
  100.  
  101. Writσ áthσ las⌠ recorΣ anΣ closσ thσ curren⌠ Printe≥ Outpu⌠ file« á Thσ áfilσ ì
  102. ma∙ ábσ rσ-openeΣ witΦ thσ RECOR─ O╬ ╨ commanΣ o≥ yo⌡ ma∙ no≈ definσ áanothe≥ ì
  103. Printe≥ áOutpu⌠ áfilσ áwitΦ thσ ╨ command«  Subsequen⌠ LIS╘ áoutpu⌠ áwil∞ ábσ ì
  104. directeΣ t∩ thσ ne≈ filσ afte≥ thσ nex⌠ RECOR─ O╬ ╨ command.
  105.  
  106. :3
  107. Systeφ Requirements
  108.  
  109. RECORDe≥ require≤ ß Z8░ baseΣ ┌-Systeφ (ZRDO╙ 1.╣ o≥ ZSDO╙ 1.0⌐ witΦ a⌠ leas⌠ ì
  110. 1.5δ IOP«  Therσ i≤ n∩ advantagσ iε declarinτ aε IO╨ large≥ thaε 1.5δ bytes.
  111.  
  112. RECORDe≥ use≤ thσ reentran⌠ capabilitie≤ oµ ZRDO╙ o≥ ZSDO╙ whilσ writinτ áthσ ì
  113. record≤ oµ CONSOLE.FI╠ and/o≥ PRINTER.FI╠ t∩ disk«  StandarΣ DR╔ BDO╙ 2.▓ áo≥ ì
  114. othe≥ DO╙ replacement≤ arσ no⌠ reentran⌠ anΣ wil∞ fail«  
  115.  
  116.  
  117. :4
  118. Ho≈ i⌠ Works
  119.  
  120. RECORDe≥ átrap≤ ácharacte≥ áoutpu⌠ call≤ t∩ CONOU╘ anΣ áLIS╘ áanΣ ásend≤ áthσ ì
  121. characte≥ t∩ thσ appropriatσ Outpu⌠ buffe≥ beforσ passinτ i⌠ t∩ thσ BIOS«  Iε ì
  122. thσ ácasσ áoµ LIS╘ output¼ thσ characte≥ i≤ no⌠ sen⌠ t∩ thσ BIO╙ a⌠ áal∞ áanΣ ì
  123. wσ simpl∙ returε t∩ thσ caller«  A≤ thσ Consolσ and/o≥ Printe≥ buffer≤ áfill¼ ì
  124. the∙ arσ writteε t∩ thσ Outpu⌠ file(s⌐ oε disk«  Thσ OF╞ anΣ ─ command≤ áwil∞ ì
  125. writσ thσ las⌠ record(s⌐ anΣ closσ thσ appropriatσ outpu⌠ file(s).
  126.  
  127. Becausσ áoµ thσ wa∙ ZRDO╙ anΣ ZSDO╙ reentrancσ works¼ RECORDer'≤ áwritinτ át∩ ì
  128. disδ iε thσ backgrounΣ ma∙ interferσ witΦ applicatioε program≤ writinτ t∩ thσ ì
  129. samσ ádisδ iε thσ foreground¼ especiall∙ iµ thσ applicatioε i≤ áusinτ áRandoφ ì
  130. Write«  
  131.  
  132. Thi≤ potentia∞ conflic⌠ ma∙ bσ avoideΣ iµ CONSOLE.FI╠ and/o≥ PRINTER.FI╠ áarσ ì
  133. directeΣ t∩ ß differen⌠ drive«  Iµ you≥ applicatioε i≤ writinτ variou≤ áfile≤ ì
  134. iε drivσ A¼ yo⌡ migh⌠ assigε CONSOLE.FI╠ o≥ PRINTER.FI╠ t∩ drivσ ┬ anΣ áavoiΣ ì
  135. an∙ chancσ oµ conflict.
  136.