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

⟦29033a1fd⟧ Wang Wps File

    Length: 7323 (0x1c9b)
    Types: Wang Wps File
    Notes: FIX/1256/PSP/0048         
    Names: »3859A «

Derivation

└─⟦3b8d69e90⟧ Bits:30005794 8" Wang WCS Floppy ( A0306A )
    └─ ⟦this⟧ »3859A « 

WangText




3859A/rt…02…FIX/1256/PSP/0048

…02…OK/830708…02……02…#
FILL ̲MTCB
 MONITOR
 PSP
…02……02… FIKS












…0f…
                 FILL ̲MTCB MONITOR PSP



                 FIX/1256/PSP/0048














                 Ove Kaastrup




                 Carl H]gstedt







                 AMC   (6)
                 CR    (3)
                 FILE  (2)














                          FIKS Manager    830708


         1



         830708…0e…




3859A/rt                                     FIX/1256/PSP/0048

 …02… OK/830708…02……02…i
FILL ̲MTCB MONITOR PSP
…02……02… FIKS 












       830708                  All      Issue 1 of Document




…0f…3859A/rt…02… FIX/1256/PSP/0048

FILL ̲MTCB MONITOR PSP …02… OK/830708…02……02…ii

…02……02… FIKS…0e…





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


    1.  SCOPE ....................................... 
         01
      1.1 INTROCUTION ............................... 
           01
      1.2 ABBREVIATIONS ............................. 
           01

    2.  APPLICABLE DOCUMENTS ........................ 
         02

    3.  MODULE SPECIFICATIONS ....................... 
         03
      3.1 FUNCTIONAL CAPABILITIES ................... 
           03
      3.2 INTERFACE DESCRIPTION ..................... 
           03
      3.3 PROCESSING ................................ 
           04
      3.4 DATA ORGANIZATION ......................... 
           06
      3.5 STORAGE ALLOCATION ........................ 
           10
      3.6 PERFORMANCE CHARACTERISTICS ............... 
           10
      3.7 LIMITATION ................................ 
           10
      3.8 ERROR CODES/ERROR LOCATIONS ............... 
           10
      3.9 LISTING REFERENCES ........................ 
           10

    4.  QUALITY ASSURANCE ........................... 
         11

    5.  PREPARATIONS FOR DELIVERY ................... 
         11


                         1̲ ̲ ̲S̲C̲O̲P̲E̲

         This document contains a product specification including
         interface description for the monitor procedure FILL
         ̲MTCB.



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

         This procedure is used by NSS subsystem to extract
         header information from messages arriving to the node.
         The information extracted is unpacked and placed in
         a work area. MON MTCB, WRITE is called to transfer
         the data to a real or a pseudo in TCB.

         The messages in question are

         1)  Narrative messages (data is transferred to a real
             MTCB)
         2)  Control messages (data is transferred to a pseudo
             MTCB)
         3)  ACK/NACK messages (data is transferred to a pseudo
             MTCB)


         When calling the monitor a MTCB must be present and
         the header of the message in question must be in memory.
         Information to the monitor is delivered in a work area
         of 4 words, describing the index of the MTCB to be
         filled, the message type, the offset to the binary
         header of the message and an offset to a work area
         available for the monitor procedure.

         When exiting the monitor procedure the MTCB is updated.



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

         Please refer to ref. I, chapt 1.2


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



   I:    FIX/0100/MAN/0004      FIKS DATA I/F REF.

   II:   FIX/1256/PSP/0066      MTCB MONITOR PSP

   III:  FIX/1000/EWP/0080      FIKS S/W CONF.CTRL.LIB.DESCR.DOC


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



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

         Ref. chapt. 1.1



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

         MON FILLMTCB

         Register use at:

             CALL                           RETURN

         6   ref (work-area)                ref (work-area)
         7   link                           completion code

         Return points:

         OK: link + 1
         error: link + 0

         The completion code is 0, if exit is ok.

         Exit in error occurs, when WRITE ̲MTCB returns with
         error. See error codes for WRITE ̲MTCB in Data I/F
         Ref., table 2-7.


         Work area:  (4 words)

                 WORD0:       ref. MTCB index
                 WORD1:       Message type (0 = narrative, 1
                              = control (except ACK/NACK), 2
                              = ACK/NACK)
                 WORD2        ref. binary header of message
                 WORD3        ref. work area of 21 words (13
                              words for MTCB, WRITE call + 8
                              words for register save)


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

         Fig. 3.1 shows the flow chart of FILL ̲MTCB.

         Main events are:

         MTCB index, message type, offset to binary header and
         offset to work area is read from the input buffer.
         The input registers are saved (1). If the message is
         of type narrative or control the binary header is read
         and data is transferred to the MTCB block in the work
         area (2,3)

         If the message is of type:

             Narrative:       The remaining data is copied from
                              binary header to the MTCB block.
                              (CLASS, address list offset, info
                              precedence).
                              The update code to be used when
                              calling MTCB, WRITE is set (4)

             CONTROL:         The update code to be used when
                              calling MTCB, WRITE is set (5)

             ACK/NACK:        The binary header of the message
                              is read and data is transferred
                              to the pseudo MTCB block in the
                              work area. The update code to
                              be used when calling MTCB, WRITE
                              is set (6).

             MTCB, WRITE is called. If error, the registers
             are reestablished, the error code is set and the
             procedure is exited.

             If no errors, the registers are reestablished,
             the completion code is set to zero and the procedure
             is exited in link 1.




                          figure


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

         W̲o̲r̲k̲ ̲a̲r̲e̲a̲:̲

         When calling the procedure a work area of 21 words
         is delivered. Word 0 - 12 is used to build the pseudo
         or real MTCB; read 13 - 20 is used to store registers.



         T̲r̲a̲n̲s̲f̲e̲r̲ ̲o̲f̲ ̲d̲a̲t̲a̲:̲

         Information is moved from the incore binary header
         to the MTCB (using WRITEMTCB) in the following 3 different
         ways: (see the following figures)










                          figure












                          figure












                          figure


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

         Program size:        114 words
         Process size:        none



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̲  

         None



3.8      E̲R̲R̲O̲R̲ ̲C̲O̲D̲E̲S̲/̲E̲R̲R̲O̲R̲ ̲L̲O̲C̲A̲T̲I̲O̲N̲S̲

         Error codes at call of MTCB, WRITE are returned to
         the user. A list of MTCB error codes is found in ref.
         II.



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

         Please refer to chapt. 5.


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



         N/A









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



         Command files used at generation of the object code
         file can be found in FIXLIB source directory (ref.
         III).

         Generation of object code file:


         o   Copy the source directory of the actual version
             into a work directory.

         o   Activate the command file FILL ̲MTCB.CR

         o   Activate the command file FILL ̲MTCB.CP

         o   Activate the command file FILL ̲MTCB.L[


         The code ready for installation is now available in
         the file FILL ̲MTCB.C.



         L̲I̲S̲T̲I̲N̲G̲S̲:̲

         Compiler verification - and linker printouts may be
         obtained by activating the command file FILL ̲MTCB.PP.