home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / uploads / z3help43.lbr / IOPCLK.HZP / IOPCLK.HLP
Encoding:
Text File  |  1993-06-07  |  9.0 KB  |  197 lines
  1. ;
  2.                                                    
  3.                            ---  I O P C L K  ---          
  4.                                                    
  5.                                 Version 1.0
  6.  
  7.                            An IOP Clock Utility
  8.                       For ZCPR3 and ZSDOS With Clock
  9.  
  10.  
  11.  
  12.                          I -->  Installation       
  13.                          C -->  Configuration      
  14.                          O -->  Overview           
  15.                          S -->  Syntax             
  16.                          / -->  Options          
  17.  
  18. :I                       
  19. Installation
  20.  
  21. Thσ distributioε versioε oµ IOPCLK i≤ supplieΣ witΦ ß Z3EN╓ addres≤ oµ ì
  22. 0000H¼ read∙ fo≥ usσ iε ZCPR33½ environments«  ZCPR3░ user≤ shoulΣ instal∞ ì
  23. REMIND usinτ thei≥ regula≥ installatioε methods«  ì
  24.  
  25. Beforσ i⌠ caε bσ run¼ IOPCLK.CO═ mus⌠ bσ configureΣ fo≥ you≥ termina∞ s∩ ì
  26. tha⌠ i⌠ wil∞ senΣ it≤ displa∙ t∩ you≥ terminal'≤ hos⌠ compute≥ messagσ ì
  27. field«  Seσ thσ sectioε oε Configuratioε fo≥ information.
  28. :C
  29. Configurationì
  30.  
  31. Configurσ IOPCL╦ usinτ ZCNF╟ anΣ IOPCLK.CFG«  IOPCL╦ i≤ designeΣ t∩ placσ ì
  32. it≤ displa∙ int∩ you≥ terminal'≤ hos⌠ compute≥ messagσ field«  Man∙ moderε ì
  33. terminal≤ providσ onσ o≥ morσ specia∞ messagσ field≤ abovσ anΣ belo≈ thσ ì
  34. norma∞ displa∙ screeε t∩ displa∙ message≤ sucΦ a≤ functioε ke∙ label≤ anΣ ì
  35. hos⌠ compute≥ messages«  SucΦ ß messagσ fielΣ i≤ aε idea∞ placσ t∩ displa∙ ì
  36. ß clock«  However, eacΦ termina∞ require≤ ß differen⌠ termina∞ contro∞ ì
  37. strinτ t∩ identif∙ sucΦ ß messagσ anΣ thσ requireΣ strinτ i≤ no⌠ onσ oµ thσ ì
  38. string≤ includeΣ iε thσ ZCPR│ Z3TCAP«  Thi≤ require≤ yo⌡ t∩ d∩ ß littlσ ì
  39. homeworδ witΦ you≥ termina∞ manua∞ t∩ finΣ thσ correc⌠ sequences«  A≤ yo⌡ ì
  40. looδ througΦ you≥ manual¼ kee≡ iε minΣ tha⌠ wheε yo⌡ configurσ IOPCL╦ usinτ ì
  41. ZCNFG¼ thσ termina∞ strinτ character≤ mus⌠ bσ entereΣ a≤ he° bytes« 
  42.  
  43. IOPCL╦ divide≤ thσ termina∞ messagσ strinτ int∩ ┤ part≤ fo≥ easie≥ ì
  44. configuration«  Thσ termina∞ messagσ prefi° strinτ tell≤ thσ termina∞ tha⌠ ì
  45. thσ followinτ character≤ u≡ t∩ ß terminatinτ characte≥ arσ t∩ bσ displayeΣ ì
  46. iε ß specifieΣ termina∞ messagσ field«  IOPCL╦ caε theε senΣ ß numbe≥ oµ ì
  47. space≤ t∩ placσ thσ beginninτ oµ thσ clocδ displa∙ iε thσ desireΣ par⌠ oµ ì
  48. thσ messagσ field«  Thσ clocδ displa∙ i≤ theε sent¼ followeΣ b∙ thσ ì
  49. terminatinτ characte≥ tha⌠ tell≤ thσ termina∞ tha⌠ thσ messagσ i≤ complete«  
  50.  
  51. Thσ component≤ oµ thσ termina∞ messagσ strinτ are:
  52.  
  53. TERMINA╠ MESSAGE PREFI╪ STRING
  54. ES├ i≤ assumeΣ t∩ bσ thσ initia∞ character«  Yo⌡ ma∙ ente≥ u≡ t∩ ╖ ì
  55. additiona∞ he° character≤ a≤ specifieΣ b∙ you≥ termina∞ manual«  Thi≤ ì
  56. prefi° strinτ mus⌠ bσ zero-terminateΣ anΣ tell≤ thσ termina∞ tha⌠ thσ ì
  57. character≤ tha⌠ follo≈ arσ t∩ bσ displayeΣ iε thσ specifieΣ messagσ field.
  58.  
  59. SPACES
  60. Ente≥ thσ desireΣ decima∞ numbe≥ oµ leadinτ space≤ requireΣ t∩ positioε thσ ì
  61. displa∙ wherσ yo⌡ wan⌠ it«  ì
  62.      
  63. DISPLAY
  64. The clock display, configured as 'mm/dd/yy hh:mm:ss' or 'mm/dd/yy hh:mm' 
  65.  
  66. TERMINAL MESSAGE TERMINATING CHARACTER
  67. ┴ singlσ character¼ specifieΣ b∙ you≥ termina∞ manual¼ i≤ requireΣ t∩ le⌠ ì
  68. thσ termina∞ kno≈ tha⌠ thσ messagσ i≤ complete«  For a⌠ leas⌠ somσ ì
  69. terminals¼ iµ thσ las⌠ characte≥ oµ thσ messagσ strinτ appear≤ iε thσ las⌠ ì
  70. positioε iε thσ messagσ field¼ n∩ terminatinτ characte≥ i≤ requireΣ anΣ ì
  71. thi≤ bytσ shoulΣ bσ se⌠ t∩ 0.
  72.  
  73. Examples:
  74.  
  75. Wheε configureΣ t∩ placσ thσ displa∙ iε thσ righ⌠ corne≥ oµ thσ WYSE30/5░ ì
  76. hos⌠ termina∞ messagσ field¼ IOPCL╦ send≤ thσ followinτ displa∙ strinτ (thσ ì
  77. first character is always assumed to be ESC, which is not configureable):
  78.  
  79.      ESC,'F                            mm/dd/yy hh:mm:ss',CR
  80.  
  81.      Use ZCNFG to enter:
  82.           Terminal message prefix.(ESC) 46h,0 ('F',0)
  83.           Number of spaces............. 28
  84.           Terminal message termination. 0Dh (CR)
  85.  
  86. Wheε configureΣ t∩ placσ thσ displa∙ iε thσ righ⌠ corne≥ oµ thσ WYSE7╡ hos⌠ ì
  87. termina∞ messagσ field¼ IOPCL╦ send≤ thσ following displa∙ string:
  88.  
  89.      ESC,'[>+\                      mm/dd/yy hh:mm:ss\'
  90.  
  91.      Use ZCNFG to enter:
  92.           Terminal message prefix.(ESC) 5Bh,3Eh,2Bh,5Ch,0 ('[>+\',0)
  93.           Number of spaces............. 22
  94.           Terminal message termination. 5Ch ('\')
  95.  
  96. Wheε configureΣ t∩ placσ thσ displa∙ iε thσ righ⌠ corne≥ oµ thσ WYSE6░ ì
  97. (operatinτ iε VT10░ modσ witΦ ß ligh⌠ screen⌐ hos⌠ termina∞ messagσ field¼ ì
  98. IOPCL╦ send≤ thσ followinτ displa∙ strinτ (thσ 0Eh,0Fh,'Pº strinτ set≤ thσ ì
  99. messagσ attribute≤ t∩ REVERSE)«  Sincσ thσ las⌠ characte≥ oµ thσ clocδ ì
  100. displa∙ strinτ fill≤ thσ las⌠ spacσ oµ thσ messagσ field¼ n∩ terminatinτ ì
  101. characte≥ i≤ useΣ (thi≤ ma∙ no⌠ worδ witΦ othe≥ terminals!):
  102.  
  103.      ESC,'[>+\',0Eh,0Fh,'P                              mm/dd/yy hh:mm:ss'
  104.  
  105.      Use ZCNFG to enter:
  106.           Terminal message prefix.(ESC) 5Bh,3Eh,2Bh,5Ch,0Eh,0Fh,58h,0 
  107.                ('[>+\',0Eh,0Fh,'P',0)
  108.           Number of spaces............. 31
  109.           Terminal message termination. 0        
  110.  
  111. Iµ yo⌡ usσ ß darδ screen¼ usσ 'Hº (48Φ - set≤ norma∞ vide∩ witΦ underline⌐ ì
  112. o≥ 'Iº (49Φ - set≤ diφ vide∩ witΦ underline⌐ a≤ thσ las⌠ character«  
  113.  
  114. Fo≥ WYSE6░ nativσ mode¼ usσ thσ WYSE30/5░ Termina∞ messagσ prefix¼ anΣ se⌠ ì
  115. space≤ t∩ 31« 
  116. :O
  117.  
  118. Overview - 1/3ì
  119.  
  120. IOPCL╦ run≤ unde≥ ZCPR│ anΣ require≤ ZSDO╙ witΦ ß clock«  Wheε run¼ i⌠ ì
  121. load≤ ß clocδ IO╨ modulσ int∩ thσ NZCO═ IO╨ buffer«  Thσ IOPCL╦ clocδ IO╨ ì
  122. modulσ i≤ jus⌠ ove≥ 40░ byte≤ lonτ anΣ fit≤ int∩ ß 'standardº 1▓ recorΣ ì
  123. (1.5k⌐ IO╨ buffe≥ witΦ plent∙ oµ rooφ t∩ spare«  ì
  124.  
  125. IOPCL╦ provide≤ ß defaul⌠ displa∙ oµ 'mm/dd/y∙ hh:mm:ss'¼ usinτ 12-hou≥ ì
  126. 'civilianº timσ anΣ i≤ updateΣ ever∙ second«  Thσ displa∙ caε als∩ bσ ì
  127. configureΣ t∩ usσ ß defaul⌠ displa∙ oµ 'mm/dd/y∙ hh:mm'¼ whicΦ i≤ updateΣ ì
  128. ever∙ minute«  Thσ typσ oµ displa∙ caε bσ toggleΣ froφ thσ commanΣ linσ ì
  129. (actually¼ ß ne≈ IO╨ i≤ loadeΣ anΣ configureΣ eacΦ timσ IOPCL╦ i≤ run)«  
  130.  
  131.           Update display every second:  'mm/dd/y∙ hh:mm:ss' (default)
  132.        or Update display every minute:  'mm/dd/y∙ hh:mm' 
  133.  
  134. IOPCL╦ i≤ designeΣ t∩ placσ it≤ displa∙ int∩ thσ terminal'≤ hos⌠ compute≥ ì
  135. messagσ field«  Sincσ eacΦ termina∞ require≤ ß differen⌠ termina∞ contro∞ ì
  136. strinτ t∩ displa∙ sucΦ ß messagσ anΣ sincσ thσ requireΣ strinτ i≤ no⌠ onσ ì
  137. oµ thσ string≤ containeΣ iε thσ ZCPR│ Z3TCAP¼ yo⌡ mus⌠ d∩ ß littlσ homeworδ ì
  138. witΦ you≥ termina∞ manua∞ t∩ finΣ thσ correc⌠ sequences«  Seσ thσ sectioε ì
  139. oε Configuratioε fo≥ information.
  140.  
  141. Overview - 2/3
  142.  
  143. IOPCL╦ update≤ it≤ clocδ displa∙ wheε i⌠ detect≤ ß reques⌠ t∩ thσ BIO╙ fo≥ ì
  144. consolσ inpu⌠ anΣ therσ i≤ n∩ characte≥ alread∙ waiting«  Iµ i⌠ find≤ tha⌠ ì
  145. ß characte≥ i≤ waiting¼ thσ reques⌠ i≤ immediatel∙ passeΣ oε t∩ thσ BIO╙ ì
  146. fo≥ actioε withou⌠ takinτ thσ timσ t∩ updatσ thσ IOPCL╦ display«  Thi≤ ì
  147. allow≤ IOPCL╦ t∩ ruε iε thσ backgrounΣ anΣ takσ seconΣ placσ t∩ ì
  148. application≤ utilitie≤ beinτ ruε iε thσ foreground« 
  149.  
  150. IOPCL╦ work≤ bes⌠ witΦ foregrounΣ application≤ utilitie≤ tha⌠ ge⌠ ì
  151. character≤ froφ thσ BIO╙ usinτ BIO╙ consolσ inpu⌠ requests«  Somσ utilites¼ ì
  152. however¼ continuall∙ cal∞ thσ BIO╙ consolσ statu≤ unti∞ ß characte≥ i≤ ì
  153. detecteΣ rathe≥ thaε gettinτ thσ characte≥ directl∙ froφ thσ BIO╙ consolσ ì
  154. inpu⌠ routine«  The∙ onl∙ reques⌠ ß characte≥ froφ thσ BIO╙ afte≥ the∙ ì
  155. alread∙ kno≈ tha⌠ ß characte≥ i≤ waiting«  Thσ BIO╙ consolσ inpu⌠ routine¼ ì
  156. then¼ see≤ tha⌠ ß characte≥ i≤ waitinτ anΣ doesn'⌠ sto≡ t∩ updatσ thσ ì
  157. IOPCL╦ display«  Othe≥ utilitie≤ don'⌠ checδ fo≥ consolσ inpu⌠ a⌠ al∞ fo≥ ì
  158. lonτ period≤ oµ time«  Thσ IOPCL╦ displa∙ wil∞ no⌠ bσ updateΣ wheε just ì
  159. consolσ statu≤ i≤ beinτ checkeΣ anΣ n∩ consolσ inpu⌠ i≤ beinτ requested«  ì
  160. Thσ displa∙ wil∞ bσ updateΣ again¼ however¼ a⌠ thσ nex⌠ consolσ inpu⌠ ì
  161. reques⌠ wheε n∩ characte≥ i≤ alread∙ waiting.
  162.  
  163. Overview - 3/3
  164.  
  165. IOPCL╦ ma∙ bσ removeΣ usinτ thσ 'Rº commanΣ o≥ b∙ loadinτ anothe≥ IO╨ sucΦ ì
  166. a≤ HPIO╨ o≥ onσ oµ Alphß System≤ IOP'≤ sucΦ a≤ BPRINTer¼ RECORDe≥ o≥ NuKey«  
  167.  
  168. Iµ yo⌡ rese⌠ you≥ DO╙ clocδ whilσ IOPCL╦ i≤ running¼ thσ IOPCL╦ displa∙ ma∙ ì
  169. no⌠ immediatel∙ reflec⌠ thσ changeΣ time«  T∩ updatσ thσ display¼ jus⌠ ruε ì
  170. IOPCL╦ again«  
  171.  
  172. Yo⌡ shoulΣ als∩ notσ tha⌠ iµ you≥ termina∞ ha≤ ß screen-save≥ featurσ tha⌠ ì
  173. i≤ triggereΣ b∙ termina∞ inactivity¼ i⌠ wil∞ neve≥ bσ triggereΣ unde≥ ì
  174. IOPCL╦ becausσ thσ timσ displa∙ i≤ constantl∙ beinτ updated«  Iµ yo⌡ arσ ì
  175. concerneΣ abou⌠ you≥ screen¼ jus⌠ removσ IOPCL╦ beforσ lettinτ thσ termina∞ ì
  176. si⌠ inactivσ fo≥ lonτ periods.
  177. :S
  178.  
  179. Syntaxì
  180.  
  181. The command line synta° is:
  182.  
  183.      IOPCLK    - If no option is specified, install IOPCLK as configured
  184.      IOPCLK R  - Remove IOPCLK 
  185.      IOPCL╦ ─  - Toggle thσ defaul⌠ time displa∙ (seconds<->minutes)
  186. :/
  187.  
  188. Options
  189.  
  190. R - Remove IOPCLK.
  191.           IOPCL╦ isn'⌠ actuall∙ removed¼ it'≤ jus⌠ reconfigureΣ s∩ tha⌠ i⌠ ì
  192. áááááááááápas≤es on all BIOS calls without intercepting them.
  193.  
  194. D - Toggle the default time display configuration.
  195.           Thσ timσ displa∙ wil∞ bσ toggleΣ betweeε 'hh:mm:ssº anΣ 'hh:mm'¼ ì
  196. ááááááááááwith the update time changing accordingly«  
  197.