


                                  - 1 -



                    ==================================
                    1 - LE SYSTEME DE TEST STS DU SPS9
                    ==================================


       1.  INTRODUCTION

       Pour repondre aux besoins de test et de maintenance, le
       systeme de test STS fournit trois niveaux de test,
       correspondants aux differents profils des utilisateurs
       potentiels:

         1.  Le niveau 1 permet d'effectuer le controle global de
             la configuration testable ou d'un sous ensemble
             fonctionnel de cette configuration ( la configuration
             testable definie l'ensemble des elements de la
             configuration installee pouvant effectivement faire
             l'objet d'un test; ces elements, appeles "unites" sont
             de deux types, unites d'echanges et peripheriques ).

         2.  Le niveau 2 permet de lancer l'execution du test d'une
             ou de plusieurs unites de la configuration testable.

         3.  Le niveau 3 permet l'acces aux tests elementaires des
             unites d'echanges qui sont residents dans les proms de
             la carte.

       Les niveaux 1 et 2 sont geres par le Moniteur de Test , le
       niveau 3 par le Noyau de Test.  STS prend en compte les
       unites d'echange a base 68000 et 68020, et leur peripherie.
       Ces unites font chacune l'objet d'une fiche d'utilisation du
       test, jointe a ce document.


       2.  LE_MONITEUR_DE_TEST

       Le moniteur de test permet de lancer le test des unites de
       la configuration testable, sous systeme d'exploitation et en
       temps partage.  Ces tests sont de deux classes:

         1.  les tests d'unites d'echanges

                - test structurel base (tests elementaires de la
                  base).

                - test structurel specifique (tests elementaire de
                  la partie specifique).

                - test fonctionnel, utilisant l'interface standard
                  offert par la partie specifique au driver.












                                  - 2 -



         2.  les tests de peripheriques

                - test fonctionnel, utilisant l'interface standard
                  offert par la partie specifique au driver.

       Tout test d'unite, execute par le moniteur de test, passe
       par les phases suivantes:

         1.  requete d'acquisition de la ressource au driver
             correspondant qui suspend les utilisateurs potentiels,
             si celle-ci n'est pas partageable.

         2.  echanges avec l'unite par des iotest ( execution
             synchrone de DCB ).

         3.  requete de restitution du contexte au driver

         4.  reinitialisation et rechargement de l'unite d'echange,
             si les tests ont ete destructifs.


       3.  LE_NOYAU_DE_TEST

       Le noyau de test est le logiciel, resident dans les proms
       des modules d'echanges, qui lance l'execution des tests
       elementaires.  Il peut etre active:

          - par STS pour les tests de niveaux 1 et 2.

          - par un operateur connecte a la ligne V24 de la base des
            unites d'echanges, pour les tests de niveaux 3.

       Les chapitres suivants decrivent la mise en oeuvre de STS.





























                                  - 3 -



                      ===========================
                      2 -  LE  MONITEUR  DE  TEST
                      ===========================


       4.  LANCEMENT_DE_STS

       STS doit etre lance par ROOT , il se situe sous
       /usr/test/sts et s'execute par la commande testsps9


       5.  DIALOGUE_OPERATEUR

       Le dialogue entre STS et l'operateur est realise par
       differents menus, le deplacement dans le menu s'effectue a
       l'aide des deux touches fleche verticale haut (CNTRL K) et
       fleche verticale bas (CNTRL V), l'entree selectionnee
       apparait alors en mode clignotant et la validation se fait
       par la fonction val <CR>. Sur la derniere ligne de l'ecran
       sont affichees en permanence les differentes fonctions
       offertes a l'operateur.


       6.  DESCRIPTION_DES_MENUS

       STS possede trois niveaux de menus decrits comme suit:

         1.  Le premier menu permet de:

                - choisir la langue qui sera utilisee dans le
                  dialogue entre l'operateur et STS
                  (anglais/franc,ais).

                - creer ou modifier la configuration de test.

                - appeler le moniteur de test.

         2.  Le deuxieme menu, appele par le choix "systeme de
             test" permet de lancer l'execution de tests proprement
             dit.
             Deux niveaux de tests sont distingues:

                - niveau 1 pour le controle de configuration et le
                  test d'ensembles.

                - niveau 2 pour le test d'unites.

             Ces deux niveaux de test seront detailles dans le
             chapitre "les niveaux de test"
             Une fois le type de test selectione, les differentes
             modalitees d'execution du test peuvent etre choisies a











                                  - 4 -



             l'aide des touches <0 a 9>, representant chacune une
             fonction, comme l'indique la derniere ligne de
             l'ecran:

                - fin <0>: fin de STS.

                - exec <1>: execution du test.

                - st/er <3>: arret sur la premiere erreur (si
                  selecte, chaque test d'unite lancese terminera
                  sur la premiere erreur rencontree).

                - boucle <5>: mode rebouclage (l'operateur specifie
                  le nombre n de rebouclages a effectuer,
                  l'ensemble des tests demandes est alors reboucle
                  n fois).

                - bavard <7>: si selecte, tous les messages
                  (operateur, erreur, question) seront edites a la
                  console , sinon seules les questions sont
                  affichees.

                - op <9>: selection du mode operateur (cf chap
                  4.3).

                - brk <del>: break operateur (cf chap 5).

             Lorsque q'une fonctionnalite est selectionee, elle
             apparait en inverse video.

         3.  Le troisieme menu, appele par le choix "utilitaire"
             permet de visualiser et eventuellement de modifier:

                - les fichiers d'erreurs.

                - les fichiers parametres.

                - le fichier erreur systeme.

             Si un fichier d'erreur est vide, c.a.d. aucune erreur
             n'a ete mentionnee dans le test, une * apparaitra a
             gauche de l'unite.
             Si le mode papier est selectione, le fichier demande
             sortira sur l'imprimante.


















                                  - 5 -



       7.  LES_NIVEAUX_DE_TEST


       definition: un ensemble est une entite, definie par son nom,
       qui regroupe toutes les unites de la configuration testable,
       presentant une certaine coherence fonctionelle ou materielle
       entre elles.  Ce regroupement est libre et est defini par la
       description de la configuration
        (cf chap 6.1).

       7.1  Le_niveau_1

       7.1.1  Controle_de_configuration  Cette fonction provoque
       l'execution des tests de toutes les unites decrites dans le
       fichier de configuration "conf.test".
       Le diagnostic final donne le nombre d'unites en erreur et
       les ensembles trouves defectueux.

       7.1.2  Test_d'ensembles  Cette fonction permet de choisir le
       ou les ensembles a tester, definis dans le fichier
       "conf.test" ; pour ce faire, se deplacer dans la fenetre
       decrivant les differents ensembles, valider l'ensemble
       choisi par la fonction val <CR>, le nom de l'ensemble
       apparait alors en inverse video, les autres ensembles
       selectiones apparaissent precedes du prompt ">" (un ensemble
       selectionne peut etre efface par la fonction effct ).  Une
       fois tous les ensembles a tester selectionnes, sortir de la
       fenetre par la fonction fin , et la fonction exec provoque
       l'execution des tests de toutes les unites definies comme
       appartenant a l'ensemble choisi.
       Le diagnostic final donne le nombre d'unites en erreur et
       les ensembles trouves defectueux.

       7.2  Le_niveau_2

       Cette fonction permet de choisir le ou les unites a tester,
       definis dans le fichier "conf.test" ; pour ce faire, se
       deplacer dans la fenetre decrivant les differentes unites,
       valider l'unite choisie par la fonction val <CR>, le nom de
       l'unite apparait alors en inverse video, les autres unites
       selectionees apparaissent precedees du prompt ">" (une unite
       selectionnee peut etre effacee par la fonction effct ).  Une
       fois toutes les unites a tester selectionnees, sortir de la
       fenetre par la fonction fin , et la fonction exec provoque
       l'execution des tests de toutes les unites selectionees.
       Le diagnostic final donne le nombre d'unites en erreur et le
       nom des unites trouvees defectueuses.















                                  - 6 -



       7.3  Le_mode_operateur

       Ce mode est selecte par la fonction op et permet de definir
       en mode conversationnel les differents parametres de test
       qui sont pris, dans le cas des niveaux 1 et 2, par defaut
       dans le fichier ".par" associe.


       8.  LA_FONCTION.IREAK

       Il existe une fonction dont le role est un peu particulier,
       c'est la fonction brk , representee par touche <del>.
       Pendant l'execution d'un test, l'operateur peut a tout
       moment reprendre le dialogue avec STS par la fonction brk et
       ainsi consulter l'etat des unites en test, activer une
       nouvelle unite ou tuer une unite active (par la fonction
       abort ).
       L'etat des unite est repere par un promt qui precede le nom
       de celle -ci:

          - >          a tester.
          - *          active.
          - !          terminee sans erreur.
          - @          erronee.
          - +          a tuer.

       L'execution des tests est alors relancee par la fonction
       exec.


       9.  DESCRIPTION_DES_FICHIERS

       9.1  Le_fichier_configuration

       Toute unite faisant l'objet d'un test s'executant sous STS,
       doit etre decrite dans le fichier configuration "conf.test"
       , modifiable par l'editeur de texte vi et dont la stucture
       est definie ci-dessous:
























                                  - 7 -




                ----------------------------------------------------------
               |  nom  |   unite de   |  fichier   | liste des |   zone   |
               | unite | rattachement | executable | ensembles | reservee |
               |=======|==============|============|===========|==========|
               | xxxx  |   yyyy       |  xxxx.tst  |  e1...e5  |[/.......]|
               | .     |   .          |  .         |  .        | .        |
               | .     |   .          |  .         |  .        | .        |
               | .     |   .          |  .         |  .        | .        |
                ----------------------------------------------------------

       Chaque ligne du fichier correspond a une entree differente, les
       caracteres de separation sont les blancs et les tabulations.
       Le nombre maximum d'entrees est 50.
       L'unite de rattachement definit le rattachement fonctionnel ou materiel
       d'une unite envers une autre (exemple: un peripherique et son unite
       d'echange).
       Deux unites qui ont la meme unite de rattachement ne peuvent pas
       etre activees parallelement.
       Le nombre maximum de caracteres que peut contenir chaque nom est de 16.
       Le nombre maximum d'ensembles auxquels peut appartenir une unite est
       de 5.
       Chaque entree de "conf.test" est definie dans la fiche
       d'utilisation relative au test de l'unite correspondante.

       9.2  Les_fichiers_parametres

       Chaque unite possede un fichier parametre ".par" contenant
       tous les parametres de test concernant cette unite.  Ils
       sont consultables et modifiables via le menu "utilitaire"
       par l'editeur de texte vi.
       La structure du fichier parametre est la suivante:






























                                  - 8 -




                ---------------------------------------------------
               |#                                                  |
               |#                                                  |
               |.                                                  |
               |.                                                  |
               |.                                                  |
               |#                                                  |
               |                                                   |
               |% val1                                             |
               |% val2                                             |
               |.                                                  |
               |.                                                  |
               |% val10                                            |
               |                                                   |
               |d1 d2 d3    test1      p1 p2...............p10     |
               |d1 d2 d3    test2      p1 p2...............p10     |
               |.                                                  |
               |.                                                  |
               |.                                                  |
                ---------------------------------------------------

       - # definit la zone commentaire.

       - % definit une valeur de configuration specifique a l'unite:
           - vali=0...       donnee codee en octal
           - vali=0x..       donnee codee en hexadecimal
           - vali=....       donnee codee en decimal
           (10 valeurs au maximum).

       - di definit le niveau de test (d1:niveau 1, d2:niveau 2, d3:reserve).
            di=1 ---> test a executer.
            di=0 ---> test a ne pas executer.

       - testi definit le nom du test (20 caracteres maximums).

       - pi definit les parametres:
            - pi=0...        parametre octal
            - pi=0x..        parametre hexadecimal
            - pi=....        parametre decimal ou chaine de caractere
            (10 parametres au maximum).





















                                  - 9 -



       exemple: le fichier parametre du test de la base d'une unite d'echange.

                ------------------------------------------------------
               |#               TEST DE LA.IASE UE                    |
               |#                                                     |
               |# Le test de la base UE effectue les tests suivants:  |
               |# - presence du coupleur                              |
               |# - type du coupleur                                  |
               |# - status base                                       |
               |# - PIO                                               |
               |# - transfert DMA UC <--> UE                          |
               |# - enchainement 1 des tests elementaires base        |
               |                                                      |
               |% 0x80    # adresse physique du coupleur              |
               |% 0x80    # type du coupleur                          |
               |                                                      |
               | 1 1 0      testbase   1  1                           |
                ------------------------------------------------------

       9.3  Les_fichiers_d'erreur

       Chaque message d'erreur d'une unite est date et stocke dans
       son fichier d'erreur associe. Ils sont consultables via le
       menu "utilitaire" par l'editeur de texte vi.

       9.4  Le_fichier_erreur_systeme

       Si une erreur systeme intervient, l'operateur en est averti
       par le message "*** erreur systeme" et le motif est
       enregistre dans le fichier sys_error consultable via le menu
       "utilitaire" par l'editeur de texte vi.































                                  - 10 -



       10.  ANNEXE_1

       Exemples de menus:

       10.1  menu_1


          ********************************************************************
         *                                                                    *
         *             SYSTEME DE TEST ET DE SURVEILLANCE DU SPS9             *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *  Langue                                                            *
         *                                                                    *
         *  Configuration                                                     *
         *                                                                    *
         *  Systeme de test        <---(appel menu 2)                         *
         *                                                                    *
         *  Systeme de surveillance                                           *
         *                                                                    *
         *  Aide                   <---(acces au manuel d'utilisation)        *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *  ----------------------------------------------------------------  *
         * | val:<cr> |               |print:<p>|                |fin:<del> | *
         *  ----------------------------------------------------------------  *
         *                                                                    *
          ********************************************************************





























                                  - 11 -



       10.2  menu_2


          ********************************************************************
         *                                                                    *
         * version 01.00     SYSTEME DE TEST DU SPS9    Wed Jan 00:00:00 1986 *
         * ------------------------------------------------------------------ *
         * .............................                                      *
         * . controle de configuration .                                      *
         * .                           .                                      *
         * . controle par ensemble     .                                      *
         * .                           .                                      *
         * . test d'unite              . <---1                                *
         * .                           .                                      *
         * . utilitaires               .                                      *
         * .............................                                      *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *      2                                                             *
         *      |                                                             *
         *      V                                                             *
         *  ----------------------------------------------------------------  *
         * | val:<cr>|exec:1|st/er:3|boucle:5|bavard:7|op:9|fin:0|brk:<del> | *
         *  ----------------------------------------------------------------  *
         *                                                                    *
          ********************************************************************

                                          | choix 1 et 2
                                          |
                                          V





























                                  - 12 -




          ********************************************************************
         *                                                                    *
         * version 01.00     SYSTEME DE TEST DU SPS9    Wed Jan 00:00:00 1986 *
         * ------------------------------------------------------------------ *
         * .............................                  ................... *
         * . controle de configuration .              1-->.>unite1          . *
         * .                           .              3-->. unite2          . *
         * . controle par ensemble     .                  . unite3          . *
         * .                           .                  . unite4          . *
         * . test d'unite              .                  . unite5          . *
         * .                           .                  . unite6          . *
         * . utilitaires               .                  . unite7          . *
         * .............................                  ................... *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *      2,4                                           5               *
         *      |                                             |               *
         *      V                                             V               *
         *  ----------------------------------------------------------------  *
         * | val:<cr>|effct:3|abort:5|                     |fin:0|brk:<del> | *
         *  ----------------------------------------------------------------  *
         *                                                                    *
          ********************************************************************

                                          | choix 1,2,3,4 et 5
                                          |
                                          V































                                  - 13 -




          ********************************************************************
         *                                                                    *
         * version 01.00     SYSTEME DE TEST DU SPS9    Wed Jan 00:00:00 1986 *
         * ------------------------------------------------------------------ *
         * .............................................. ................... *
         * . controle de configuration .                . . unite1 active   . *
         * .                           .                . . unite2 active   . *
         * . controle par ensemble     .                . . unite1 termine  . *
         * .                           .                . . unite2 errone   . *
         * . test d'unite              .    00:01:30    . .                 . *
         * .                           .                . .                 . *
         * . utilitaires               .                . .                 . *
         * .............................................. ................... *
         * .................................................................. *
         * .unit1: message operateur 1                                      . *
         * .unit2: message operateur 1                                      . *
         * .unit1: message operateur 2                                      . *
         * .unit2: message d'erreur 1                                       . *
         * .unit1: question operateur 1                                     . *
         * .>reponse 1                  <---3 (reponse donne a la question) . *
         * .................................................................. *
         *  ----------------------------------------------------------------  *
         * | val:<cr>|exec:1|st/er:3|boucle:5|bavard:7|op:9|fin:0|brk:<del> | *
         *  -------------^-----------------------^--------------------------  *
         *               |2                      |1                           *
          ********************************************************************

                                          | choix 1,2 et 3
                                          |
                                          V































                                  - 14 -




          ********************************************************************
         *                                                                    *
         * version 01.00     SYSTEME DE TEST DU SPS9    Wed Jan 00:05:12 1986 *
         * ------------------------------------------------------------------ *
         * .............................................. .....RESULTAT...... *
         * . controle de configuration .                . .unite2 errone:3er. *
         * .                           .                . .                 . *
         * . controle par ensemble     .                . .                 . *
         * .                           .                . .                 . *
         * . test d'unite              .    1 erreur    . .                 . *
         * .                           .                . .                 . *
         * . utilitaires    <---(appel menu 3)          . .                 . *
         * .............................................. ................... *
         * .................................................................. *
         * .unit1: message operateur 3                                      . *
         * .unit2: message d'erreur 2                                       . *
         * .unit2: message d'erreur 3                                       . *
         * .unit1: message operateur 4                                      . *
         * .                                                                . *
         * .                                                                . *
         * .................................................................. *
         *  ----------------------------------------------------------------  *
         * | val:<cr>|exec:1|st/er:3|boucle:5|bavard:7|op:9|fin:0|brk:<del> | *
         *  ----------------------------------------------------------------  *
         *                                                                    *
          ********************************************************************



































                                  - 15 -



       10.3  menu_3


          ********************************************************************
         *                                                                    *
         * version 01.00     SYSTEME DE TEST DU SPS9    Wed Jan 00:06:00 1986 *
         * ------------------------------------------------------------------ *
         * .............................................. ................... *
         * . fichier d'erreur          .<--1            . .*unite1          . *
         * .                           .              2-->. unite2          . *
         * . fichier parametre         .                . .*unite3          . *
         * .                           .                . .*unite4          . *
         * . erreur systeme            .    1 erreur    . .*unite5          . *
         * .                           .                . .*unite6          . *
         * .                           .                . .*unite7          . *
         * .............................................. ................... *
         * .................................................................. *
         * .unit1: message operateur 3                                      . *
         * .unit2: message d'erreur 2                                       . *
         * .unit2: message d'erreur 3                                       . *
         * .unit1: message operateur 4                                      . *
         * .                                                                . *
         * .                                                                . *
         * .................................................................. *
         *  ----------------------------------------------------------------  *
         * | val:<cr>|papier:3|                            |fin:0|brk:<del> | *
         *  ----^---------------------------------------------^-------------  *
         *      |3                                            |4              *
          ********************************************************************

                                          | choix 1,2,3 et 4
                                          |
                                          V





























                                  - 16 -




          ********************************************************************
         *#1 Wed Jan 00:02|00 1986                                            *
         * message d'erreur 1                                                 *
         *--------------------------------------------------------------------*
         *#2 Wed Jan 00:02:30 1986                                            *
         * message d'erreur 2                                                 *
         *--------------------------------------------------------------------*
         *#3 Wed Jan 00:03:45 1986                                            *
         * messge d'erreur 3                                                  *
         *--------------------------------------------------------------------*
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
         *                                                                    *
          ********************************************************************



































                                  - 17 -



       11.  ANNEXE_2

       11.1  entrees_de_terminfo

       STS utilise pour sa gestion du dialogue operateur les
       fonctionnalite de CURSES , le fichier de terminfo
       correspondant au type de console utilise doit contenir en
       plus des valeurs standart, les entrees suivantes:
       blink, rev, dim, is3, srg0, rmso, civis, cnorm.


       exemple pour les televideo 950:
       le fichier /usr/lib/terminfo/televideo.ti doit contenir:
         - blink=EG2
         - rev=EG4
         - dim=E)
         - is3=Eh  (affichage de la ligne status)
         - srgr0=E(EG0
         - rmso=EG0
         - civis=E.0
         - cnorm=E.2

       televideo.ti se compile par: tic televideo.ti.







































                                  - 18 -



                        =======================
                        3 - LE  NOYAU  DE  TEST
                        =======================

       Redaction ulterieure.






















































