DataMuseum.dk

Presents historical artifacts from the history of:

CR80 Wang WCS documentation floppies

This is an automatic "excavation" of a thematic subset of
artifacts from Datamuseum.dk's BitArchive.

See our Wiki for more about CR80 Wang WCS documentation floppies

Excavated with: AutoArchaeologist - Free & Open Source Software.


top - download

⟦6f389fc8e⟧ Wang Wps File

    Length: 9065 (0x2369)
    Types: Wang Wps File
    Notes: PC/AUX/003                
    Names: »3369A «

Derivation

└─⟦f6f93b0e6⟧ Bits:30006245 8" Wang WCS floppy, CR 0245A
    └─ ⟦this⟧ »3369A « 

WangText

…00……00……86…1                                             …02…          …02…   …02…        
…0e…
…02…PC/AUX/003 

…02…KPL/830530…02……02…#
PC SW CONFIGURATION MNGMT      
…02…KPL/830527     PC






1.       F̲o̲r̲m̲>̲l̲

1.1      -   at im]dekomme CR QA's krav til SW kvalitetsstyring.

1.2      -   at etablere et PC software bibliotek, der letter
             det daglige brug af SW udviklingssystemet, n>r
             f̲l̲e̲r̲e̲ udvikler SW s̲a̲m̲t̲i̲d̲i̲g̲t̲.̲ Dette t`nkes gennemf]rt
             med en fast standard for:

                 - opbygning og protection af directories

                 - filnavnes udformning

1.3      -   at anvise e̲e̲n̲ standard for "source code lay-out".

1.4      -   at etablere en ugentlig back-up procedure

1.5      -   at definere hvordan CR80 software afleveres til
             "PC library"

1.6      -   at opfylde kravene til unit testing af SW



2.       L̲i̲t̲t̲e̲r̲a̲t̲u̲r̲

2.1      PAD/MIN/042, kvalitetsstyring og opfyldelse af AQAP
         1
         og 13 p> PC

2.2      PDS/003/STD/003, Directory Structure and File Name
         Standard

2.3      CSD/006/SPP/0600 SWELL Programming Standard

2.4      SD/STD/012, Software Verification Standard

2.5      PAD/PRC/0007, Completed Item Inspection and Testing.

2.6      CSS/150/USM/0073 CR80 AMOS, BACK-UP/COMPARE, USER's
         MANUAL.


         A̲p̲p̲e̲n̲d̲i̲c̲e̲s̲

         A.  Side 2-3 fra AQAP 13 vedr. Conf. Mngmt.

         B.  Directory Structure

         C.  Source Code Lay-out 

         D.  Release Description

         E.  Module Header Lay-out

         F.  Indhold af "Test Specification" samt "Test Procedure
             and Report".







3.       B̲E̲S̲K̲R̲I̲V̲E̲L̲S̲E̲

3.1      K̲v̲a̲l̲i̲t̲e̲t̲s̲s̲t̲y̲r̲i̲n̲g̲s̲k̲r̲a̲v̲

         PC projektet er kontraktligt forpligtet til at overholde
         NATO's SW kvalitetskontrolkrav angivet i AQAP1 og AQAP13.

         Iflg. CRQA im]dekommes disse krav, hvis man f]lger
         tilsvarende firmastandarder, angivet i Reference 2.1,
         PAD/MIN/042.

         Disse standarder er imidlertid ikke entydige. Derfor
         er de vigtigste krav angivet her.

         Appendix A viser en side fra AQAP13 med kravene til
         Configuration Management.

3.2      D̲i̲r̲e̲c̲t̲o̲r̲y̲ ̲S̲t̲r̲u̲c̲t̲u̲r̲e̲

         a)  PC software skal kunne udvikles parallelt af flere
             programm]rer p> een gang. Derfor anvendes versions
             directories efter flg. retningslinjer:

             N>r en source fil svarende til et modul er blevet
             f`rdiggjort eller rettet, overf]res denne til flg.
             directory:

              **PC.D* package ̲name .D* module ̲name .D*VXXYY.D

         Module ̲name er defineret af programm]ren. Husk at et
         modul h]jst m> indeholde 250 statements.

         VXXYY.D er et versions directory for det p>g`ldende
         modul, XX=version, YY=release, begge startende med
         nr.01.

         I dette directory skal endvidere findes flg. filer:

             1.  COMPILE.J
             2.   module ̲name .S
             3.   module ̲name .P
             4.   module ̲name .L
             5.  HEAD.S





         COMPILE.J foretager en compilering af  module ̲name
         .S med output i  module ̲name .L og listning i  module
         ̲name .P.
          module ̲name .S indeholder bl.a. alle %SOURCE statements.
         Den f]rste file, der skal indflettes er HEAD.S, der
         indeholder en "module header". Standard layout'et for
         headeren findes i  **PC.D*PREFIX.D*TOOLS.D*MOD ̲HEAD.T.
         
         Et eksempel findes i Appendix E.

         Som underdirectories til  package ̲name .D findes foruden
         directories af typen  module ̲name .D f]lgende directories:

                 PREFIX.D
                 LINK.D
                 TEST.D                (beskrevet i afsnit 3.5)

         Prefix directory indeholder ligesom module directories
         version directories. Et version directory indeholder
         to filer:

                  PREFIX.S
                  HEAD.S

         Prefix filen skal source header filen.

         Link directory indeholder ogs> version directories.
         Et version directory indeholder:

                  package ̲name .RL         release description
                 LINK.J                    jobfile for linkning
                 LINK.T                    link parameters
                  package ̲name .C          output fra linker
                  package ̲name .LP         printfile fra linker

          package ̲name .RL indeholder en release description
         for den p>g`ldende pakke. Formatet for denne fil kan
         f>s fra 
          **PC.D*PREFIX.D*TOOLS.D*REL ̲DESCR.T og er vist i Appendix
         D.

         LINK.J indeholder: LINK COM: LINK.T.



         b)  Syntax for filnavne er:

              file navne ::=  identifier .  qualifier

              identifier  er op til 14 karakterer e.g.CI ̲READ
             ̲CMD

              qualifier  er angivet nedenfor


          ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
         ̲ ̲ ̲ ̲ ̲

          qualifier                 use
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲
          D                         Directory
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲
          S                         Source Code
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲
          M                         Merged Source
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲                     C                            Code
                                                                 (Object
                                                                 from
                                                                 linker)
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲
          B                         Binary Object
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲
          P                         Compiler Print File
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲                     T                            Text
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲                     H                            Hexadecimal
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲
          I                         Import Prefix
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲
          L                         Link Module (to linker)
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲
          J                         Job Command File
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲
          LP                        Link Print
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲                     RL                           Release
                                                                 Description
         ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
        ̲ ̲ ̲ ̲ ̲ ̲ ̲

        E.g.: CI ̲READ ̲CMD.L er et submodule, der bruges som
                                                                 
                                                                 
                                                                 
                                                                 
                                                                 input
                                                                 til
                                                                 linker'en.



