home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / ZCPR33 / S-Z / VTCAP11.LBR / VTCAP11.WZ / VTCAP11.WS
Text File  |  2000-06-30  |  20KB  |  594 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                               V T C A P  
  10.  
  11.                  Video Oriented TCAP Database Manager
  12.  
  13.                         Version 1.0 - 08/21/87
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  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. Access Programming RAS - 14385 SW Walker Rd. B3 - Beaverton, OR  97006
  55. è
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                   T A B L E   O F   C O N T E N T S
  62.  
  63.  
  64.           Introduction ....................................  3
  65.      
  66.           Program Description .............................  4
  67.      
  68.                A - Add ....................................  5
  69.  
  70.                D - Delete .................................  5
  71.  
  72.                H - Help ...................................  6
  73.  
  74.                L - List ...................................  6
  75.  
  76.                M - Merge ..................................  6
  77.  
  78.                N - Next ...................................  7
  79.  
  80.                P - Previous ...............................  7
  81.  
  82.                S - Search .................................  7
  83.  
  84.                U - Update .................................  8
  85.  
  86.                Z - Z3 Load ................................  8
  87.  
  88.                X - Exit ...................................  8
  89.  
  90.           Appendix A - TCAP File Description ..............  9
  91.  
  92.           Appendix B - Program Listings ................... 12
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109. è                             Introduction
  110.  
  111.  
  112.      VTCA╨ i≤ ß vide∩ orienteΣ databasσ manage≥ designeΣá specificall∙ ì
  113. t∩á manipulatσ thσ Termina∞ CAPabilitie≤ (TCAP⌐á database«á Currently¼ ì
  114. thσ onl∙ wa∙ t∩ modif∙ o≥ adΣ terminal≤ t∩ aε existinτ TCA╨ i≤ t∩ edi⌠ ì
  115. thσ sourcσ codσ anΣ reassemblσ thσ code«á Thi≤ i≤ aε unfai≥ limitatioε ì
  116. t∩á thosσ whosσ abilitie≤ witΦ assemble≥ arσ limiteΣ o≥á non-existant« ì
  117. Eveε thosσ oµ u≤ witΦ assemble≥ ability¼á mus⌠ resor⌠ t∩ 'patchingº o≥ ì
  118. re-assembling to just experiment with different terminal codes.
  119.  
  120.      A≤á ß syso≡ runninτ ZCPR3/ZRDO╙ witΦ BYE51░ anΣ PBBS¼á ╔ wa≤ ver∙ ì
  121. interesteΣ iε thσ growinτ suppor⌠ oµ TCAP« B∙ givinτ thσ ordinar∙ use≥ ì
  122. ßá methoΣ witΦ whicΦ t∩ experimen⌠ witΦ TCA╨ listing≤ anΣ adΣá suppor⌠ ì
  123. fo≥á terminal≤ oµ hi≤ choice¼á ╔ hopσ t∩ pu⌠ TCA╨ suppor⌠ oε morσá anΣ ì
  124. morσá systems«á Thσ bes⌠ wa∙ t∩ accomplisΦ thi≤ i≤ t∩ suppl∙ thσá use≥ ì
  125. witΦá softwarσ tha⌠ wil∞ makσ supportinτ sucΦ idea≤ easier«á VTCA╨á i≤ ì
  126. jus⌠ onσ oµ ß fe≈ softwarσ package≤ availablσ fo≥ thi≤ purpose«á Othe≥ ì
  127. such programs now available, or currently under development are,
  128.  
  129.  
  130.  
  131. PTCAP - TCAP installation package for PBBS systems     AVAILABLE NOW
  132.  
  133. VTCAP - TCAP database manager                          AVAILABLE NOW
  134.  
  135. PCAP  - Printer capabilities package               UNDER DEVELOPMENT
  136.  
  137. PLIB  - Printer support library                    UNDER DEVELOPMENT
  138.  
  139. GCAP  - Graphics capabilities package              UNDER DEVELOPMENT
  140.  
  141. GLIB  - Graphics support library                   UNDER DEVELOPMENT
  142.  
  143.  
  144. Future of VTCAP
  145.  
  146.      Support for both printer and graphics packages when released.
  147.  
  148.      Prin⌠á functioεá fo≥ hardcop∙ printou⌠ oµ individua∞ termina∞á iε ì
  149. ááááádatabasσ o≥ ß lis⌠ oµ al∞ terminals.
  150.  
  151.      Additioε oµ ß tes⌠ modulσ tha⌠ display≤ thσ effect≤ oµ thσ choseε ì
  152. ááááádisplay attributes
  153.  
  154.      Installatioεá functioεá tha⌠ wil∞ actuall∙ instal∞ you≥á selecteΣ ì
  155. áááááTCAP in your system environment.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163. è                 V T C A P - T C A P   M A N A G E R
  164.  
  165.                          Program Description
  166.  
  167.  
  168.  
  169.      Thσá basiπ functioε oµ thi≤ prograφ i≤ t∩ providσ thσ man∙á user≤ ì
  170. oµá thσ Z│ system≤ anΣ Termina∞ CAPabilit∙ file≤ (TCAP's⌐ ß methoΣá t∩ ì
  171. easil∙á modif∙ thσ TCA╨ file≤ oε thei≥ systems«á TCA╨ Manage≥á (VTCAP⌐ ì
  172. gives you the following: 
  173.  
  174.      1.   AdΣ  ß termina∞ t∩ thσ database
  175.      2.   Deletσ ß terminalì
  176.      3.   SearcΦ fo≥ ß requesteΣ terminal
  177.      4.   Scaε forwarΣ o≥ backwarΣ througΦ thσ listings
  178.      5.   Updatσá thσ currentl∙ displayeΣ terminal
  179.      6.   Lis⌠ al∞ oµá thσ terminal≤ iε thσ database
  180.      7.   Mergσ tw∩ TCA╨ file≤ 
  181.      8.   Switch between Z3TCAP files
  182.      9.   Provide≤ yo⌡ witΦ completσá on-linσ hel≡ fo≥ al∞ functions
  183.  
  184.      Thσ distributioε librar∙ filσ contain≤ al∞ oµ thσ file≤ necessar∙ ì
  185. t∩á completel∙á assemblσá anΣ linδ VTCAP«á Thi≤ i≤á ßá vide∩á orienteΣ ì
  186. routinσ anΣ require≤ certaiε informatioε about your system.
  187.  
  188.      Thi≤á prograφá i≤á offereΣá int∩ thσ publiπá domaiεá anΣá ma∙á bσ 
  189. redistributeΣ withou⌠ permission« VTCA╨ i≤ thσ solσ propert∙ oµ Acces≤ ì
  190. Programminτá RA╙á anΣá canno⌠á bσ solΣá seperatel∙á o≥á packageΣá witΦ ì
  191. product≤ a≤ aε incentivσ t∩ purchasσ withou⌠ prio≥ writteεá permissioε ì
  192. froφá thσ author«á An∙ suggestion≤ o≥ modification≤ shoulΣ bσ directeΣ ì
  193. t∩á mσá personall∙á a⌠á thσ systeφ below«á Wσá wil∞á NO╘á suppor⌠á an∙ ì
  194. modification≤á tha⌠á havσá no⌠ beeε previousl∙á cleareΣá througΦá thi≤ ì
  195. system.
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207. Access Programming RAS
  208. 14385 SW Walker Rd. B3
  209. Beaverton, OR  97006
  210.  
  211. Terry Pinto - Owner/SYSOP
  212.  
  213. (503) 646-4937  VOICE
  214. (503) 644-0900  (300/1200 baud - 24 hours/day)
  215.  
  216.  
  217. è
  218.      ADD
  219.  
  220.      Thσá adΣ functioε wil∞ allo≈ thσ use≥ t∩ adΣ additiona∞á termina∞ ì
  221. listing≤ t∩ thσ database«á Wheε yo⌡ ente≥ thσ AD─ mode¼á thσ datß wil∞ ì
  222. bσ cleareΣ froφ thσ displa∙ givinτ yo⌡ ß 'blankº recorΣ t∩ worδá with« ì
  223. A⌠á thi≤ timσ yo⌡ ma∙ ente≥ thσ information«á 
  224.  
  225.      Therσ arσ threσ type≤ oµ field≤ iε whicΦ yo⌡ ma∙ ente≥ data«á Thσ ì
  226. firs⌠á oµ whicΦ i≤ thσ fixeΣ lengtΦ string«á Thσ onl∙ fielΣ tha⌠á use≤ ì
  227. thi≤á entr∙ methoΣ i≤ thσ termina∞ name«á Yo⌡ arσ limiteΣ t∩ entr∙á oµ ì
  228. sixteeε characters«á Iµ yo⌡ makσ ß mistake¼á yo⌡ ma∙ usσ thσ backspacσ ì
  229. t∩ repositioε thσ curso≥ iε thσ field«á Wheε entr∙ i≤ complete¼á pres≤ ì
  230. <ENTER╛á t∩á terminatσ thσ field«á Thi≤ wil∞ automaticall∙á erasσá an∙ ì
  231. character≤á t∩á thσá righ⌠á oµ thσá curso≥á effectivel∙á clearinτá thσ ì
  232. remainder of the field.
  233.  
  234.      Thσá seconΣá typσ oµ entr∙ i≤ thσ singlσ character«á Al∞á oµá thσ ì
  235. arro≈ key≤ anΣ screeε delay≤ arσ representeΣ b∙ thi≤ type«á Thi≤ fielΣ ì
  236. i≤ automaticall∙ terminateΣ wheε yo⌡ ente≥ ß characte≥ anΣ thσá curso≥ ì
  237. wil∞á bσ advanceΣ t∩ thσ nex⌠ field«á Iµ yo⌡ makσ ß mistake¼á jus⌠ usσ ì
  238. the arrow key to reposition the cursor. 
  239.  
  240.      Thσ thirΣ typσ i≤ thσ variablσ lengtΦ string«á Al∞ oµ thσá screeε ì
  241. contro∞á string≤ arσ formatteΣ witΦ thi≤ typσ oµ input«á Durinτ input¼ ì
  242. yo⌡á ma∙ usσ thσ backspacσ t∩ correc⌠ mistakes«á Pressinτ thσá <ENTER╛ ì
  243. ke∙ wil∞ terminatσ inpu⌠ oµ thσ fielΣ anΣ advancσ t∩ thσ next« T∩ ski≡ ì
  244. ßá field¼á jus⌠ ente≥ ß carriagσ return«á REMEMBER¼á  TH┼ ENTR┘á O╞á ┴ ì
  245. CARRIAGE RETURN WILL ERASE THE REMAINDER OF THE FIELD.
  246.  
  247.      Wheε yo⌡ exi⌠ froφ thσ AD─ mode¼á yo⌡ wil∞ bσ prompteΣ t∩ ente≥ ß ì
  248. ne≈ versioε number«á Usσ an∙ tw∩ digi⌠ numbe≥ iε thσ followinτ format« ì
  249.    
  250.      Version Number:  2.7     [major.minor]
  251.      
  252.      Anytimσ yo⌡ makσ an∙ change≤ t∩ thσ database¼á increasσ thσ mino≥ ì
  253. revisioε numbe≥ b∙ one.
  254.  
  255.  
  256.      DELETE
  257.  
  258.      Thσá deletσ functioε i≤ ß togglσ anΣ wil∞ allo≈ yo⌡ t∩á 'markºá ß ì
  259. recorΣá fo≥á deletion«á Wheε s∩ marked¼á thσ datß iε thσá recorΣá wil∞ ì
  260. appea≥á iε thσ standou⌠ modσ anΣ thσ worΣ 'DELETEDº wil∞ appea≥ a⌠ thσ ì
  261. to≡ oµ thσ screen«á Oncσ ß recorΣ ha≤ beeε markeΣ fo≥ deletion¼ i⌠ ma∙ ì
  262. bσá reclaimeΣ b∙ usinτ thσ samσ function«á Thσ firs⌠ timσ thσá [D▌á i≤ ì
  263. pressed¼á thσá recorΣ wil∞ bσ markeΣ fo≥ deletion¼á thσ nex⌠ time¼á i⌠ ì
  264. wil∞ bσ reinstated«á Thσ markeΣ record≤ arσ no⌠ deleteΣ unti∞ yo⌡ exi⌠ ì
  265. thσ database«á A⌠ tha⌠ timσ yo⌡ wil∞ bσ prompteΣ fo≥ ß versioε number« ì
  266. Use the same proceedure as outlined above.
  267.  
  268.  
  269.  
  270.  
  271. è     HELP
  272.  
  273.      Thσ hel≡ functioε wil∞ providσ yo⌡ witΦ on-linσ hel≡ oµ al∞ mode≤ ì
  274. oµ operatioε iε thσ program« B∙ pressinτ [H]¼ yo⌡ caε ge⌠ thσ firs⌠ oµ ì
  275. thσá HEL╨á screens«á Thi≤á screeε wil∞ presen⌠ yo⌡ witΦá hel≡á oεá thσ ì
  276. commanΣá linσá synta°á oµá thσ program«á Yo⌡ ma∙ invokσá mos⌠á oµá thσ ì
  277. operation≤ oµ thσ prograφ froφ thσ ZCPR│ commanΣ linσ b∙ specifinτ thσ ì
  278. appropriatσá option«á Al∞ oµ thσ informatioε yo⌡ wil∞ neeΣ oεá ho≈á t∩ ì
  279. accomplisΦá thi≤á i≤ displayeΣ oε thi≤ screen«á A⌠ thσ bottoφá oµá thσ ì
  280. display¼ yo⌡ wil∞ seσ ß promp⌠ t∩ selec⌠ thσ topiπ yo⌡ wisΦ hel≡ with« ì
  281. Al∞á oµá thσ topic≤ arσ representeΣ b∙ ß /o«á T∩ reques⌠ hel≡á witΦá ß ì
  282. particula≥ topic¼á jus⌠ pres≤ thσ characte≥ afte≥ thσ /« Fo≥ instance¼ ì
  283. the help function is shown as follows:
  284.  
  285.      /H - Help
  286.  
  287.      T∩á selec⌠á hel≡ witΦ thσ hel≡ functions¼á jus⌠ pres≤ H«á Iµá yo⌡ ì
  288. pres≤ ß ke∙ tha⌠ i≤ no⌠ supported¼á aε erro≥ messagσ wil∞ bσ displayeΣ ì
  289. oε thσ screen« Wheε yo⌡ selec⌠ ß topic¼ thσ informatioε requesteΣ wil∞ ì
  290. bσá displayeΣá oεá thσá las⌠ fivσ line≤ oµá thσá displa∙á leavinτá thσ ì
  291. origina∞ hel≡ screen«á Thesσ bottoφ fivσ line≤ wil∞ ac⌠ likσ ßá windo≈ ì
  292. displayinτá thσ requireΣ informatioε wheε needed«á T∩ exi⌠ bacδ t∩ thσ ì
  293. database, just press [X].
  294.  
  295.  
  296.      LIST
  297.  
  298.      Thσ lis⌠ functioε wil∞ displa∙ al∞ oµ thσ terminal≤ currentl∙á iε ì
  299. thσ database« The∙ wil∞ bσ displayeΣ iε thσ orde≥ iε whicΦ the∙ appea≥ ì
  300. iεá thσ file«á EacΦ screeε wil∞ displa∙ u≡ t∩ eight∙ terminal≤ iε fou≥ ì
  301. column≤á oµá twenty«á An∙ deleteΣ terminal≤ wil∞ bσ displayeΣá iεá thσ ì
  302. standou⌠ mode«á Iµ therσ arσ eight∙ terminal≤ o≥ les≤ yo⌡ wil∞ seσ thσ ì
  303. entirσá databasσ oε onσ screeε witΦ thσ [Strikσ an∙ key▌ promp⌠ a⌠ thσ ì
  304. bottom«á Iµá therσ arσ morσ thaε eight∙ terminals¼á thσá displa∙á wil∞ ì
  305. pausσ a⌠ eight∙ anΣ displa∙ thσ [more▌ prompt«á Herσ yo⌡ ma∙ pres≤ an∙ ì
  306. ke∙ t∩ seσ u≡ t∩ eight∙ morσ listings.
  307.  
  308.  
  309.      MERGE
  310.  
  311.      Thi≤ i≤ ß ver∙ powerfu∞ function«á I⌠ wil∞ allo≈ yo⌡ t∩ creatσá ß ì
  312. TCA╨ filσ containinτ al∞ oµ thσ uniquσ listing≤ iε tw∩ files«á Thσ tw∩ ì
  313. file≤ beinτ thσ defaul⌠ TCA╨ filσ (Z3TCAP.TCP⌐ anΣ thσ filσá specifieΣ ì
  314. oεá thσ commanΣ linσ o≥ loadeΣ witΦ thσ 'Zº optioε withiεá VTCAP«á Thσ ì
  315. tw∩á file≤ arσ compareΣ anΣ al∞ oµ thσ uniquσ listing≤ arσ writteεá t∩ ì
  316. aε outpu⌠ file¼á Z3TCAPxx.TCP¼ wherσ x° i≤ thσ versioε numbe≥ thσ use≥ ì
  317. supplie≤ a⌠ thσ beginninτ oµ thσ mergσ process« Yo⌡ wil∞ wan⌠ t∩ checδ ì
  318. ove≥á thσ listing≤ ver∙ carefull∙ a≤ onl∙ thσ inde° namσ i≤á compared« ì
  319. Iµá someonσ change≤ thσ inde° namσ iε onσ file¼á yo⌡ wil∞ enΣ u≡á witΦ ì
  320. tw∩ seperatσ listing≤ fo≥ thσ samσ terminal« ┴ gooΣ examplσ oµ thi≤ i≤ ì
  321. obtaineΣá b∙á merginτ Z3TCAP2│ witΦ Z3TCAP20«á Thσ mergσ oµ thesσá tw∩ ì
  322. file≤á contaiε tw∩ listing≤ eacΦ fo≥ thσ HEAT╚ terminals¼á botΦá HeatΦ ì
  323.  
  324.  
  325. èanΣá ANS╔á modes«á Thσ listinτ fo≥ thσ Genera∞ Termina∞á 10░á i≤á als∩ ì
  326. duplicated«á Carefu∞á checkinτ oµ thσ outpu⌠ filσ i≤ ß smal∞ pricσá t∩ ì
  327. pa∙á fo≥ thσ powe≥ oµ thσ mergσ function«á Yo⌡ ma∙ alway≤ g∩ iεá late≥ ì
  328. with the delete mode and take care of any duplication.
  329.  
  330.      Thσá mergσ proces≤ iε ver∙ comple° iε naturσ anΣ ha≤ beeε greatl∙ ì
  331. simplifieΣ iε thσ descriptioε above«á Seσ thσ descriptioε oµ thσá TCA╨ ì
  332. filσá anΣá thσá technica∞ descriptioε oµ thσ prograφá module≤á iεá thσ ì
  333. appropriatσá appendicie≤á fo≥á ßá morσá completσá descriptioεá oµá thσ ì
  334. operation of this and other functions.
  335.  
  336.  
  337.      NEXT
  338.  
  339.      Thi≤á functioε wil∞ repositioε thσ databasσ t∩ thσ nex⌠ recorΣ iε ì
  340. thσá database«á N∩ inde° filσ i≤ useΣ thereforσ thσ steppinτá i≤á donσ ì
  341. sequentially«á Thσ record≤ arσ alphabetizeΣ anΣ thereforσ shoulΣ bσ iε ì
  342. 'indexed' order.
  343.  
  344.  
  345.      PREVIOUS
  346.  
  347.      Thi≤á i≤ thσ oppositσ oµ thσ abovσ functioε anΣ wil∞ positioε thσ 
  348. databasσ t∩ thσ recorΣ beforσ thσ onσ currentl∙ displayed«á Again¼ thσ ì
  349. stepping is done sequentially through an alphabetized listing.
  350.  
  351.  
  352.      SEARCH
  353.      
  354.      Thσá searcΦá functioεá i≤á useΣ t∩ locatσ an∙á desireΣá entr∙á iε ì
  355. database«á Wheε enterinτ thσ searcΦ mode¼ yo⌡ wil∞ bσ prompteΣ fo≥ thσ ì
  356. namσ oµ thσ termina∞ t∩ searcΦ for« Thσ prograφ wil∞ determinσ betweeε ì
  357. uppe≥ anΣ lowe≥ casσ, s∩ bσ exac⌠ wheε specifinτ thσ searcΦ criteria.
  358.  
  359.                 APPLE /// is not the same as Apple ///
  360.  
  361.      Iµá yo⌡ reques⌠ ß namσ tha⌠ i≤ no⌠ iε thσ database¼á yo⌡ wil∞á bσ ì
  362. giveεá aεá erro≥ messagσ and¼á afte≥ ß shor⌠ delay¼á returneΣá t∩á thσ ì
  363. 'Ente≥ Filename║ º prompt« Iµ thσ searcΦ i≤ sucessful¼ thσ searcΦ modσ ì
  364. wil∞á bσá terminateΣ anΣ yo⌡ wil∞ bσ returneΣ t∩ thσ commanΣá modσá oµ ì
  365. VTCAP«á Thσá namσ entereΣ mus⌠ bσ identica∞ t∩ thσ namσ iεá thσá inde° ì
  366. sectioεá oµá thσ databasσ (seσ thσ sectioε oε thσ descriptioεá oµá thσ ì
  367. TCA╨ files)« Iµ yo⌡ arσ unsurσ oµ thσ spellinτ o≥ thσ wa∙ thσ termina∞ ì
  368. i≤á described¼á usσ thσ lis⌠ functioε t∩ displa∙ thσ terminal≤ iεá thσ ì
  369. database«á Oncσ yo⌡ havσ locateΣ ß terminal¼á yo⌡ ma∙ scaε througΦ thσ ì
  370. databasσ b∙ usinτ thσ [P]reviou≤ anΣ [N]ex⌠ commands.
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379. è
  380.      UPDATE
  381.  
  382.      Thσá updatσá functioεá i≤ ver∙ simila≥ iε operatioεá t∩á thσá adΣ ì
  383. function«á Oncσ yo⌡ havσ selecteΣ thσ termina∞ yo⌡ wan⌠ t∩ update¼ yo⌡ ì
  384. selec⌠á [U▌á anΣá thσ curso≥ i≤ placeΣ oε thσ firs⌠ characte≥á oµá thσ ì
  385. firs⌠ fielΣ iε thσ record«á Thσ <ENTER╛ ke∙ wil∞ terminatσ fielΣ inpu⌠ ì
  386. anΣ advancσ thσ curso≥ t∩ thσ nex⌠ field« Al∞ informatioε t∩ thσ righ⌠ ì
  387. oµ thσ cursor¼á iε thσ curren⌠ field¼á wil∞ bσ los⌠ wheε yo⌡ terminatσ ì
  388. thσ field«á T∩ writσ thσ datß t∩ thσ databasσ usσ '^W'« Iµ yo⌡ wisΦ t∩ ì
  389. abor⌠ thσ curren⌠ update¼á pres≤ '^Q'« Thσ updatσ modσ wil∞ no⌠ promp⌠ ì
  390. fo≥ thσ entr∙ oµ ß versioε number«á I⌠ i≤ assumeΣ tha⌠ thi≤ modσá wil∞ ì
  391. bσá useΣ morσ fo≥ experimentatioε anΣ correctinτ oµ typinτ error≤á anΣ ì
  392. thereforσá wil∞ no⌠ requirσ thσ generatioε oµ ß highe≥ versioε number« ì
  393. Iµ yo⌡ fee∞ thσ neeΣ t∩ issuσ ß versioε numbe≥ fo≥ aε updateΣ listing¼ ì
  394. you may rename the file externally.
  395.  
  396.  
  397.      Z3 LOAD
  398.  
  399.      Thσá Z│á LoaΣá functioε i≤ useΣ t∩ exi⌠á onσá databasσá anΣá loaΣ ì
  400. another« Yo⌡ wil∞ bσ prompteΣ fo≥ thσ namσ oµ thσ databasσ yo⌡ wisΦ t∩ ì
  401. read«á D╧á NO╘ TYP┼ TH┼ FIL┼ EXTENT«á Al∞ file≤ shoulΣ bσ oµ thσá forφ ì
  402. Z3TCAPxx¼á wherσ x° i≤ thσ versioε numbe≥ oµ thσ filσ t∩ bσ loaded« Iµ ì
  403. yo⌡ reques⌠ ß filσ tha⌠ doe≤ no⌠ exist¼á yo⌡ seσ aε erro≥ message¼ anΣ ì
  404. yo⌡ wil∞ bσ returneΣ t∩ thσ 'Ente≥ Filename║á º promp⌠ allowinτ yo⌡ t∩ ì
  405. tr∙ agian«á Iµ you≥ reques⌠ i≤ sucessful¼á yo⌡ wil∞ bσ returneΣ t∩ thσ ì
  406. VTCA╨á commanΣ level«á T∩ cance∞ thσ filenamσ entry¼á ente≥ ß carriagσ ì
  407. return and the default Z3TCAP file will be loaded.
  408.  
  409.      Exit
  410.  
  411.      Thi≤ commanΣ i≤ selµ explanitory«á Al∞ opeε file≤ wil∞ bσ closed¼ ì
  412. al∞á disδá housekeepinτ wil∞ bσ completeΣ anΣ yo⌡ wil∞ bσ returneΣá t∩ ì
  413. the operating system level, exiting the program.
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433. è 
  434.  
  435.                               Appendix A   
  436.  
  437.                         TCAP File Description
  438.  
  439.  
  440.      T∩ understanΣ thσ operatioε oµ VTCAP¼á yo⌡ mus⌠ firs⌠á understanΣ ì
  441. the TCAP file and how it is constructed.
  442.  
  443.      Thσá TCA╨á filσá consist≤á oµ tw∩ sections¼á thσá inde°á anΣá thσ ì
  444. database« 
  445.  
  446.      Thσá inde° sectioε contain≤ thσ name≤ oµ al∞ oµ thσ terminal≤á iε ì
  447. thσ database«á Al∞ sortinτ anΣ searchinτ i≤ donσ relativσ t∩ thσ name≤ ì
  448. iεá thσ inde° section«á EacΦ termina∞ namσ i≤ sixteeε byte≤ iεá lengtΦ ì
  449. anΣá eigh⌠ name≤ wil∞ occup∙ onσ physica∞ recorΣ iε thσ file«á Iµá thσ ì
  450. termina∞ name≤ d∩ no⌠ completel∙ fil∞ thσ record¼ thσ remainde≥ oµ thσ ì
  451. recorΣ wil∞ bσ filleΣ witΦ 0's«á Thσ termina∞ name≤ arσ entereΣ iε thσ ì
  452. databasσá iε alphabetica∞ orde≥ thu≤ negatinτ thσ neeΣá fo≥á elaboratσ ì
  453. inde°á files«á EacΦá termina∞á namσ i≤ paddeΣ witΦ blank≤á t∩á sixteeε ì
  454. characters«á Thσá followinτá wil∞ illustratσ thσ constructioεá oµá thσ ì
  455. inde° sectioε oµ TCA╨ files.
  456.  
  457. +---------------------------------------------+    +--------------+
  458. 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F    0123456789ABCDEF
  459.  
  460. 57 59 53 45 20 31 30 30 20 20 20 20 20 20 20 20    WYSE 100        
  461. 58 65 72 6F 78 20 38 32 30 2D 49 20 20 20 20 20    Xerox 820-I  
  462. 58 65 72 6F 78 20 38 32 30 2D 49 49 20 20 20 20    Xerox 820-II   
  463. 58 65 72 6F 78 20 38 2D 31 36 20 20 20 20 20 20    Xerox 8-16    
  464. 20 32 22 36 20 20 20 20 20 20 20 20 20 20 20 20     2.6           
  465. 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
  466. 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
  467. 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
  468. +---------------------------------------------+    +--------------+
  469.  
  470. Noticσá tha⌠á eacΦ entr∙ take≤ thσ entirσ sixteeε byte≤á anΣá tha⌠á n∩ 
  471. terminato≥á i≤ useΣ t∩ indicatσ thσ enΣ oµ thσ string«á Thσ las⌠ entr∙ ì
  472. iεá thσá filσá i≤á thσ inde° entr∙á fo≥á thσá versioεá number«á I⌠á i≤ ì
  473. recognizeΣ b∙ thσ fac⌠ tha⌠ thσ firs⌠ characte≥ iε thσ fielΣ i≤ blank« ì
  474. Thi≤á i≤ thσ onl∙ recorΣ tha⌠ begin≤ witΦ ß blanδ character«á Thσ nex⌠ ì
  475. threσá byte≤á denotσ thσ versioε number«á Thσ res⌠ oµá tha⌠á fielΣá i≤ ì
  476. paddeΣá witΦá blanks«á Thσ remainde≥ oµ thσ physica∞ recorΣ i≤á filleΣ ì
  477. witΦá binar∙á 0's«á Thσá firs⌠á oµ thesσ zero'≤ servσá a≤á thσá strinτ ì
  478. terminato≥ fo≥ thσ inde° file«á Thu≤ thσ entirσ inde° filσ i≤á treateΣ ì
  479. a≤ onσ lonτ strinτ terminateΣ b∙ ß binar∙ 0.
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487. è
  488.  
  489.      Thσ nex⌠ sectioε i≤ thσ database«á EacΦ 12╕ bytσ physica∞á recorΣ ì
  490. represent≤á onσ termina∞ entry«á Thσ followinτ fielΣ structurσ define≤ ì
  491. the database section.
  492.  
  493.      Terminal Name  16 bytes
  494.      Up Arrow        1 byte
  495.      Down Arrow      1 byte
  496.      Left Arrow      1 byte
  497.      Right Arrow     1 byte
  498.      CLS Delay       1 byte
  499.      DCA Delay       1 byte
  500.      EOL Delay       1 byte
  501.      Clear Screen    Variable Length --+
  502.      Dir Cur Pstn    Variable Length   |
  503.      Erase EOL       Variable Length   |
  504.      Begiε Standou⌠  Variablσ LengtΦ   |--╛ Total =< 105 Bytes
  505.      End Standout    Variable Length   |
  506.      Terminal Init   Variable Length   |
  507.      Term De-Init    Variable Length --+
  508.  
  509.      Thσá termina∞ namσ i≤ thσ onl∙ fielΣ tha⌠ i≤ NO╘ terminateΣ b∙á ß ì
  510. binar∙á 0«á Al∞á othe≥ field≤ arσ terminated«á Iµ ß serie≤á oµá zero'≤ ì
  511. exist¼ easΦ wil∞ represen⌠ ß fielΣ entry« Thσ followinτ examplσ oµ thσ ì
  512. Televideo 950 terminal should help to clarify.
  513.  
  514. 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F   0123456789ABCDEF
  515.  
  516. 54 56 49 39 35 30 20 20 20 20 20 20 20 20 20 20   TVI950
  517. 0B 16 0C 08 32 00 00 1B 2A 00 1B 3D 25 2B 20 25   ....2...*..=%+ %
  518. 2B 20 00 1B 74 00 1B 29 00 1B 28 00 00 00 00 00   + ..t..)..(.....
  519. 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................
  520. 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................ 
  521. 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................ 
  522. 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................
  523. 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00   ................
  524.  
  525. The following should help to translate the code.
  526.  
  527. 54 56 49 39 35 30 20 20 20 20 20 20 20 20 20 20   TVI950
  528. T  V  I  9  5  0  
  529.  
  530. 0B 16 0C 08 32 00 00 1B 2A 00 1B 3D 25 2B 20 25   ....2...*..=%+ %
  531. | Arrows  | |Delays| | CLS  | | Direct Cursor
  532. ^K ^V ^L ^H |2ms dl| | ESC* | | ESC=%+ %+ 
  533. +---------+ +------+ +------+ +----------------
  534.  
  535. 2B 20 00 1B 74 00 1B 29 00 1B 28 00 00 00 00 00   + ..t..)..(.....
  536. Addr   | | EOL  | |Beg SO| |End SO| TI TD
  537.        | | ESCt | |ESC)  | |ESC(  | |  +- No De-initialization 
  538. -------+ +------+ +------+ +------+ +---- No Initialization
  539.  
  540.  
  541. è
  542. Thσá las⌠ databasσ entr∙ i≤ thσ versioε number«á Onσ entirσ recorΣá i≤ ì
  543. reserveΣá fo≥á thi≤ entry«á I⌠ appear≤ thσ samσ a≤ thσá inde°á sectioε ì
  544. entry«á Thσ firs⌠ sixteeε byte≤ arσ reserveΣ fo≥ thσ 'name'¼á whicΦ iε ì
  545. thi≤ casσ wil∞ bσ thσ versioε numbe≥ preceedeΣ b∙ onσ blanδ anΣ paddeΣ ì
  546. t∩ fil∞ thσ sixteeε bytσ namσ field«á Thσ res⌠ oµ thσ recorΣ i≤ filleΣ ì
  547. witΦ ß binar∙ 0«á I⌠ i≤ importan⌠ t∩ notσ tha⌠ thσ firs⌠ recorΣ iε thσ ì
  548. datßá sectioεá alway≤ begin≤ oε ß recorΣ boundary«á Thi≤ i≤á importan⌠ ì
  549. becausσá i⌠á i≤á thσ basi≤ oµ thσ calculation≤ useΣá t∩á positioεá thσ ì
  550. record pointer within the database.
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.