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

⟦f322f89ff⟧ Wang Wps File

    Length: 10770 (0x2a12)
    Types: Wang Wps File
    Notes: RECMES PROCEDURE PSP      
    Names: »3180A «

Derivation

└─⟦0f96917ac⟧ Bits:30006134 8" Wang WCS floppy, CR 0287A
    └─ ⟦this⟧ »3180A « 

WangText

…14……00……00……00……00……05……0a……00……00……05……0b……05…
…05……05……05……07… …09… …0b… …0d… …0e… …01……86…1                                             …02…            …02…    …02…            

…02…FIX/1200/PSP/0083

…02…MLA/821220…02……02… 
RECMES PROCEDURE PSP
…02……02…FK 7809









  TABLE OF CONTENTS                                      Page

1.   SCOPE ................................................        1
  1.1   Introduction ...................................    1
     1.2   Abbreviations ..................................        1

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

3.   MODULE SPECIFICATIONS .................................       3
  3.1   Functional Capabilities ........................    3
     3.1.1  RECMES main ................................    3
     3.1.2  INS ̲LF .....................................    4
     3.1.3  COMPLETE ̲REC ...............................    5
  3.2   Interface Description ..........................    6
     3.2.1  RECMES main ................................    6
        3.2.1.1  Internal Interface ....................    6
        3.2.1.2  External Interface ....................    7
     3.2.2  INS ̲LF .....................................    9
        3.2.2.1  Internal Interface ....................    9
        3.2.2.2  External Interface ....................    9
     3.2.3  COMPLETE ̲REC ...............................   10
        3.2.3.1  Internal Interface ....................   10
        3.2.3.2  External Interface ....................   11
  3.3   Processing .....................................   13
     3.3.1  RECMES main ................................   13
     3.3.2  INS ̲LF .....................................   15
     3.3.3  COMPLETE ̲REC ...............................   16
  3.4   Data Organization ..............................   21
  3.5   Storage Allocation .............................   22
  3.6   Performance Characteristics ....................   23
  3.7   Limitations ....................................   24
  3.8   Error Codes/Error Locations ....................   25
  3.9   Listing Reference ..............................   27


4.   QUALITY ASSURANCE ....................................      28
  4.1   Qualification Tests ............................  28
  4.2   Other Quality Assurance Provisions .............  28

5.   PREPARATIONS FOR DELIVERY ............................      29

6.   NOTES ................................................      30

7.   APPENDICES ...........................................      31


1.       S̲c̲o̲p̲e̲

         This document describes the design of the Message Recovery Subsystem (RECMES)



1.1      I̲n̲t̲r̲o̲d̲u̲c̲t̲i̲o̲n̲

         The purpose of the RECMES is to complete message, which were in preparation when a switchover
         occured



1.2      A̲b̲b̲r̲e̲v̲i̲a̲t̲i̲o̲n̲s̲

         Please refer to:

         FIKS DATA INTERFACE 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̲

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

         GET ̲DTG Monitor PSP            FIX/12561PSP/0049

         MES Submodule PSP              FIX/1351/PSP/0060

         MTCB Monitor PSP                FIX/1256/PSP/0066

         FIKS S/W Configuration Control Lib. Descr. Doc. 




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    R̲E̲C̲M̲E̲S̲ ̲M̲a̲i̲n̲

         The RECMES process will scan the PDB-File Tables for every terminal at the MEDE to find narrative
         messages which are not complete.  The brinary header and the MTCB…08…s are examined to find out
         how much of the message is missing in being complete.  When this is done the message will
         be completed and check pointed. …86…W         …02…   …02…   …02…   …02…                                     …02…
             
3.1.2    I̲N̲S̲-̲L̲F̲

         The procedure locales the start of the last line in the message.  A "LF" will be inserted
         at the end of the line, and the byte count of the line will be adjusted.  The last line will
         be written to file again.



3.1.3    C̲o̲m̲p̲l̲e̲t̲e̲ ̲R̲e̲c̲

         The procedure will complete a message, when the main precedure RECMES has discovered a message,
         which is not complete.





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    R̲E̲C̲M̲E̲S̲ ̲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 RECMES Main Procedure is invoked by:

             ESP                                           Ref: PSP/0046

         Input to RECMES Procedure is:

             .   Checkpointed data as
                 .   PDB File Table
                 .   PDB Files
                 .   MTCB…08…s

         Output from RECMES Procedure is:

             .   All messages referred in the PDB-File table are completed.

         The RECMES Main Procedure Interfaces to the following procedure 
             COMPLETE ̲REC                                  Ref: sec. 3.1.3.





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

         The RECMES Main Procedure interfaces to the following monitor procedures:

         MON IO GETROOT
             Gets file descriptor for volumes.

         MON REGION RENTER
             Enters a critical region                      (PDBTAB)

         MON REGCON RGETN
             Reads a critical region                       (PDBTAB)

         MON REGION RCOPYN
             Reads a critical region                       (CONFIG)

         MON REGION RLEAVE
             Leaves a critical region                      (PDBTAB)

         MON MTCB INITE
             Initializes the MTCB work area

         MON MTCB READ
             Reads MTCB…08…s

         MON ERROR
             Terminates process in case of an error

         MON SEND MESSAGE
             Sends message to checkpoint process


         MON WAITEVENT
             Waits answer from Checkpoint process

         MON TERMINATE
             Terminates the process when all messages completed