3.2.1    B̲r̲u̲g̲ ̲a̲f̲ ̲V̲e̲r̲s̲i̲o̲n̲ ̲D̲i̲r̲e̲c̲t̲o̲r̲i̲e̲s̲

         Version t`lles op, n>r der er tale om funktionelle
         `ndringer.

         Release t`lles op, n>r der foretages fejlrettelser
         eller hvis en ny version/release af en prefix fil skal
         anvendes.

         Hvis version `ndres for et modul eller et prefix skal
         version for en package, der inkluderer modulet eller
         prefixet, `ndres.

         N>r version `ndres skal release s`ttes til 1.

3.3      S̲W̲E̲L̲L̲ ̲K̲o̲d̲e̲ ̲L̲a̲y̲o̲u̲t̲

         Se Reference 2.3. og Appendix C. SWELL statements skrives
         med store bogstaver, mens kommantarer skrives med sm>.
         Det anbefales at bruge indentering, som er et multiplum
         af 2 karakterer.

3.4      B̲a̲c̲k̲-̲U̲p̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲

3.4.1    C̲R̲8̲0̲ ̲S̲o̲f̲t̲w̲a̲r̲e̲

         Der foretages en ugentlig back-up af udviklingssystemets
         SMD80 disk. Software under konfigurationskontrol overf]res
         til en s`rlig disk, som kopieres efter behov. Se Reference
         2.6.

