home *** CD-ROM | disk | FTP | other *** search
/ PC World 1997 November / PCWorld_1997-11_cd.bin / software / programy / FBL / TCPBATCH / DEMO / SHORTMAN.TXT < prev    next >
Text File  |  1997-07-13  |  10KB  |  200 lines
  1. Tento dokument slou₧φ jako struΦn² popis Φinnosti programu TCPBatch ver. 1.10
  2.  
  3.  
  4.  
  5.                    -----------------------------------------
  6.                    Popis mo₧n²ch argument∙ programu TCPBatch
  7.                    -----------------------------------------
  8.  
  9. B∞₧n∞ program spouÜtφme bez parametr∙, pak je umo₧n∞no interaktivnφ zadßvßnφ
  10. jmΘna souboru-scriptu a jeho spouÜt∞nφ.
  11.  
  12. -p <protokol> ... jmΘno souboru-protokolu. Neuvedeme-li, pou₧ije se soubor se
  13.     jmΘnem TCPBATCH.LOG v aktußlnφm DOS-adresß°i
  14. -p- ... ₧ßdn² protokol
  15.  
  16. -d <symbol> ... definuj symbol pro mo₧nß v∞tvenφ programu (viz nφ₧e p°φkaz
  17.     Define/UnDefine nebo IfDef/IfNotDef), malß a velkß pφsmena v²znamnß
  18.  
  19. -n <ΦφtaΦ> <hodnota> ... definuj ΦφtaΦ a nastav jej na inicißlnφ hodnotu
  20.  
  21. -l <°et∞zec> ... inicißlnφ hodnota pro term line (viz nφ₧e), kter² m∙₧e b²t
  22.     souΦßstφ odesφlanΘho °et∞zce, zprßv apod.
  23.  
  24. -c <server> <port> ... ihned po startu programu zahßjφ spojenφ s t∞mito
  25.     parametry. Obvykle je parametr kombinovßn s autostartov²m scriptem
  26.  
  27. -a <port> ... ihned po startu programu Φekß na spojenφ na tomto portu.
  28.     Obvykle je parametr kombinovßn s autostartov²m scriptem
  29.  
  30. Pokud za klφΦov²mi parametry uvedeme i n∞jakΘ poziΦnφ (nep°edchßzenΘ znakem -),
  31. mß prvnφ z nich v²znam souboru-scriptu, v tom p°φpad∞ se tento script ihned
  32. spouÜtφ, ani₧ by program Φekal na stisk tlaΦφtka Start (jde o autostartov²
  33. script), obvykle je na konci scriptu End, tzn. ukonΦenφ celΘho programu
  34. TCPBatch.
  35.  
  36.  
  37.  
  38.  
  39.              -----------------------------------------------------
  40.              Popis scriptu pro TCPBatch (defaultovß p°φpona *.TCP)
  41.              -----------------------------------------------------
  42.  
  43.  
  44. Script m∙₧e obsahovat nßsledujφcφ p°φkazy:
  45.  
  46. Connect <server> <port>
  47.  - port zadat Φφslem, server jmΘnem DNS nebo IP-adresou. P°ipojφ se k serveru
  48.    na dotyΦn² port. Pokud je jedna z hodnot znak otaznφk, vy₧ßdß si program
  49.    parametry spojenφ interaktivn∞
  50. Accept <port>
  51.  - port zadat Φφslem. PoΦkß (listening) na portu, dokud se k n∞mu n∞kdo
  52.    nep°ihlßsφ, ₧ßdost akceptuje a listening ukonΦφ. Pokud je mφsto portu
  53.    znak otaznφk, vy₧ßdß si program parametry spojenφ interaktivn∞
  54. Disconnect
  55.  - ukonΦφ spojenφ. Nenφ t°eba, pokud jej ukonΦil prot∞jÜek, ale nic se
  56.    nestane p°i duplicit∞ (vypφÜe se jen warning do protokolu)
  57.  
  58.  
  59. Je-li spojenφ navßzßno (tj. za Connect nebo Accept, takΘ jej ovÜem mohl navßzat
  60. p°edchozφ script nebo parametry -c Φi -a programu), m∙₧e nßsledovat:
  61.  
  62. Send <°et∞zec>
  63.  - poÜle °et∞zec v jeho dΘlce (nep°idßvß za n∞j sßm od sebe newline)
  64. Receive <poΦet>
  65.  - naΦte p°esn∞ tolik znak∙
  66. SkipTo <°et∞zec>
  67.  - °et∞zec musφ b²t jednoznakov². NaΦφtß znaky, dokud nenaΦte tento znak. Lze
  68.    pou₧φt i pro naΦtenφ jednΘ °ßdky ve tvaru: SkipTo nl
  69. WaitFor <podmφnka>
  70.  - naΦφtß °ßdky ukonΦenΘ newlinem (ignoruje CR), dokud nenφ spln∞na podmφnka.
  71.    Podmφnky: End ... a₧ do uzav°enφ spojenφ prot∞jÜkem
  72.              EmptyLine ... dokud nenaΦte prßzdnou °ßdku
  73.              LineStarting <°et∞zec> ... dokud nenaΦte °ßdku zaΦφnajφcφ textem
  74.              ExactMatch <°et∞zec> ... dokud nenaΦte p°esn∞ tuto °ßdku
  75.  
  76.  
  77. ╪et∞zec je mezerami odd∞lenΘ z°et∞zenφ libovolnΘho poΦtu term∙, p°iΦem₧ term je:
  78.  - cokoli v uvozovkßch - funguje escapovßnφ pomocφ '\' vΦetn∞ b∞₧n²ch symbol∙
  79.    obdobn²ch z C++ a₧ na dekadickou interpretaci znak∙ (v C++ oktalovß)
  80.  - dekadick² zßpis Φφsla 0-255 (souΦßstφ °et∞zce m∙₧e b²t i 0, tedy null)
  81.  - nl Φi lf = newline, cr = carriage return, tab = tabelator, esc = escape
  82.  - line - poslednφ naΦten² °et∞zec bez koncovΘho znaku °ßdky v p°φpad∞ SkipTo
  83.    a WaitFor, resp. v ΦistΘm poΦtu znak∙ v p°φpad∞ Receive nebo naposledy
  84.    zadan² °et∞zec v p°φkazu Input
  85.  - jmΘno pou₧itΘ d°φve v p°φkazu SetCounter - hodnota ΦφtaΦe v prostΘm 
  86.    dekadickΘm zßpisu
  87. P°φklad °et∞zce: "Ahoj\r\nPolib mi\tÜos\27\010" nl "Ahoj" tab 4 127 nl "\n"
  88.  
  89.  
  90. Program umo₧≥uje p°φjem dat do souboru. Pokud uvedeme p°φkaz:
  91. OutputFile <jmΘno-souboru>
  92. budou vÜechna data Φtenß ze socketu p°φkazy Receive, SkipTo a WaitFor ve svΘ
  93. ΦistΘ dΘlce opisovßna binßrn∞ do tohoto souboru a₧ do konce vÜech script∙ nebo
  94. do p°φkazu CloseOutput (kter² jej uzav°e) nebo dalÜφho OutputFile.
  95. Zapisujφ se pouze Φistß data - pokud bylo v bloku dat p°ijato vφce dat, ale
  96. nap°. WaitFor skonΦil prßzdnou °ßdkou, konΦφ zßpis touto prßzdnou °ßdkou.
  97. P°φkazy OutputFile a CloseOutput nemajφ vliv na zßkladnφ chovßnφ programu.
  98. JmΘno souboru nedßvßme do uvozovek ani nezdvojujeme znaky '\'.
  99.  
  100.  
  101. Program mß i jednoduchΘ °φdφcφ p°φkazy:
  102.  
  103. Label <jmΘno>
  104. - nic nevykonß, jen oznaΦuje mφsto ve scriptu (malß a velkß pφsmena v²znamnß)
  105. GoTo <jmΘno>
  106. - skoΦφ na prvnφ Label <jmΘno> tΘho₧ jmΘna ve scriptu a pokraΦuje za nφm. Pokud
  107.   nenalezne jmΘno v tomtΘ₧ scriptu a ten je spouÜt∞n z jinΘho, ukonΦφ provßd∞nφ
  108.   tohoto scriptu a zkouÜφ to v nad°φzenΘm. Pokud jmΘno nenφ nalezeno v ₧ßdnΘm
  109.   z nad°φzen²ch (volajφcφch) script∙, vyvolß chybu
  110. Wait <poΦet-milisekund>
  111. - poΦkß tolik milisekund (hodnota nenφ shora omezenß; Φekßnφ nenφ p°φmo 
  112.   v milisekundßch, ale je p°evedeno na jednotky, kter²mi prßv∞ Φasujφ Windows)
  113. Comment <text>
  114. - nic nevykonß. V²znam komentß°∙ majφ i prßzdnΘ °ßdky a °ßdky zaΦφnajφcφ '/' a
  115.   dßle °ßdky p°eskoΦenΘ p°φkazem GoTo (jejich₧ obsah se tudφ₧ nekontroluje)
  116. SetCounter <jmΘno> <Φφslo>
  117. - nastavφ ΦφtaΦ <jmΘno> na Φφselnou hodnotu, zalo₧φ jej, pokud dosud nebyl
  118.   vytvo°en. ╚φtaΦe lze pou₧φvat jako souΦßst °et∞zc∙, zv∞tÜovat o konstantu a
  119.   testovat, ve jmΘn∞ jsou malß a velkß pφsmena v²znamnß
  120. IncrementCounter <jmΘno> [<Φφslo>]
  121. - zv∞tÜφ ΦφtaΦ <jmΘno> o Φφselnou hodnotu (m∙₧e b²t i zßpornß), p°i neuvedenφ
  122.   Φφsla o 1. ╚φtaΦ musel ji₧ existovat (jinak vyvolß chybu)
  123. TestCounter <jmΘno> <operßtor> <Φφslo>
  124. - pokud je ΦφtaΦ v relaci s Φφslem, definuje globßlnφ symbol TRUE, jinak jej
  125.   undefinuje. Operßtor m∙₧e b²t jeden z <, >, <=, >=, =, <>. ╚φtaΦ musel ji₧
  126.   existovat (jinak vyvolß chybu)
  127. ShowCheckBox <jmΘno> [<°et∞zec>]
  128. - pokud dosud nenφ vid∞t check-box s tφmto jmΘnem, vytvo°φ se nov² v po°adφ a
  129.   zobrazovan² text (vpravo od ΦtvereΦku) bude °et∞zec (mß syntaxi shodnou
  130.   s p°φkazy Send apod., typicky text v uvozovkßch). P°i vynechßnφ °et∞zce se
  131.   zobrazφ jmΘno check-boxu, velkß a malß pφsmena v²znamnß. Pokud byl ji₧
  132.   check-box s tφmto jmΘnem vid∞t, nezp∙sobφ ₧ßdnou akcφ ani chybu
  133. HideCheckBox <jmΘno>
  134. - pokud je vid∞t check-box s tφmto jmΘnem, skryje jej a uvolnφ prostor pro
  135.   dalÜφ check-boxy (souΦasn∞ jich m∙₧e b²t vid∞t max. 10). Pokud check-box
  136.   vid∞t nenφ, nezp∙sobφ ₧ßdnou akci ani chybu
  137. SetCheck <jmΘno> <zp∙sob>
  138. - pokud je vid∞t check-box s tφmto jmΘnem, oznaΦφ ho podle zp∙sobu (druhΘho
  139.   argumentu), pokud nenφ, ohlßsφ chybu a ukonΦφ interpretaci script∙. Zp∙sob
  140.   m∙₧e b²t Φφslice 0 (zruÜ oznaΦenφ), 1 (oznaΦ) nebo 2 (zm∞≥ stav na opaΦn²)
  141. TestCheck <jmΘno>
  142. - pokud je check-box s tφmto jmΘnem vid∞t a oznaΦen, definuje globßlnφ symbol
  143.   CHECKED, jinak jej undefinuje. Nikdy nezp∙sobφ chybu
  144. WaitCheck <jmΘno> [<hodnota>]
  145. - Φekß, dokud nenφ check-box s tφmto jmΘnem oznaΦen dle hodnoty (0=neoznaΦen,
  146.   1=oznaΦen, p°i vynechßnφ oznaΦen). Pokud check-box nenφ viditeln², ohlßsφ
  147.   chybu a ukonΦφ interpretaci script∙
  148. Return
  149. - ukonΦφ provßd∞nφ scriptu (t²₧ efekt mß konec souboru-scriptu)
  150. Stop
  151. - ukonΦφ provßd∞nφ vÜech rozb∞hnut²ch script∙
  152. End
  153. - ukonΦφ provßd∞nφ scriptu i program TCPBatch, pou₧φvßme obvykle v kombinaci
  154.   s autostartov²m scriptem (uvedenφm scriptu v p°φkazovΘ °ßdce)
  155. Signalize <jmΘno-souboru>
  156. - soubor musφ b²t dle standardu *.WAV, p°φkaz p°ehraje tento zvuk, neΦekß na
  157.   jeho dokonΦenφ a ihned pokraΦuje v interpretaci scriptu. Pokud nenφ soubor
  158.   nalezen nebo operaΦnφ systΘm nemß nainstalovßn ₧ßdn² p°ehrßvaΦ zvuk∙, je
  159.   p°φkaz ignorovßn bez event. hlßÜenφ chyb
  160. ShowWindow <zp∙sob>
  161. - je-li zp∙sob=1, zobrazφ hlavnφ okno programu, je-li 0, schovß jej (tzn.
  162.   minimalizuje jej na taskbar). Tuto akci lze rovn∞₧ vyvolat myÜφ nebo
  163.   systΘmov²m menu
  164. Message <°et∞zec>
  165. - zahlßsφ text jako zprßvu, vyΦkß stisku buttonu Ok/Cancel a pokraΦuje ve
  166.   scriptu (Cancel ukonΦφ provßd∞nφ vÜech script∙ jako p°φkaz Stop).
  167.   ╪et∞zec se °φdφ syntaxφ uvedenou v²Üe, typicky n∞jak² text v uvozovkßch
  168. Input <°et∞zec>
  169. - zahlßsφ text jako zprßvu, vyΦkß zadßnφ °et∞zce a stisku buttonu Ok/Cancel
  170.   a pokraΦuje ve scriptu (Cancel ukonΦφ provßd∞nφ vÜech script∙ jako p°φkaz
  171.   Stop). ╪et∞zec bude ulo₧en do termu line a z∙stßvß platn² a₧ do dalÜφho
  172.   p°φkazu Input, Receive, WaitFor nebo SkipTo, tzn. lze jej pou₧φt jako
  173.   souΦßst jin²ch °et∞zc∙
  174. Question <°et∞zec>
  175. - zahlßsφ text jako zprßvu, vyΦkß stisku buttonu Yes/No/Cancel a pokraΦuje
  176.   ve scriptu. Cancel ukonΦφ provßd∞nφ vÜech script∙ jako p°φkaz Stop, Yes
  177.   definuje a No undefinuje globßlnφ symbol CONSENT
  178. IfDef <symbol> [p°φkaz]
  179. IfNotDef <symbol> [p°φkaz]
  180. - p°φkaz se provede, pokud byl (resp. nebyl ve verzi IfNotDef) symbol definovßn
  181.   pomocφ -d v p°φkazovΘ °ßdce nebo p°φkazy Define/Undefine nebo (v p°φpad∞
  182.   symbolu CONSENT) p°φkazem Question nebo (v p°φpad∞ symbolu TRUE) p°φkazem
  183.   TestCounter. P°φkazem b²vß obvykle GoTo nebo Call, m∙₧e jφm b²t i dalÜφ 
  184.   IfDef/IfNotDef a ovÜem i jak²koli jin² p°φkaz
  185. Define <symbol>
  186. Undefine <symbol>
  187. - definuje symbol resp. zruÜφ definici symbolu stejn∞ jako -d v p°φkazovΘ °ßdce
  188. Call <jmΘno-souboru>
  189. - p°eruÜφ provßd∞nφ scriptu, provede cel² script <jmΘno-souboru> a pokud b∞hem
  190.   n∞j nedojde k chyb∞ nebo p°φkaz∙m Stop a End, pokraΦuje za p°φkazem Call
  191.  
  192.  
  193. VeÜkerß Φtenß i protokolovanß Φφsla jsou v dekadickΘ soustav∞.
  194. Program vytvo°φ soubor pro protokol TCPBATCH.LOG v aktußlnφm DOSovΘm
  195. adresß°i (neuvedeme-li v p°φkazovΘ °ßdce -p) a vypisuje do n∞j vÜechny
  196. udßlosti i s konkrΘtnφmi daty. Tento protokol se sice p°φkazu DIR jevφ 
  197. jako prßzdn², ale pomocφ notepadu nebo p°φkazu TYPE jej lze Φφst v₧dy 
  198. v aktußlnφm stavu.
  199.  
  200.