%lines 61 %lang eng %head 2 PEAB SLAN, Program System Specification MTS_PC Rev 1.2 / 87-02-23 IND AB / AN & LOS %pos_page 61 %margin_text 6 %margin_title 2 %margin_head 2 %pos_title 14 PPPPP EEEEEE AA BBBBB P P E A A B B P P E A A B B PPPPP EEEEE AAAAAA BBBBB P E A A B B P E A A B B P EEEEEE A A BBBBB SSSS L AA N N S L A A NN N S L A A N N N SSSS L AAAAAA N N N S L A A N NN S L A A N N SSSS LLLLLL A A N N Program System Specification MASTER TEST SYSTEM IN PC (MTS_PC) =================================== Inneh}llsf|rteckning %title 1 Allm{nt %title 2 Sammanfattning F|r att underl{tta anv{ndandet av MTS-programmet i testh}rdvaran (STH) ansluts en PC till STH. Med hj{lp av ett speciellt kommunikations-program i PC'n (MTS_PC) f|renklas uttestandet avsev{rt. I korta drag kan programmets m|jligheter beskrivas p} f|ljande s{tt: * Kommunikations-interface Programmet inneh}ller rutiner f|r kommunikation via b}de RS232- och GPIB-interface. F|r RS232-interfacet kan man st{lla om de olika kommunikations-parameterarna (baud, paritet och antal data- och stop-bitar). * Operat|rs-interface Systemet {r menyorienterat. Beroende p} vilken meny man befinner sig i kan olika saker utf|ras med hj{lp av funktionstangenterna. I nederkanten p} varje meny finns en liten ruta f|r varje funktionstangent som talar om vad denna utf|r. Samma saker kan ocks} utf|ras med hj{lp av kommandon som anges p} en speciell kommandorad. Generellt g{ller att kommandon p} kommandoraden kan anges oberoende av i vilken meny man befinner sig. * Interaktivt test F|r att inte beh|va skriva samma kommandon till STH'n om och om igen, skriver man, med hj{lp av en i MTS_PC inbyggd editor, in dessa i en buffert. Ur bufferten kan man sedan s{nda valfritt kommando eller sekvens av kommandon. Bufferten kan h{mtas fr}n och sparas p} fil. Bufferten {r begr{nsad till max 20 rader och 80 kolumner. * Test i form av batch-k|rning M|jlighet finns ocks} att k|ra ett test i form av en batch- k|rning. En kommandosekvens, vilken man tidigare skapat i en editor utanf|r programmet och som kan vara l{ngre {n 20 rader och 80 kolumner, k|rs d} igenom. Man kan stanna och forts{tta k|rningen som man vill. Det g}r {ven att stega sig fram. I batchfilen kan ocks} finnas speciella styrkommandon. Med hj{lp av dessa kan loopar, pauser och utskrifter av texter g|ras under k|rningen. * Loggning Loggning av kommunikationen kan ske b}de p} fil och printer. Dessutom kan loggningen g|ras selektivt. D.v.s. man kan v{lja att bara logga vissa typer meddelanden. T.ex. att endast felmeddelanden fr}n STH skrivs. %page %title 2 System structure %page %title 2 Utbyggnadsm|jligheter I detta system kontrolleras inte meddelandena p} annat s{tt {n att de sorteras upp p} olika typer samt att ett helt meddelande mottages. Det {r allts} ett generellt testsystem som enkelt kan konverteras f|r att testa ut andra system. Man byter d} ut en modul som inneh}ller formatteringar och kontroller mot en som {r speciell f|r just det system man vill testa. F|r vissa system d{r man har v{l definierade meddelanden att v{nta kan man ha fasta testsekvenser som testar hela systemet utan operat|rs- |vervakning. Det skulle allts} r{cka med att efter}t ta en titt p} statistik f|r k|rningen f|r att konstatera om systemet fungerar som det ska. %page %title 2 Terminology Command - There are 3 different types of commands: 1) Batch commands in the batch file, which are not sent to STH. Used to control the batch test. 2) Operator commands entered on the keyboard by the operator. 3) Commands sent to STH. When the type is not specified it is evident. In the command descriptions (batch and operator commands) the command keyword is shown in upper case. Command parameter are shown in lower case. Optional parameters are shown in square brackets. When a parameter is refered to in the description text it is surrounded by less and greater than symbols, like this: . Error messages - There are three different types of error messages, referring to: 1) Errors in given operator command. 2) Error messages from STH. 3) Errors concerning the communication with STH. %page %title 2 References Pascal-2 Version 2.1J for MS-DOS Oregon Software, Inc. 6915 S.W. Macadam Avenue Portland, Oregon 97219 Phone: 503-245-2202 HP-IB Command Library for MS-DOS Release A.01 Hewlett-Packard Co. Corvallis Workstation Operation 1000 N.E. Circle Blvd. Corvallis, OR 97330, U.S.A. ASYNCH MANAGER "Asynchronous support tools for pascal programmers" Pascal Version 1.0 februari 1985 Blase computing INC. 2034 Blake Street Berkley, CA 94704 (415) 540-5441 %page %title 0 %title 1 Operat|rsinterface Systemet {r menyorienterat. Beroende p} vilken meny man befinner sig i kan olika saker utf|ras med hj{lp av funktionstangenterna. I nederkanten p} varje meny finns en liten ruta f|r varje funktionstangent som talar om vad denna utf|r. Samma saker kan ocks} utf|ras med hj{lp av kommandon som anges p} en speciell kommandorad. Generellt g{ller att kommandon p} kommandoraden kan anges oberoende av i vilken meny man befinner sig. Menysystemet ser ut enl. nedan: +-----------+ ! Huvudmeny ! +-----+-----+ ! +---------------------+-----------------------+ ! ! ! +---+---+ +--------+--------+ +-----+-----+ ! Setup ! ! Interaktiv test ! ! Batchtest ! +-------+ +--------+--------+ +-----------+ ! +---+--+ ! Edit ! +------+ %title 2 Entering commands This chapter describes the command and parameter entering procedure. %title 3 Function keys A command can always be entered through a function key. A not terminated command, is overwritten by a function key. The following commands have different syntax when they are given with a function key: GPIB, RS232 and LOGTYP. After giving one of these commands a new function key set is displayed and the parameters are entered through these. %title 3 Command line On the command line all printable characters are allowed. The following characters have a special meaning. Escape - Clears the command line, displays the command prompter and waits for a new command. Backspace - Deletes last entered character. CR - Terminates the command. Non printable characters aren't given any attention. %title 3 Parameters Anges inte tillr{ckligt antal parametrar i samband med kommandot (eller om kommandot ges med hj{lp av funktionstangent) fr}gas efter saknade parametrarna. Om defaultv{rde |nskas, och s}dant finns f|r parametern, trycker man p} returntangenten. F|r att avbryta kommandot i det h{r l{get trycker man p} escape- tangenten. %title 3 Error messages If an error in the command is detected an error message is displayed in inversed video on the 23'rd line. The error message is removed when a key is pressed. The command line and the cursor is left unchanged. (I.e. the command line can be changed.) The error messages are: Unknown command - The command doesn't exist. Command not allowed here- The command can not be performed in this situation. Invalid function key - A functionkey that normally has a meaning, but not in this menu. Too many parameters Too few parameters - If CR is pressed when prompting for a parameter and there is no defaultvalue Invalid parameter %title 2 Operat|rskommandon Sammanfattning av samtliga operat|rskommandon uppdelade p} fr}n vilken meny de kan anges med funktionstangent: KOMMANDON I HUVUDMENYN: SETUP - Setup BATCH - Batch INTACT - Interaktiv EXIT - Exit program KOMMANDON I SETUP-MENY: MAIN - ]terg} till mainmenyn INFACE - V{lj interface GPIB - [ndra kommunikations-parametrar f|r GPIB RS232 - [ndra kommunikations-parametrar f|r RS232 TIMOUT - V{lj timeouttid f|r batch BATTIM - [ndra testtid f|r batch PRINT - Sl}r av/p} loggning p} printer FILLOG - Sl}r av/p} loggning p} fil LOGNAM - V{ljer namn p} loggfil LOGTYP - V{lj vilka utskriftstyper som skall loggas RETURN - ]terst{ll funktionstangenterna till setup-kommandon KOMMANDON I BATCH-MENY: MAIN - ]terg} till mainmenyn BATNAM - V{lj batchfil START - Starta k|rning av batchfilen fr}n b|rjan WAIT - V{nta GO - ]terstarta STEP - Singelstep STOP - Stoppa k|rning KOMMANDON I INTERAKTIV-MENY: Upp}t - Bl{ddrar bak}t i current-line-f|nstret Ned}t - Bl{ddrar fram}t i current-line-f|nstret MAIN - ]terg} till mainmenyn EDIT - Editera SNDONE - S{nd en rad (current) SNDBUF - S{nd hela bufferten en g}ng SEND - S{nd tillsvidare (fr}n current) STOP - Stoppa s{ndning KOMMANDON I EDITORN: Upp}t - Flyttar mark|ren ett steg upp}t. Ned}t - Flyttar mark|ren ett steg ned}t. H|ger - Flyttar mark|ren ett steg fram}t. V{nster - Flyttar mark|ren ett steg bak}t. Home - Flyttar mark|ren l{ngst upp till v{nster. End - Flyttar mark|ren l{ngst ner till h|ger. Insert - V{ljer insert eller overwrite mode. Backsp. - Tar bort ett tecken till v{nster om mark|r. Delete - Tar bort ett tecken till h|ger om mark|r. MAIN - ]terg} till mainmenyn GETBUF - L{ser in fil i buffert. (Max 20 rader.) SAVBUF - Sparar bufferten p} fil. DELLIN - Tar bort en rad. UNDEL - L{gger tillbaka borttagen rad. RETURN - Avbryt editering, }terg} till interaktiv mode. Exakt vad de olika kommandona utf|r och vilka parametrar de skall ha beskrivs i respektive meny-kapitel. %page %title 2 Where is an operator command allowed? MODE: BATCH INTERACTIV MAIN SETUP IDLE SEND IDLE SEND EDIT Menu commands: +-----+-----+-----+-----+-----+-----+-----+ SETUP ! X ! ! X ! ! X ! ! ! BATCH ! X ! X ! ! ! X ! ! ! INTACT ! X ! X ! X ! ! ! ! ! MAIN ! ! X ! X ! ! X ! ! X ! EDIT ! X ! X ! X ! ! X ! ! ! EXIT ! X ! X ! X ! X ! X ! X ! ! RETURN ! ! X ! X ! ! X ! ! X ! Setup commands: +-----+-----+-----+-----+-----+-----+-----+ INFACE ! X ! X ! X ! ! X ! ! ! GPIB ! X ! X ! X ! ! X ! ! ! RS232 ! X ! X ! X ! ! X ! ! ! TIMOUT ! X ! X ! X ! X ! X ! X ! ! BATTIM ! X ! X ! X ! X ! X ! X ! ! PRINT ! X ! X ! X ! X ! X ! X ! ! FILLOG ! X ! X ! X ! X ! X ! X ! ! LOGNAM ! X ! X ! X ! ! X ! ! ! LOGTYP ! X ! X ! X ! X ! X ! X ! ! Batch commands: +-----+-----+-----+-----+-----+-----+-----+ BATNAM ! X ! X ! X ! ! X ! ! ! START ! ! ! X ! ! ! ! ! WAIT ! ! ! ! X ! ! ! ! GO ! ! ! X ! ! ! ! ! STEP ! ! ! X ! X ! ! ! ! STOP ! ! ! ! X ! ! ! ! Interactiv commands: +-----+-----+-----+-----+-----+-----+-----+ SNDONE ! ! ! ! ! X ! ! ! SNDBUF ! ! ! ! ! X ! ! ! SEND ! ! ! ! ! X ! ! ! STOP ! ! ! ! ! ! X ! ! UpArrow ! ! ! ! ! X ! ! ! DownArrow ! ! ! ! ! X ! ! ! Edit commands: +-----+-----+-----+-----+-----+-----+-----+ UpArrow ! ! ! ! ! ! ! X ! DownArrow ! ! ! ! ! ! ! X ! RightArow ! ! ! ! ! ! ! X ! LeftArrow ! ! ! ! ! ! ! X ! Home ! ! ! ! ! ! ! X ! End ! ! ! ! ! ! ! X ! Insert ! ! ! ! ! ! ! X ! Backspace ! ! ! ! ! ! ! X ! Delete ! ! ! ! ! ! ! X ! GETBUF ! X ! X ! X ! ! X ! ! X ! SAVBUF ! X ! X ! X ! ! X ! ! X ! DELLIN ! ! ! ! ! ! ! X ! UNDEL ! ! ! ! ! ! ! X ! ---------------------+-----+-----+-----+-----+-----+-----+-----+ %title 2 Huvudmenyn Kommandon SETUP V{ljer Setup-menyn varifr}n man kan s{tta upp olika parametrar f|r kommunikation, utskriftstyper, testtid och loggmedia. BATCH V{ljer batch-menyn varifr}n man kan k|ra en tidigare iordninggjord kommandofil. INTACT V{ljer interaktiv-menyn varifr}n man kan k|ra interaktiv test EXIT Avbryter k|rningen av programmet. Om man varit och editerat utan att spara bufferten, kommer en fr}ga om man verkligen vill g} ur programmet utan att spara. %title 2 Setup-meny The setup menu has three sub menues to which are switched if any of the commands GPIB, RS232 or LOGTYP is given through the function keys. Only parameters connected to the given command are displayed, Which now can be toggled through the function keys. Kommandon MAIN Backar till programmets |versta niv}. INFACE Togglar kommunikationsinterface mellan RS232 och GPIB. Default n{r programmet startas {r GPIB. P} sk{rmen visas vilket av GPIB och RS232 som {r invalt, samt aktuellt interfaces parametrar. GPIB kommunikationsparameter v{rde St{ller om en kommunikationsparameter f|r GPIB-interfacet. M|jliga v{rden f|r parametrarna {r: Communication parameter Value Defaultvalue ADRESS 0-29 1 Om kommandot GPIB ges med funktions-tangent(, d.v.s. i setup-menyn,) kommer ingen fr}ga om parametrar, ist{llet visas en ny upps{ttning funktionstangenter d{r man kan toggla v{rdena f|r de olika kommunikationsparametrarna. Aktuella v{rden visas p} sk{rmen n{r kommunikationen sker med GPIB. RS232 kommunikationsparameter v{rde St{ller om en kommunikationsparameter f|r RS232-interfacet. M|jliga v{rden f|r parametrarna {r: Kommunikationsparameter V{rde Defaultv{rde BAUD 110-9600 9600 PARITY no, odd, even no DATBIT 5, 6, 7, 8 8 STPBIT 1, 2 1 Om kommandot RS232 ges med funktions-tangent(, d.v.s. i setup-menyn,) kommer ingen fr}ga om parametrar, ist{llet visas en ny upps{ttning funktionstangenter d{r man kan toggla v{rdena f|r de olika kommunikationsparametrarna. Aktuella v{rden visas p} sk{rmen n{r kommunikationen sker med RS232. TIMOUT tid V{lj timeouttid f|r batch, kan vara mellan 1 och 999. Det {r hur l}ng tid som programmet skall v{nta p} svar efter ett kommando s{nts till STH. Anges i millisekunder per f|rv{ntat svar. BATTIM [tid] S{tter upp, om anges, hur l{nge ett batchtest skall p}g}. Om ej anges k|rs testen tills den stoppas p} annat s{tt. Detta {r ocks} default. Tiden anges p} formerna TT:MM:SS, TT:MM eller TT. Gr{nsv{rden {r 0-99 f|r timmar, 0-59 f|r minuter och sekunder. Om kommandot ges under tiden ett batchtest k|rs r{knas testtiden fr}n det |gonblicket. ]terst}ende testtid visas p} sk{rmen under tiden ett test k|rs. PRINT status Sl}r av eller p} loggning p} printern. kan vara ON eller OFF. Statusens v{rde visas p} sk{rmen med PRON eller PROFF. FILLOG status Sl}r av eller p} loggning p} fil. Om {r ON aktiveras fil-loggningen. Om filen finns tidigare kommer den att skrivas |ver. (Om loggningen p} fil redan {r aktiverad h{nder ingenting). Om {r OFF avbryts fil-loggningen om den {r aktiv. Statusens v{rde visas p} sk{rmen med LOGON eller LOGOFF. LOGNAM logfilnamn V{ljer namn p} den fil som skall loggas p}. LOGTYP typ V{lj vilka loggtyper som skall loggas. kan vara en eller flera av de olika loggtyperna: S, AR, SR, UR, ER och E. Om kommandot ges med funktionstangent (, d.v.s. i setup-menyn,) kommer en ny funktionstangents-upps{ttning d{r man kan toggla on/off p} de olika loggtyperna. RETURN ]terg} till den normala funktionstangents-upps{ttningen i setup-menyn, kan bara anges om man har {ndrat funktionstangents- upps{ttningen med GPIB-, RS232- eller LOGTYP-kommandona. %title 2 Batch-meny From this menu a test can be performed as a batch job. The lines in the batch sequence and the messages received from STH are displayed as they are performed/received. See appendix for an example on what it can look like during a test. Kommandon MAIN Backar till programmets |versta niv}. Funktionstangents- upps{ttningen {ndras till main-menyns. BATNAM filnamn V{lj batchfil enligt . En l{nkad kommandolista skapas samtidigt som filen syntaxcheckas. Ev fel skrivs p} logg- medierna. START Exekverar den l{nkade listan som skapats vid BATNAM. M}ste f|reg}s av ett batnam-kommando. WAIT Om k|rning p}g}r kan den tillf{lligt stoppas med detta kommando. Under det tillf{lliga stoppet g}r det {ven att byta meny. GO Om k|rning har stoppats tillf{lligt med WAIT-kommandot kan den }terstartas med detta kommando. STEP Exekverar en rad i den l{nkade kommandolistan. Kommandot kan {ven ges under ett tillf{lligt stop (efter WAIT-kommandot). Efter ett STEP-kommando kan k|rningen }terupptas med GO-kommandot. STOP Avbryter p}g}ende k|rning efter att p}b|rjat kommando i batchfilen utf|rts. Statistik skrivs p} eventuella loggmedia. %title 2 Interaktiv-meny From this menu an interactive test can be performed. The commands sent and the messages received from STH are displayed as they are performed/received. See appendix for an example on what it can look like during a test. I interaktiv meny visas alltid en "current-line" p} raden ovanf|r kommandoraden. I den visas en rad ur editbuffern. N{r man kommer fr}n editorn {r det den rad som man stod p} vid l{mnandet av editorn. Current-line anv{nds f|r att markera vilken rad man vill s{nda/b|rja s{nda ifr}n. Kommandon Upp}tpil [ndrar current-line till f|reg}ende rad i editbuffern. Ned}tpil [ndrar current-line till n{sta rad i editbuffern. MAIN Backar till programmets |versta niv}. Funktionstangents- upps{ttningen {ndras till main-menyns. EDIT [editfil] Editerar editbuffern. Om angetts kommer den att l{sas in till editbuffern. Om ej angetts editeras befintliga data i editbuffern. SNDONE S{nder current-line till STH. R{knar upp current-line till n{sta icke-blanka rad editbuffern. SNDBUF S{nder bufferten en g}ng fr}n f|rsta till sista rad. Current- line s{tts till f|rsta raden i buffern. SEND Startar s{ndning tillsvidare. S{ndningen startar fr}n current- line, n{r sista rad s{nts startar s{ndningen om fr}n f|rsta raden i buffern. STOP Stoppar s{ndningen. Current-line s{tts till raden efter den sist s{nda. %title 3 Editorn Inmatade tecken placeras i editbuffern d{r mark|ren st}r. Om insert mode {r aktiverad kommer tecknen till h|ger att knuffas fram}t ett steg, och det sista tecknet (80:e) p} raden kommer att kastas bort(, om sekvenser l{ngre {n 20 rader |nskas f}r man anv{nda sig av batchmode). Vid kommandot "Undelete Line" kommer sista raden i editbufferten att kastas bort. I editorn kan inga kommandon ges p} kommandoraden utan endast med hj{lp av funktionstangenter. Om man skrivit n}got i bufferten utan att spara detta p} fil, och vill g} ur programmet, fr}gas om inte bufferten skall sparas. Kommandon Upp}tpil Flyttar mark|ren ett steg upp}t, om mark|ren finns h|gst upp h{nder ingenting. Ned}tpil Flyttar mark|ren ett steg ned}t, om mark|ren finns l{ngst ner h{nder ingenting. H|gerpil Flyttar mark|ren ett steg fram}t, om mark|ren finns l{ngst till h|ger h{nder ingenting. V{nsterpil Flyttar mark|ren ett steg bak}t, om mark|ren finns l{ngst till v{nster h{nder ingenting. Home Flyttar mark|ren l{ngst upp till v{nster. End Flyttar mark|ren l{ngst ner till v{nster. Insert V{ljer insert eller overwrite mode. Vid insert mode knuffas tecknen som redan finns p} raden tecken till h|ger, medans vid overwrite skrivs tidigare inmatat data |ver. Backspace Tar bort ett tecken till v{nster om mark|ren, och knuffar tecknen till h|ger om det borttagna ett steg till v{nster. Delete Tar bort tecknet d{r mark|ren st}r, och knuffar tecknen till h|ger om det borttagna ett steg till v{nster. GETBUF editfil L{ser in filen till editbuffern. Om filen {r l{ngre {n 20 rader kommer bara de 20 f|rsta raderna att l{sas in. Om n}gon rad {r l{ngre {n 80 tecken kommer bara de 80 f|rsta tecknena att l{sas in. Om detta kommando ges med funktionstangent dvs. i editorn kommer en fr}ga om filnamn p} kommandoraden. SAVBUF [editfil] Sparar bufferten p} fil. Om ej anges sparas filen p} den senast inl{sta filen. Om ingen fil l{sts in sparas den p} "EDIT.MTS". Om detta kommando ges med funktionstangent dvs. i editorn kommer en fr}ga om filnamn p} kommandoraden. DELLIN Delete Line. Tar bort den raden som mark|ren st}r p} och l{gger in en blank rad som den sista i buffern. UNDEL L{gger tillbaka den senast borttagna raden (med kommandot Delete Line). Om ingen rad har tagits bort h{nder ingenting. RETURN Avbryter editering, }terg}r till interaktiv mode. Den rad som mark|ren st}r p} blir "current line". %title 2 Batch sequence commands I batch-filen skriver man, med en liten skillnad, kommandona p} samma s{tt som n{r man k|r interaktivt. F|re sj{lva kommandot anges med ett numeriskt v{rde hur m}nga svar som f|rv{ntas. Detta f|r att veta hur l{nge som skall v{ntas p} svar innan n{sta kommando i sekvensen skall s{ndas. H{r kan ocks} anges speciella batch-kommandon och kommentarer. These commands are not sent to STH, they just control the execution of the batch sequense and write texts on screen and log during test. * FOR [counter] Runs the sequence of commands between this command and corresponding NEXT command times. If is omitted the loop will continue forever. * NEXT See FOR command. * PAUSE [seconds] Stops execution of the batchloop during seconds. If seconds is omitted the test will not proceed until a key is pressed. The communication is scanned during the pause, received messages are logged and the remaining time displayed on screen is updated. * STOP Stops execution of the batchloop. Statistics are printed on the log. * ECHO [text] Display on screen. If is omitted a blank line is displayed. * LOG [text] Write on screen and log. If is omitted a blank line is written. Comments: F|r att t.ex. veta vad som {r avsikten med ett visst kommando kan sist p} varje rad ocks} skrivas kommentarer (ej LOG och ECHO kommandona). Dessa f|reg}s av en apostrof ('). Under k|rning visas {ven dessa p} sk{rmen med undantag f|r rader som endast inneh}ller kommentarer. %title 2 Transcriptions During test the activity can be logged on printer and/or logfile. All activity is also displayed in the scroll region on screen. Log is enabled with the operator commands FILLOG and PRINT. On screen is showed which log medias are selected. Layouts are described in appendix. The default name of the logfile is "LOG.MTS". It can be changed in the setup menu. There are some differences in the transcriptions between screen and log, batch and interactive. For every transcriptiontype all possible parts are described. In different situations different parts are written. %title 3 Headers At the top of each side of the log a header consisting of three lines is written. First line contains: - Date - Logfilename (when logfile is selected) - Batchfilename - Page number Second line contains: - Abbreviated column headings: LT - LogType ID - IDentificaton number on a message received from STH ML - Message Length AD - unit ADress on SLAN HEXDATA - DATA part of a message in HEXadecimal representation ASCII - data part of a message in ASCII code Third line contains: - A line (_________) %title 3 Batch commands During batchtest the batch command lines, FOR, NEXT, PAUSE and STOP are displayed in low intensity on screen as they are interpreted. Only the texts in LOG and ECHO commands are displayed. %title 3 Requested texts The textstring in the batch command ECHO is displayed on the screen. The textstring in the batch command LOG is displayed on the screen and written on the log. %title 3 Commands sent to STH Lines with commands sent to STH contains - Abbreviated logtype * Sent command *** S *** - Number of expected answers * NEA: nn - Data part of the command in hex and ascii * Hex part is displayed with two hex symbols for each byte, and a blank between each byte. * Ascii part is displayed between double qoutes (") %title 3 Messages from STH On lines with received messages, the following is written: - Abbreviated logtype * Answer Received === AR === * Spontanous Receive +++ SR +++ * Unexpected Receive ??? UR ??? - Message identification in hex * 00 = spontanous message * 01-FF = sequential ID number - Length of message in hex - SLAN unit address in hex - Contents of message, written in both hex and ascii On lines with received error messages, the following is written: - Error Receive ;;; ER ;;; - Contents of message, written in ascii %title 3 Error messages Two different kinds of error messages are logged, those who are generated by PC and those from STH. STH errors is logged as a received message, see chapter "Messages from STH". In this chapter only the error messages from PC are described. The error message lines contains: - Abbreviated logtype &&& E &&& - Error text These are the existing types of error messages: * Batch file size The batch file is too big to fit in RAM. * Syntax error Error in the batch file. The line with the error and a short description of what is wrong, is written on log and sreeen. These are the existing syntax error descriptions: Invalid command Invalid parameter Invalid number of parameters Missing FOR statement Missing NEXT statement Too deep nested FOR NEXT loop Double quotes missing Dynamic memory buffer exeeded * Communication error Unsuccessfull initiation of communication or errors during communication (RS232 or GPIB). The line contains: - Communication type RS232/GPIB - Error type - Error code The different error types and codes are described in the communication documentation. * Timeout Expected answer from STH is not received within the specified timeout time. %title 3 Statistics After the test is finished, a short statistic is written. It consists of the number of logtyped lines written on the screen, divided into each logtype (logtypes deselected by LOGTYP command are also counted). %title 3 Differences log-screen / batch-interactive Batch - interactive The transcriptions in interactive mode do not contain everything those in batch mode do. * The header contains no - batch filename - abbreviated column headings * The "sent message line" contains no number of expected answers * No unexpected received answers are logged. (There aren't any!) * No statistics are written after a complete test. Log - screen The log is identical on both devices(, file and printer), but there are som differences between log and screen. * Headers are only written on the log. (There are short column headings on the screen above the scroll region in batch mode.) * The characters surrounding the logtypes are only written on the log. * Only selected logtypes are logged. * Batch-commands are only displayed on the screen. * On the screen there are some lines displayed in low intensity: - Sent STH-commands - Batch-commands, including texts from ECHO and LOG * Received messages are displayed in high intensity. * Error messages are displayed in inversed video. %title 2 Syntax check of batch file I samband med att batchfilnamnet anges, eller vid start av testet om default-batchfilen k|rs, sker syntaxkontroll av filen. En l{nkad kommandolista skapas samtidigt som filen syntax- checkas. Endast rader som inneh}ller kommandon l{nkas med i listan. Om fel uppt{cks skrivs radnummer, raden och en kort kommentar till vad som {r fel. The syntaxcheck will check that: * commands sent to STH are preceeded by a correct "number of answers expected". * batch commands exists. * there are the correct number of parameters to batch commands. * parameters are of the right type and have correct values. * every FOR command has a corresponding NEXT command. * every NEXT command has a corresponding FOR command. * the loops are not nested more than 19 times. * when parameters are given as ascii, there are an even number of double quotes. This is also checked in interaktive mode. * the linked list fits into RAM. %page %title 0 %title 1 Interface mot STH %title 2 Kommunikationsprocedur Formatet p} kommandona till och meddelanden fr}n STH finns i detalj beskrivet i "PEAB SLAN, Master Test System". Det som h{r kommer att beskrivas {r hur operat|ren skriver in kommandona till MTS_PC och hur MTS_PC formaterar om dem }t MTS i STH samt hur meddelanden fr}n STH tas omhand. I interaktiv mode editeras kommandona in i edit bufferten. Begr{nsning finns d} p} 80 tkn/rad. Varje rad best}r av data som kan skrivas i ascii-kodad hex eller ascii. Om man vill anv{nda ascii m}ste den delen av raden som skrivs i ascii omslutas av dubbelfnuttar ("). De delar av raden som ascii-kodats kommer att konverteras till ascii-kodad hex innan de skickas till MTS i STH. Varje ascii-tecken kan skrivas som tv} hextecken, eller bara ett om det omges av blanktecken. N}gra exempel: I MTS_PC: Skickas till MTS i STH: 1 2 3 4 5 0102030405 12 23 34 45 12233445 1 2 34 56 "hej"7890 0102345668656A7890 I batch-kommandofilen anges antal f|rv{ntade svar f|re varje STH-kommando. Antalet (0-32767) talar om hur m}nga svars- meddelanden p} kommandot som det borde komma fr}n STH. Varje rad som b|rjar p} ett numeriskt v{rde inneh}ller allts} ett kommando till STH. Antal f|rv{ntade svar m}ste anges dels f|r att skilja raden fr}n batch-kommandon (FOR, NEXT o.dyl.) och dels f|r att timeoutsystemet skall fungera (eftersom timeouten baserar sig p} antal f|rv{ntade svar). Efter efter detta v{rde anges ett kommatecken (,) f|re sj{lva kommandot till STH, f|r att avskilja det fr}n resten av raden. Ett exempel p} en batch-kommandofil: FOR 10 1,1 2 3 4 5 2 , 12 23 34 45 0 ,1 2 34 56 "hej"7890 NEXT The messages from STH are divided into the following different types: * Answer Received These are the messages from STH containing a sequential number not equal zero. (It's not possible to know which command a specific answer is connected to, since the sequential number is generated by STH, besides, only commands sent to SLAN get a number.) * Spontanous Receive Messages from STH which contain zero as sequential number. * Unexpected Receive Unexpected answer to a sent command. There was more answers received containing a sequential number, not zero, than the expected number of answers given in the batchfile. (Can only occur in batch mode.) * Error Received An error message from STH is defined as a received message beginning with a semicolon. Description of STH errors is found in the document "PEAB SLAN Master Test System". %title 2 GPIB The parallell communication between PC and STH uses the program package "HP-IB Command Library for MS-DOS". Since this program package has MS-Pascal interface, the external procedures in Oregon Pascal has to be declared to use Microsoft interface. %title 2 RS232 The asynchronous communication between PC and STH uses the program package "ASYNCH MANAGER" from Blaise Computer INC. Since this program package has MS-Pascal interface, the external procedures in Oregon Pascal has to be declared to use Microsoft interface. %page %title 0 %title 1 Datafl|de / dataorganisation %title 2 Batchkommandofil N{r programmet i PC'n k|rs kan det antingen ske i batch- eller interaktiv-mode. Om det k|rs i batch-mode skall en kommandofil finnas innan k|rningen kan p}b|rjas. I kommandofilen finns det en sekvens av batch-kommandon och kommandon som skall skickas vidare till STH. Beskrivningen av batch-kommandona finns i kapitlet "Batch sequence commands". Samtidigt som programmet l{ser in kommandofilen sker syntaxcheck av varje rad och en l{nkad lista, med en l{nk f|r varje rad, skapas. Varje l{nk i listan har f|ljande utseende (uttryckt i Pascal): BaListRec_t = RECORD { A record in the linked command list } pnext : BaList_ptr { Next link in command list } Text : lstrX_ptr; { Text part of the batch file line } TextSize : int2; { Length of Text } CASE BaCmd : BaCmd_t OF { The batch command } bc_STH : ( AnswExp : int2; { Number of answers expected } ); bc_For : ( { bc_For..bc_Next } Arg1 : int2; { First argument on batch file line } ForNextPtr : BaList_ptr; { Pointer to corr. FOR or NEXT } LoopCnt : int2; { For-loop counter } ) END; { RECORD } %page %title 0 %title 1 Program module description #include modspec %page %title 0 %title 1 Systemgenereringsinformation Programutvecklingen kommer att ske p} IBM-PC eller kompatibel. Programspr}k som anv{nds {r Oregon Pascal-II. F|r kommunikationen |ver GPIB och RS232 anv{nds f{rdiga paket. Mer om dessa under "Interface mot STH".