3.4.2    L̲T̲U̲ ̲S̲o̲f̲t̲w̲a̲r̲e̲

         Back-up foretages ugentligt i afdeling DD-GDD.

3.5      A̲f̲l̲e̲v̲e̲r̲i̲n̲g̲ ̲a̲f̲ ̲S̲W̲ ̲t̲i̲l̲ ̲P̲C̲ ̲l̲i̲b̲r̲a̲r̲y̲

3.5.1    C̲R̲8̲0̲ ̲S̲o̲f̲t̲w̲a̲r̲e̲

         Moduler forsynes med modulheader, som opdateres l]bende.
         Modulheaderen kan hentes fra
          **PC.D*PREFIX.D*TOOLS.D*MOD ̲HEAD.T og er vist i Appendix
         E.

         Source tekst h]rende til et modul b]r v`re tilg`ngelig
         under det p>g`ldende moduls versions directory.

         For et package prefix erstattes ordet "MODULE" med
         "PREFIX" i filen 
          package ̲name .D*PREFIX.D*VXXYY.D*HEAD.S.


         Der afleveres en A4 kopi af f]lgende filer:

                  package ̲name .RL
                  module ̲name1 .D*HEAD.S
                  module ̲name2 .D*HEAD.S
                         .
                         .

         Disse afleveres samlet ved hver opdatering af et modul
         for derved at fungere som log over version/releases
         for den p>g`ldende package.

         Endvidere afleveres en "PC Unit Test Procedure and
         Report", som beskrevet i afsnit 3.6.

         Hvert  package ̲name  directory b]r endvidere indeholde
         et directory, TEST.D.

         TEST.D skal indeholde en textfil ved navn TEST ̲SPEC.T
         med en entydig trin for trin beskrivelse af hvordan
         den p>g`ldende package klarg]res til unit testing.
         Se Appendix F, pkt. 5.2.

         S>fremt der anvendes specielle test drivers skal koden
         for disse ligeledes v`re tilg`ngelig under TEST.D.

         CR80 utilities, operativsystem samt H/W til brug under
         testen skal ligeledes identificeres i TEST ̲SPEC.T.
         
         Se Reference 2.5, s. 7!

3.5.2    L̲T̲U̲ ̲S̲o̲f̲t̲w̲a̲r̲e̲

         Der kr`ves filer ganske svarende til de under pkt.
         3.5.1 beskrevne. Directory strukturen kan dog fraviges,
         hvis det her anvendte PDP filsystem kr`ver det.

3.6      U̲n̲i̲t̲ ̲T̲e̲s̲t̲

         Denne test beskrives i et s`rskilt dokument for hver
         package: "PC Unit Test Procedure and Report".

         Dette dokument beskriver i korthed:

         o   testomgivelser, HW & SW

         o   test inputs og resultater



         Test resultaterne verificeres ved sammenligning med
         de relevante afsnit fra PC Package Design Specification.
         

         Dokumentet fungerer samtidig som test rapport, idet
         en hardcopy m̲e̲d̲ ̲l̲e̲d̲s̲a̲g̲e̲n̲d̲e̲ ̲f̲o̲r̲k̲l̲a̲r̲i̲n̲g̲ vedl`gges som
         appendix.

         Der anvendes f]lgende indholdsfortegnelse til "PC Unit
         Test Procedure and Report":

         1.  Identification of Test Item 
             (Version/Release)

         2.  Test Environment

         2.1 Hardware Configuration
         2.2 Support Software

         3.  Detailed Operations & Expected Results

         4.  Conclusion

         Appendix: Commented Hardcopy of Test Output