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

⟦d63916bcb⟧ Wang Wps File

    Length: 15907 (0x3e23)
    Types: Wang Wps File
    Notes: FIX/1161/PSP/0045         
    Names: »4869A «

Derivation

└─⟦c7fef4850⟧ Bits:30006144 8" Wang WCS floppy, CR 0418A
    └─ ⟦this⟧ »4869A « 

WangText

!…00……00……00……00…(…0a……00……00…(…0b…(…0d…(…0f…(…07……86…1                                             …02…           …02…   …02…   

     4869A/aml…02…FIX/1161/PSP/0045

DRP SUBSYSTEM PSP…02…MLA/840501…02……02…#

…02……02… FK7809














                 FIKS
                 DRP SUBSYSTEM PSP



                 FIX/1161/PSP/0045













                 Morten Lange




                 Ole Eskedal







                 AMC (6), LOL, APE, REV, LU
















                          …0e…ILS Manager.    840501

                          S/W Manager     840501
             1             
                          Conf. Manager   840501…0f…

             840501





    4869A/aml…02… FIX/1161/PSP/0045

…02… MLA/840501…02……02… ii
DRP SUBSYSTEM PSP
…02……02… FK7809 


















        840501                  All      Original issue of Document







    4869A/aml…02… FIX/1161/PSP/0045

…02… MLA/840501…02……02…iii
DRP SUBSYSTEM PSP
…02……02… FK7809 







                    T̲A̲B̲L̲E̲ ̲O̲F̲ ̲C̲O̲N̲T̲E̲N̲T̲S̲



     1  SCOPE .......................................  
      1
       1.1 INTRODUCTION .............................  
            1
       1.2 ABBREVIATIONS ............................  
            1

     2  APPLICABLE DOCUMENTS ........................  
      2
     3  MODULE SPECIFICATION ........................  
      3
       3.1 FUNCTIONAL CAPABILITIES ..................  
            3
         3.1.1 DRP Main .............................  
                3
         3.1.2 MTCBMINIT ............................  
                3
         3.1.3 GETCMD ...............................  
                3
         3.1.4 INIT ̲FRD ̲VDU .........................  
                4
         3.1.5 VDUIO ................................  
                4
         3.1.6 GEN ̲FRT ̲TABLE ........................  
                4
         3.1.7 INSERT ̲MTCB ..........................  
                5
         3.1.8 INSERT ̲QE ............................  
                5
         3.1.9 DISPLAY ̲ERR ..........................  
                5

       3.2 INTERFACE DESCRIPTION ....................  
            6
         3.2.1 DRP Main .............................  
                6
           3.2.1.1 Internal Interface ...............  
                    6
           3.2.1.2 External Interface ...............  
                    7

         3.2.2 MTCBINIT .............................  
                8
           3.2.2.1 Internal Interface ...............  
                    8
           3.2.2.2 External Interface ...............  
                    8

         3.2.3 GETCMD ...............................  
                8
           3.2.3.1 Internal Interface ...............  
            8
           3.2.3.2 External Interface ...............  
                    9

         3.2.4 INIT ̲FRD ̲VDU .........................  
                9
           3.2.4.1 Internal Interface ...............  
                    9
           3.2.4.2 External Interface ...............  
                    9




    4869A/aml…02… FIX/1161/PSP/0045

…02… MLA/840501…02……02… iv
DRP SUBSYSTEM PSP
…02……02… FK7809 







         3.2.5 VDUIO ................................  
               10
           3.2.5.1 Interface Description ............  
                   10
           3.2.5.2 External Interface ...............  
                   10

         3.2.6 GEN ̲FRT ̲TABLE ........................  
               11
           3.2.6.1 Internal Interface ...............  
                   11

         3.2.7 INSERT ̲MTCB ..........................  
               12
           3.2.7.1 Internal Interface ...............  
                   12
           3.2.7.2 External Interface ...............  
                   12

         3.2.8 INSERT QE ............................  
               13
           3.2.8.1 Internal Interface ...............  
                   13
           3.2.8.2 External Interface ...............  
                   13

         3.2.9 DISPLAY ̲ERR ..........................  
               14
           3.2.9.1 Internal Interface ...............  
                   14

       3.3 PROCESSING ...............................  
           14
       3.4 DATA ORGANIZATION ........................  
           14
       3.5 STORAGE ALLOCATION .......................  
           14
       3.6 PERFORMANCE CHARACTERISTICS ..............  
           15
       3.7 LIMITATIONS ..............................  
           15
       3.8 ERROR CODES ..............................  
           15
       3.9 LISTING REFERENCES .......................  
           15

     4  QUALITY ASSURANCE ...........................  
     16
       4.1 QUALIFICATION TESTS ......................  
           16
       4.2 OTHER QUALITY ASSURANCE PROVISIONS .......  
           16

     5  PREPARATION FOR DELIVERY ....................  
     17
     6  NOTES .......................................  
     18
     7  FLOW CHARTS .................................  
     19


                         1  S̲C̲O̲P̲E̲

         This document describes the function of the DRP Subsystem.



1.1      I̲N̲T̲R̲O̲D̲U̲C̲T̲I̲O̲N̲

         The purpose of the DRP Subsystem is to display the
         routing table and to support the operator in changing
         the delay table for generating a new routing table.



1.2      A̲B̲B̲R̲E̲V̲I̲A̲T̲I̲O̲N̲S̲

         Please refer to

         FIKS Data I/F Reference,
         FIX/0100/MAN/0004





                 2  A̲P̲P̲L̲I̲C̲A̲B̲L̲E̲ ̲D̲O̲C̲U̲M̲E̲N̲T̲S̲

         1.  FIKS Data I/F Reference
             FIX/0100/MAN/0004

         2.  SCCM Subsystem PSP
             FIX/1266/PSP/0084

         3.  INTASC Monitor PSP
             FIX/1256/PSP/0052

         4.  STAMON Monitor PSP
             FIX/1266/PSP/0106

         5.  GET ̲DTG Monitor PSP
             FIX/1256/PSP/0050

         6.  MTCB Monitor PSP
             FIX/1252/PSP/0066

         7.  RCP Subsystem PSP
             FIX/1161/PSP/0080

         8.  FIKS FILE generator PSP
             FIX/1200/PSP/0042

         9.  Background I/F PSP
             FIX/1364/PSP/0101

         10. ESP System PSP
             FIX/1105/PSP/0046

         11. SCCLDD
             FIX/1000/EWP/0080




                 3  M̲O̲D̲U̲L̲E̲ ̲S̲P̲E̲C̲I̲F̲I̲C̲A̲T̲I̲O̲N̲



3.1      F̲U̲N̲C̲T̲I̲O̲N̲A̲L̲ ̲C̲A̲P̲A̲B̲I̲L̲I̲T̲I̲E̲S̲



3.1.1    D̲R̲P̲ ̲M̲a̲i̲n̲

         The DRP process will be activated when one of the two
         following commands:

             DDU
             DRT

         are entered at one of the terminals at the SCC.

         When the DDU command is entered the delay table will
         be displayed and the operator will be guided in changing
         the table.  After changing, a new routing table is
         generated and displayed for accept.  If the operator
         accepts this new routing table it will be released
         as the new routing table, else it will be deleted.

         When the DRT command is entered the routing table will
         be displayed.

         When the command is processed a log will be made. 
         This log will include the command, where and when.



3.1.2    M̲T̲C̲B̲M̲I̲N̲I̲T̲

         The MTCBMINIT procedure gets the file descriptors for
         the system volumes (MOVHEAD and FIXHEAD) and initiates
         the MTCB Monitor.



3.1.3    G̲E̲T̲C̲M̲D̲

         In the GETCMD procedure the DRP process will wait for
         an operator command.





3.1.4    I̲N̲I̲T̲ ̲F̲R̲D̲ ̲V̲D̲U̲

         The INIT ̲FRD ̲VDU procedure will display the delay table
         on the VDU.

         The format will be:

         DELAY TO:…02…A:       B:  .  .            Q:
         F̲R̲O̲M̲:̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲

            A:            010     010  .  .   010
            B:            200     010  .  .   010
            .              .       .   .  .    .
            .              .       .   .  .    .
            Q:            010     005  .  .   010

         The numbers will be delay values e.g. the delay value
         from A to B will be 10 items.



3.1.5    V̲D̲U̲I̲O̲

         The VDUIO procedure is used to input and output data
         from and to the VDU.



3.1.6    G̲E̲N̲ ̲F̲R̲T̲ ̲T̲A̲B̲L̲E̲


         The GEN ̲FRT ̲TABLE procedure will display the routing
         table on the VDU.

         The format will be:

         ROUTE TO:…02…A:       B:  .  .            Q:
         F̲R̲O̲M̲:̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲P̲S̲T̲ ̲ ̲ ̲ ̲ ̲P̲S̲T̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲P̲S̲T̲

            A:            ---     BN-  .  .   KN-
            B:            AN-     ---  .  .   ANL
            .              .       .   .  .    .
            .              .       .   .  .    .
            Q:            K--     K--  .  .   ---

         This means that if B has to send a message to A, first
         it will try to send it directly to A.  If B cannot
         do this it will try to send it via N.





3.1.7    I̲N̲S̲E̲R̲T̲ ̲M̲T̲C̲B̲

         The INSERT ̲MTCB procedure creates a MTCB and updates
         it with the content of a buffer.



3.1.8    I̲N̲S̲E̲R̲T̲ ̲Q̲E̲

         The INSERT ̲QE procedure inserts a queue element into
         a specified queue.

         Usecount of the MTCB referenced by the queue is unchanged.



3.1.9    D̲I̲S̲P̲L̲A̲Y̲ ̲E̲R̲R̲


         The DISPLAY ̲ERR procedure will display error codes
         to the operator in case of Syntax- or semantic errors.
          The error code will be displayed on the last line
         but 3.





3.2      I̲N̲T̲E̲R̲F̲A̲C̲E̲ ̲D̲E̲S̲C̲R̲I̲P̲T̲I̲O̲N̲



3.2.1    D̲R̲P̲ ̲M̲a̲i̲n̲



3.2.1.1  I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The DRP main procedure is invoked by:

         ESP                                        Ref. PSP/0046

         Output from DRP main procedure is:

         -   Delay table displayed
         -   Routing table displayed
         -   Delay table updated
         -   Routing table updated

         The DRP procedure interfaces to the following procedures:

         MTCBMINIT                                  Ref. 3.1.2
         Initiates the MTCB Monitor.

         GETCMD                                     Ref. 3.1.3
         Reads the operator command

         INIT ̲FRD ̲VDU                               Ref. 3.1.4
         Displays the delay table

         VDUIO                                      Ref. 3.1.5
         Input/output procedure to the VDU

         GEN ̲FRT ̲TABLE                              Ref. 3.1.6
         Displays the routing table

         INSERT ̲MTCB                                Ref. 3.1.7
         Creates and updates a MTCB for logging

         INSERT ̲QE                                  Ref. 3.1.8
         Inserts the log MTCB in EC queue

         DISPLAY ̲ERR                                Ref. 3.1.9
         Issues error codes to the operator





3.2.1.2  E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The DRP main procedure interfaces to the following
         monitor procedures:

         MON STA
         Accesses the regions FRD and FRT.

         MON SCCM
         Converts a Node/Mede id from an ASCII char to the binary
         value.

         MON INTASC
         Converts a three digit ASCII number to an integer.

         MON SENDSIGNAL
         Sends a signal to the RCP process indicating new routing
         tables to be released.

         MON GETDTG
         Reads System time for logging.

         MON TERMINATE
         Terminates the process in case of fatal errors.

         MON SENDMESSAGE
         Invokes the RCP process requesting a new routing table.

         MON AWAITANSWER
         Receives an answer from the RCP process indicating
         that the new routing table is generated.





3.2.2    M̲T̲C̲B̲I̲N̲I̲T̲



3.2.2.1  I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The MTCBMINIT procedure is invoked by:

         DRP main                                   Ref. 3.1.1

         Output from MTCBMINIT procedure is:

         -   file descriptor for MOVHEAD
         -   file descriptor for FIXHEAD
         -   MTCB work area initiated
         -   completion code



3.2.2.2  E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The MTCBMINIT procedure interfaces to the following
         monitor procedures:

         MON IO GETROOT
         Gets the file descriptors for MOVHEAD and FIXHEAD

         MON MTCB INITE
         Initiates the MTCB work area.



3.2.3    G̲E̲T̲C̲M̲D̲



3.2.3.1  I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The GETCMD procedure is invoked by:

         DRP main                                   Ref. 3.1.1

         Input to GETCMD procedure is:

         -   Ref. to VDUCB

         Output from GETCMD procedure is:

         -   VDUCB updated according to operator cmd.
         -   completion code





3.2.3.2  E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The GETCMD procedure interfaces to the following monitor
         procedure:

         MON SCCM GET ̲CMD

         Gets the operator cmd.



3.2.4    I̲N̲I̲T̲ ̲F̲R̲D̲ ̲V̲D̲U̲
         



3.2.4.1  I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The INIT ̲FRD ̲VDU procedure is invoked by:

         DRP main                                   Ref. 3.1.1

         Input to the INIT ̲FRD ̲VDU procedure is:

         -   VDUCB
         -   FRD table in local buffer

         Output from the INIT ̲FRD ̲VDU procedure is:

         -   Delay table displayed
         -   Completion code

         The INIT ̲FRD ̲VDU procedure interfaces the following
         procedures:

         VDUIO                                      Ref. 3.1.5
         General output procedure



3.2.4.2  E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The INIT ̲FRD ̲VDU procedure interfaces the following
         monitor procedures:

         MON INTASC
         Converts the contents of the FRD buffer to ASCII strings.





3.2.5    V̲D̲U̲I̲O̲



3.2.5.1  I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         The VDUIO procedure is invoked by:

         DRP main                                   Ref. 3.1.1
         INIT ̲FRD ̲VDU                               Ref. 3.1.4
         GEN ̲FRT ̲TABLE                              Ref. 3.1.6
         DISPLAY ̲ERR                                Ref. 3.1.9

         Input to the VDUIO procedure is:

         -   Ref. to VDUCB

         Output from the VDUIO procedure is:

         -   VDUCB updated
         -   completion code



3.2.5.2  E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The VDUIO procedure interfaces to the following monitor
         procedure:

         MON SCCM VDU ̲IO
         inputs/outputs data from/to the VDU





3.2.6    G̲E̲N̲ ̲F̲R̲T̲ ̲T̲A̲B̲L̲E̲



3.2.6.1  I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The GEN ̲FRT ̲TABLE procedure is invoked by:

         DRP main                                   Ref. 3.1.1

         Input to the GEN ̲FRT ̲TABLE procedure is:

         -   VDUCB
         -   FRD table in local buffer

         Output from the GEN ̲FRT ̲TABLE procedure is:

         -   Routing table displayed
         -   Completion code


         The GEN ̲FRT ̲TABLE procedure interfaces the following
         procedures:

         VDUIO                                      Ref. 3.1.5
         General output procedure





3.2.7    I̲N̲S̲E̲R̲T̲ ̲M̲T̲C̲B̲
         



3.2.7.1  I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The INSERT ̲MTCB procedure is invoked by:

         DRP main                                   Ref. 3.1.1

         Input to the INSERT ̲MTCB procedure is:

         -   MTCB index
         -   MTCB buffer

         output from INSERT ̲MTCB procedure is:

         -   MTCB updated
         -   completion code



3.2.7.2  E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The INSERT ̲MTCB procedure interfaces to the following
         monitor procedures:

         MON SCCM WR ̲MTCB
         Updates the MTCB.





3.2.8    I̲N̲S̲E̲R̲T̲ ̲Q̲E̲



3.2.8.1  I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The INSERT ̲QE procedure is invoked by:

         DRP main                                   Ref. 3.1.1

         Input to the INSERT ̲MTCB procedure is:

         -   Terminal No.
         -   Queue No.
         -   MTCB index

         Output from INSERT ̲QE procedure is:

         -   completion code



3.2.8.2  E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The INSERT ̲QE procedure is interfacing to the following
         monitor procedure:

         MON SCCM INS ̲QE

         Inserts an entry in a specified queue.





3.2.9    D̲I̲S̲P̲L̲A̲Y̲ ̲E̲R̲R̲



3.2.9.1  I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The DISPLAY-ERR procedure is invoked by:

         DRP main                                   Ref. 3.1.1

         Input to DISPLAY ̲ERR procedure is:

         -   error code
         -   ref. to VDUCB

         Output from DISPLAY ̲ERR procedure is:

         -   error code on screen

         The DISPLAY ̲ERR procedure interfaces to the following
         procedure:


         VDUIO                                      Ref. 3.1.5

         Outputs the error code to the terminal.



3.3      P̲R̲O̲C̲E̲S̲S̲I̲N̲G̲

         The processing will be described by means of the flow-charts
         in section 7.



3.4      D̲A̲T̲A̲ ̲O̲R̲G̲A̲N̲I̲Z̲A̲T̲I̲O̲N̲

         Please refer to source listing.



3.5      S̲T̲O̲R̲A̲G̲E̲ ̲A̲L̲L̲O̲C̲A̲T̲I̲O̲N̲

         Please refer to the SCCLDD document.





3.6      P̲E̲R̲F̲O̲R̲M̲A̲N̲C̲E̲ ̲C̲H̲A̲R̲A̲C̲T̲E̲R̲I̲S̲T̲I̲C̲S̲

         N/A



3.7      L̲I̲M̲I̲T̲A̲T̲I̲O̲N̲S̲

         N/A



3.8      E̲R̲R̲O̲R̲ ̲C̲O̲D̲E̲S̲

         Please refer to the error codes listed in the source
         listing.



3.9      L̲I̲S̲T̲I̲N̲G̲ ̲R̲E̲F̲E̲R̲E̲N̲C̲E̲S̲

         Please refer to the SCCLDD document.





                   4  Q̲U̲A̲L̲I̲T̲Y̲ ̲A̲S̲S̲U̲R̲A̲N̲C̲E̲



4.1      Q̲U̲A̲L̲I̲F̲I̲C̲A̲T̲I̲O̲N̲ ̲T̲E̲S̲T̲S̲

         Please refer to

         System Test Report S050  FIX/0000/TPR/0081



4.2      O̲T̲H̲E̲R̲ ̲Q̲U̲A̲L̲I̲T̲Y̲ ̲A̲S̲S̲U̲R̲A̲N̲C̲E̲ ̲P̲R̲O̲V̲I̲S̲I̲O̲N̲S̲

         N/A





               5  P̲R̲E̲P̲A̲R̲A̲T̲I̲O̲N̲ ̲F̲O̲R̲ ̲D̲E̲L̲I̲V̲E̲R̲Y̲

         The following procedures will not be in the DRP directory
         at the FIXLIB volume:

         -   MTCBMINIT
         -   GETCMD
         -   VDUIO
         -   INSERT ̲MTCB
         -   INSERT ̲QE

         as they are common procedures shared with other operator
         interfacing processes.

         The procedures will be located in:

             FIXLIB SCCNAMES directory

         The GETCMD and VDUIO procedures are part of the file
         VDUIO.

         The INSERT ̲MTCB and INSERT ̲QE procedures are part of
         the file IO.





                         6  N̲O̲T̲E̲S̲

         N/A





                      7  F̲L̲O̲W̲ ̲C̲H̲A̲R̲T̲S̲