3.2.2    INS ̲LF
…0e……0e…          ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…

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

         The INS ̲LF Procedure is invoked by:

         COMPLETE ̲REC                                      Ref. sec 3.1.3

         Input to INS ̲LF procedure is:
         .   Last part of message in a buffer

         Output from INS ̲LF Procedure is:

         .   completion code
         .   the last line incl. byte count and "LF" written to file.



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

         The INS ̲LF Procedure interfaces to the follwing monitor procedures:

         MON IO MODIFYBYTES
             Writes line to file

         MON ERROR
             Terminates the process





3.2.3    COMPLETE ̲REC
…0e……0e…          ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…

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

         The COMPLETE ̲REC procedure is invoked by:

         RECMES Main Procedure          Ref. 3.1.1

         Input to COMPLETE ̲REC procedure is:

         .   Message on file
         .   MICB for do
         .   MTCB for address list
         .   file for address list if any

         Output from COMPLETE ̲REC procedure is:

         .   message completed
         .   PDBTAB updated
         .   alist resource released
         .   completion code

         The COMPLETE ̲REC procedure interfaces to the following
         procedure:

             INS ̲LF                     Ref: sec 3.1.2…86…W    
                                            …02…   …02…   …02…   …02…      
                                                           
                                                  …02…      
3.2.3.2  E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         The COMPLETE ̲REC procedure interfaces to the following
         monitor procedures:

         MON MTCB GET FILE
             Gets file descriptor for message- and address list
             file

         MON IO GET FILE INFORMATION
             Gets size of message

         MON IO READ BYTES
             Reads bytes from file to buffer

         MON IO MODIFY BYTES
             Updates file with buffer contents

         MON GETDTG
             Reads system time

         MONNMTCB WRITE
             Updates the message MTCB

         MON IO UPDATE
             Updates System Volume

         MON REGION RPUTN
             Updates a critical region (PDBTAB)

         MON SEND MESSAGE
             Sends a message to checkpoint process

         MON WRITEVENT
             waits for an answer from checkpoint process.


         MON MTCB RELEASE FILE
             Decrements the file use count

         MON MTCB RESERVE
             Increments the MTCB use count

         MON MTCB RELEASE
             Decrements the MTCB use count

         MON ERROR
             Terminates the process in case of an error…86…W         …02…   …02…   …02…   …02…                       
                          …02…      
3.3      P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲

3.3.1    R̲E̲C̲M̲E̲S̲ ̲m̲a̲i̲n̲


3.3.2    INS ̲LF
…0e……0e…          ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…


3.3.3    COMPLETE ̲REC
…0e……0e…          ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…




                            .




                               .


  


                                .


 


                              .




                              .


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̲

         The RECMES process has to be run before any terminal process in case of a switch over.





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̲

         The RECMES Process will report error codes, received form monitor procedures on the consol
         together with an error label which points out the location in the RECMES. The error labels
         are listed below:

         "ERROR LABELS FOR RECOVERY.MES

             GETROOT ̲MOV                                   =# 10;
             GETROOT ̲FIX                                   =# 20;
             INIT ̲MTCB                                     =# 30;
             ENTER ̲PDB                                     =# 40;
             READ ̲CONFIG                                   =# 50;
             GET ̲PDB                                       =# 60;
             PDB ̲SCAN ̲ERROR                                =# 70;
             CHECKPOINT ̲1                                  =# 80;
             READ ̲MTCB ̲1                                   =# 90;
             READ ̲MTCB ̲2                                   =#100;
             LEAVE ̲PDB                                     =#110;

         "ERROR LABELS FOR COMPLETE ̲REC

             GET ̲FILE ̲MSG                                  =#200;
             GET ̲FILE ̲INF                                  =#210;
             READ ̲BINHEAD                                  =#220;
             READ ̲LINE                                     =#230;
             WRITE ̲BT ̲1                                    =#240;
             WRITE ̲BT ̲2                                    =#250;
             WRITE ̲ALIST ̲MTCB                              =#260;
             GET ̲FILE ̲ALIST                                =#270;
             READ ̲ALIST ̲FILE                               =#280;
             WRITE ̲ALIST ̲FILE                              =#290;


             GET ̲DTG                                       =#300;
             WRITE ̲DTG ̲FILE                                =#310;
             WRITE ̲BIN ̲HEAD                                =#320;
             WRITE ̲MTCB                                    =#330;
             IO ̲UPDATE                                     =#340;
             PUT ̲PDB                                       =#350;
             CHECKPOINT ̲2                                  =#360;
             REL ̲FILE ̲ALIST                                =#370;
             RES ̲MTCB ̲MSG                                  =#380;
             REL ̲FILE ̲MSG                                  =#390;
             REL ̲MTCB                                      =#400;

         "ERROR LABELS FOR INS ̲LF
             WRITE ̲LINE                                    =#500;





3.9      L̲i̲s̲t̲i̲n̲g̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲

         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:

         Syustem Test Report 5080 FIX/0000/TRP/089



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…86…1         …02…   …02…   …02…   …02…                  …02…          
                      
5        P̲r̲e̲p̲a̲r̲a̲t̲i̲o̲n̲s̲ ̲f̲o̲r̲ ̲D̲e̲l̲i̲v̲e̲r̲y̲

         Please refer to the SCCLDD Document





6        N̲o̲t̲e̲s̲

         N/A





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

         N/A