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

⟦d31e3cfd1⟧ Wang Wps File

    Length: 18637 (0x48cd)
    Types: Wang Wps File
    Notes: CAMPS SYS DESIGN          
    Names: »0471A «

Derivation

└─⟦0cbd6095b⟧ Bits:30006077 8" Wang WCS floppy, CR 0034A
    └─ ⟦this⟧ »0471A « 

WangText



7…86…1
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 …02…
 
 
 
 
 
 
 
 
 
 
 …02…
 
 
 …02…
 
 
 
 
 
 
 
 
 

…02…CPS/SDS/001

…02…RIM/810115…02……02…
CAMPS
 SYSTEM
 DESIGN
 SPECIFICATION
…02……02…CAMPS









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



   5.15    SAR (STORAGE AND RETRIEVAL) .........    
     5.15.1  Summary of Requirements ...........    
       5.15.1.1  Package Description ...........    
         5.15.1.1.1  General Concept ...........    
         5.15.1.1.2  On-Line Storage ...........    
         5.15.1.1.3  Off-Line Storage ..........    
         5.15.1.1.4  Subject to Storage ........    
         5.15.1.1.5  Storage Retrieval Keys ....    
         5.15.1.1.6  Retrieval .................    
           5.15.1.1.6.1 On-Line Retrieval ......    
           5.15.1.1.6.2 Off-Line Retrieval .....    

         5.15.1.1.7  Interface Summary .........    
           5.15.1.1.7.1 Internal Interface .....    
           5.15.1.1.7.2 External Interface .....    

         5.15.1.2  Package Function ............    
           5.15.1.2.1  On-Line Storage .........    
           5.15.1.2.2  Off-Line Storage ........    
             5.15.1.2.2.1 Ordinary Storage
                          Operation ............    
             5.15.1.2.2.2 Exceeding Off-line 
                          Disk Threshold .......    

           5.15.1.2.3  Retrieval ...............    
             5.15.1.2.3.1 On-Line Retrieval ....    
             5.15.1.2.3.2 Off-Line Retrieval ...    

           5.15.1.2.4  Errors ..................    
             5.15.1.2.4.1 Error Detection ......    
             5.15.1.2.4.2 Error Handling .......    

           5.15.1.2.5  Recovery ................    
             5.15.1.2.5.1 General Description ..    
             5.15.1.2.5.2 Storage On-Line
                          Recovery .............    
             5.15.1.2.5.3 Storage Off-Line 
                          Recovery .............    
             5.15.1.2.5.4 Retrieval On-Line, 
                          Off-Line Recovery ....    

           5.15.1.2.6  Initialization ..........    
             5.15.1.2.6.1 Package Initialization    
             5.15.1.2.6.2 Off-Line Volume 
                          Initialization .......    


             5.15.1.2.6.3 Setting Off-Line
                          Volume Threshold .....    

           5.15.1.3  Package Control ...........    
           5.15.1.4  Characteristics ...........    
             5.15.1.4.1 Performance ............    
               5.15.1.4.1.1 On-Line Disk Area ..    
               5.15.1.4.1.2 Off-Line Disk Area .    
               5.15.1.4.1.3 Storage Capacity ...    
               5.15.1.4.1.4 Retrieval Timing ...    

           5.15.1.5  Design and Construction ...    
           5.15.1.6  Documentation .............    



5.15     S̲A̲R̲ ̲(̲S̲T̲O̲R̲A̲G̲E̲ ̲A̲N̲D̲ ̲R̲E̲T̲R̲I̲E̲V̲A̲L̲)̲



5.15.1   S̲u̲m̲m̲a̲r̲y̲ ̲o̲f̲ ̲R̲e̲q̲u̲i̲r̲e̲m̲e̲n̲t̲s̲



5.15.1.1     P̲a̲c̲k̲a̲g̲e̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲



5.15.1.1.1 G̲e̲n̲e̲r̲a̲l̲ ̲C̲o̲n̲c̲e̲p̲t̲

         SAR provides functional capabilities for on-line storage
         of all incoming and outgoing messages in an intermediate
         storage (up to a few days depending on traffic and
         assigned disk space and allowed fill rate).  After
         that, the items are kept for a period of at least 30
         days on off-line disk volumes (long term storage).

         It is possible to retrieve items from the intermediate
         storage within a specified time limit.

         Retrieving off-line is possible within a time limit
         to be specified measured from when off-line volume
         is mounted.  The functions carried out by SAR are then
         referenced according to their priority level:

         retrieve on-line
         store on-line
         store off-line
         retrieve off-line



5.15.1.1.2   O̲n̲-̲L̲i̲n̲e̲ ̲S̲t̲o̲r̲a̲g̲e̲

         The on-line items handled by SAR are on-line resident
         for at least 24 hours.  On-line storage is characterized
         by the fact that no mounting of physical media is required
         to retrieve the item.  Time span for on-line storage
         is in the order of days.





5.15.1.1.3   O̲f̲f̲-̲L̲i̲n̲e̲ ̲S̲t̲o̲r̲a̲g̲e̲

         An off-line storage process is carried out by dumping
         items to an off-line volume, when they have been on-line
         resident for at least 24 hours.  Off-line storage normally
         requires, that a media must be loaded prior to retrieval.



5.15.1.1.4   S̲u̲b̲j̲e̲c̲t̲ ̲t̲o̲ ̲S̲t̲o̲r̲a̲g̲e̲

         Data for storage and retrieval are operational- and
         service messages except for the categories CTS and
         CTS/A.  Further data messages are stored only for reruns.
          The items for on-line storage are as follows:  

         First draft, Released messages, Incoming analysed +
         evt. corrected messages, Release notifications and
         Comment submitted.



5.15.1.1.5   S̲t̲o̲r̲a̲g̲e̲ ̲a̲n̲d̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲K̲e̲y̲s̲

         The items for storage are catalogued under a combination
         of the keys: TOC (time of occurrence), TOC window,
         DTG (release), ORIG. HQ., ITEM REF ID, CHANNEL ID,
         CHANNEL SERIAL NUMBER, STATION ID, STATION SERIRAL
         NUMBER, FILE TIME (transmission time), SICs. Retrieving
         the items are achieved by combining the search keys
         depending on the category of item.



5.15.1.1.6   R̲e̲t̲r̲i̲e̲v̲a̲l̲

         Retrieval of stored item using a combination of the
         previous mentioned key can be achieved from both on-line
         or off-line storage media.



5.15.1.1.6.1 O̲n̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲

         The on-line disk contains the on-line items which can
         be retrieved to a terminal position which already have
         gained knowledge to the item by either having prepared
         or received it before.



5.15.1.1.6.2 O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲

         The off-line items reside on a number of off-line volumes
         which are mounted under an off-line retrieval process
         in progress.



5.15.1.1.7   I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲S̲u̲m̲m̲a̲r̲y̲



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

         Refer to interface chart figure 5.15.1.1.2.2.

         L̲O̲G̲

         Event:  Storage and retrieval of log items.  Commands
         and retrieval keys are communicated.

         T̲E̲P̲

         Event:  Storage and retrieval of items.  Commands and
         retrieval keys are communicated.

         Request of physical mount of volume to supervisor.

         T̲M̲P̲

         Event:  Conversion of address parameters. Parameters
         are communicated.

         T̲H̲P̲

         Event:  Storage of incoming and outgoing messages.
          Store command and retrieval keys are communicated.

         S̲F̲M̲

         Event:  Updating catalogue entries by storage of item.

         Storage and retrieval commands for MMS.  Retrieval
         keys to SFM for catalogue updating.



         S̲S̲C̲

         Event:  Upstart and recovery action during system generation
         and system failures respectively.

         For a detailed description of interfaces, refer to
         section 5.15.1.2 where each SAR application and respective
         interface communication are described.

















































Fig. 5.15.1.1.2.1
INTERFACE BLOCK DIAGRAM



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

         None.



5.15.1.2     P̲a̲c̲k̲a̲g̲e̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲



5.15.1.2.1   O̲n̲-̲L̲i̲n̲e̲ ̲S̲t̲o̲r̲a̲g̲e̲

         Storage on-line means storage on intermediate storage
         of items which have completed processing. The five
         categories of items for storage are stored according
         to the events listed below:

         Incoming Messages.

         Storage upon succesful passing of analysis after a
         possible correction by message service.

         Released Messages

         Storage when the positive release decision has been
         given by the releasing officer.

         First Draft

         Storage upon completion of new message preparation
         format A.

         Comments

         Storage upon completion of new comment preparation
         format G1.

         Release Notifications

         Storage upon completion of the release decision

         The packages responsible for the above mentioned actions
         initiate a storage process as described next.



         During step 1a-d, the application modules request SAR
         to initiate a storage process by queuing a request
         in the incoming storage queue (ISQ).  The on-line catalogue
         is updated for each storage process with a new entry
         (2) and upon this completion, SAR requests SFM to store
         the respective item by issuing a STORE ITEM command
         (3) with input parameters ICB reference and field list.
          The on-line storage process is depicted overleaf in
         figure 5.15.1.2.1.

















































Fig. 5.15.1.2.1
STORAGE ON-LINE PROCESS



5.15.1.2.2   O̲f̲f̲-̲L̲i̲n̲e̲ ̲S̲t̲o̲r̲a̲g̲e̲



5.15.1.2.2.1 O̲r̲d̲i̲n̲a̲r̲y̲ ̲S̲t̲o̲r̲a̲g̲e̲ ̲O̲p̲e̲r̲a̲t̲i̲o̲n̲

         The communication under an offline dump process is
         carried out via report queues and sync-EL as shown
         in figure 5.15.1.2.2.  Incarnation of the off-line
         dump process is done by SFM when an ITEM THRESHOLD
         WARNING is sent to SAR (1).  The setting of this threshold
         is described under initialization of SAR.

         The supervisor under TEP is then asked if this dump
         can take place.  A request command and volume no. is
         placed in the TEP report queue (2a).  Completion code
         of this request is either, mount completed, go ahead
         or try again later which is reported back via SAR report
         queue (2b).  If go ahead was reported back, the off-line
         catalogue is opened using the command GET MMS CATALOGUE
         (3a).  By consulting on-line catalogue (3b) SAR determines
         which item to dump according to the TOC field in each
         item entry.  A DUMP ITEM command together with the
         item-id list are handled to SFM (3c).  Completion of
         the dump process is reported back from SFM to SAR (3d).

         The off-line resident catalogue is now updated with
         new entries corresponding to the dumped items (3e).
          Finally, the on-line entries are deleted, to ensure
         a proper recovery (3f).  Completion of total dump process
         is acknowledged to TEP (supervisor) via the report
         queue (3g).



5.15.1.2.2.2 E̲x̲c̲e̲e̲d̲i̲n̲g̲ ̲O̲f̲f̲-̲L̲i̲n̲e̲ ̲D̲i̲s̲k̲ ̲T̲h̲r̲e̲s̲h̲o̲l̲d̲

         Upon exceeding of off-line disk threshold an ITEM THRESHOLD
         WARNING is reported to SAR (4a) when a dump process
         is in progress.  SAR is informed at the same instance
         about the last stored item-id.  A new dump request
         command is handled to TEP which then takes care of
         the physical and logical disk mount (4b).  Completion
         of disk mount is acknowledged back (4c) where SAR is
         told whether a complete new or used volume is mounted.
          A new volume is initialized by supervisor, while mount
         of used volume requires deletion of table entry corresponding
         to the volume being deleted before …86…1         …02…   …02…  
         …02…   …02…                                           
         initialization (4d).  The dump process is reinitiated
         by handling SFM, a new DUMP ITEM command with parameters
         specifying the remaining items (3c).  Completion will
         now take place as described in the previous chapter.

         All changes in off-line volume usage while used by
         SAR is reported via SAR report queue.

















































Fig. 5.15.1.2.2
OFF-LINE DUMP



5.15.1.2.3   R̲e̲t̲r̲i̲e̲v̲a̲l̲

         Refer figure 5.15.1.2.3.

         Retrieval of the previously stored information takes
         place from either on-line volume or off-line by placing
         a retrieve command in the retrieve request queue (RRQ)
         of SAR, which then returns one out of three things
         in the delivery queue of the requesting application.

         a)  An ICB referencing the retrieved item

         b)  Completion code telling the reason for improper
             completion

         c)  Catalogue information for display



5.15.1.2.3.1 O̲n̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲

         a)  R̲e̲t̲u̲r̲n̲i̲n̲g̲ ̲a̲n̲ ̲I̲C̲B̲

             After reception and detection of an on-line retrieval
             command (1a), the on-line catalogue is consulted
             to determine the item-id corresponding to the retrieval
             key parameters (1b).  A RETRIEVE ITEM command with
             item-id as input parameter is handled to SFM (1c).
              SFM returns an ICB referencing the generated temporary
             item (1d) which is handled further on by SAR to
             the requesting application delivery queue (1e).

         b)  R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲C̲o̲m̲p̲l̲e̲t̲i̲o̲n̲ ̲C̲o̲d̲e̲s̲

             Improper completion of a retrieval procedure can
             be caused by:

             -   Not found referenced item

             -   Retrieval intermediately impossible

         c)  C̲a̲t̲a̲l̲o̲g̲u̲e̲ ̲D̲i̲s̲p̲l̲a̲y̲

             In case that a catalogue display is required the
             on-line catalogue is consulted. The entries fulfilling
             the retrieval key parameters are returned through
             step 1e.



5.15.1.2.3.2 O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲

         According to the TOC retrieval parameter an off-line
         retrieval process is initiated. This is serviced at
         a lower priority level than on-line retrieval and will
         result in three different actions.

         a)  O̲r̲d̲i̲n̲a̲r̲y̲ ̲O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲

             Ordinary off-line retrieval is carried out by requesting
             the supervisor to mount a specified  volume (2a).
             Determination of volume is done by consulting a
             table containing information about time intervals
             on off-line volumes. As for off-line storage a
             completion code is returned (2b) telling whether
             the volume is mounted or cannot intermediately
             be mounted.

             If mounted SFM is asked to open the off-line volumes
             directory and item area by the command GET MMS
             CATALOGUE (2c).  SAR consults the directory for
             determination of item-id of wanted item (2d). 
             A RETRIEVE ITEM command is handled by SAR to SFM
             (2e), which returns the previously mentioned ICB
             (2f).  This again is passed to the calling application
             via its delivery queue (2g) by SAR.

         b)  O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲C̲o̲m̲p̲l̲e̲t̲i̲o̲n̲ ̲C̲o̲d̲e̲s̲

             If the off-line volume cannot intermediately be
             mounted, the application is acknowledged by a completion
             code in its delivery queue (2h).

             This completion code can as well tell that referenced
             item not found or off-line retrieval intermediately
             impossible. Reduction in time interval, because
             interval covers 2 voulumes, is achnowledge back
             via completion codes.

         c)  O̲f̲f̲-̲L̲i̲n̲e̲ ̲C̲a̲t̲a̲l̲o̲g̲u̲e̲ ̲D̲i̲s̲p̲l̲a̲y̲

             As for on-line retrieval the catalogue entries
             corresponding to the retrieval search keys are
             returned (2g).

















































Fig. 5.15.1.2.3
RETRIEVAL OF ITEMS



5.15.1.2.4   E̲r̲r̲o̲r̲s̲



5.15.1.2.4.1 E̲r̲r̲o̲r̲ ̲D̲e̲t̲e̲c̲t̲i̲o̲n̲

         Syntax check of retrieval key parameter is carried
         out by TEP upon execution format H (retrieval format).

         Access rights check upon retrieving item are carried
         out by TEMCO under SSC.  Error caused by non-existing
         item during a retrieval process is detected by SAR.



5.15.1.2.4.2 E̲r̲r̲o̲r̲ ̲H̲a̲n̲d̲l̲i̲n̲g̲

         The errors detected by SAR are reported to TEP via
         completion codes.  All other errors are reported to
         SSC which then are responsible of handling the error.



5.15.1.2.5   R̲e̲c̲o̲v̲e̲r̲y̲



5.15.1.2.5.1 G̲e̲n̲e̲r̲a̲l̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         The partial recovery of SAR during upstart after system
         failure is described next handling each process within
         SAR separately.



5.15.1.2.5.2 S̲t̲o̲r̲a̲g̲e̲ ̲O̲n̲-̲L̲i̲n̲e̲ ̲R̲e̲c̲o̲v̲e̲r̲y̲

         Each on-line storage command in the ISQ queue is combined
         with a checkpoint so this queue is fully recovered
         by SSC.  Removal of queue elements takes place after
         the on-line storage process has been completed.

         Recovering this process by SAR is carried out by checking
         the oldest queue element to see if it was already stored
         completely.  If not, SAR is responsible for completing
         the storage.





5.15.1.2.5.3 S̲t̲o̲r̲a̲g̲e̲ ̲O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲c̲o̲v̲e̲r̲y̲

         Recovering this process is based on the checkpointed
         DUMP ITEM command which contains a list of item-id
         under an off-line dump process.

         The recovery action taken by SAR is to receive this
         item-id from SSC, retrieve all items referenced by
         these id's to see which ones were stored or not.  The
         missing ones are stored and catalogues, off-line and
         on-line, are updated accordingly.

         Failure occuring before the SFM command DUMP ITEM will
         cause the dump process to be restarted by SSC.  Occuring
         after SFM completion code will have the affect that
         SAR updates both off-line and on-line catalogues according
         to the dumped items.



5.15.1.2.5.4 R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲O̲n̲-̲l̲i̲n̲e̲,̲ ̲O̲f̲f̲-̲l̲i̲n̲e̲ ̲R̲e̲c̲o̲v̲e̲r̲y̲

         Failure upon retrieving from either on-line or off-line
         will not cause any recovery actions except cleaning
         up.  The retrieval command shall therefore be retransmitted.



5.15.1.2.6   I̲n̲i̲t̲i̲a̲l̲i̲z̲a̲t̲i̲o̲n̲



5.15.1.2.6.1 P̲a̲c̲k̲a̲g̲e̲ ̲I̲n̲i̲t̲i̲a̲l̲i̲z̲a̲t̲i̲o̲n̲

         SSC is responsible via TEMCO of handling SAR start-up
         information.  Establishing of initial empty catalogues
         and signal go are necessary tasks performed under this
         process.

         During a recovery situation, a restart signal from
         SSC requests SAR to initiate the previously described
         recovery actions before signal go actually starts up
         the package for ordinary operations.





5.15.1.2.6.2 O̲f̲f̲-̲L̲i̲n̲e̲ ̲V̲o̲l̲u̲m̲e̲ ̲I̲n̲i̲t̲i̲a̲l̲i̲z̲a̲t̲i̲o̲n̲

         By mount of a new volume, upon exceeding threshold
         of old one, either a completely fresh or previously
         used disk can be taken into use.

         For a complete new, the supervisor under TEP is responsible
         of initializing i.e. formatting of volume while previously
         used, requires following handling before use.  Reading
         of off-line catalogue prior to a deletion of corresponding
         contents in a SAR table keeping track of items resident
         on off-line volumes.  The supervisor renames the volume
         according to the number series used for the volumes.



5.15.1.2.6.3 S̲e̲t̲t̲i̲n̲g̲ ̲O̲f̲f̲-̲L̲i̲n̲e̲ ̲V̲o̲l̲u̲m̲e̲ ̲T̲h̲r̲e̲s̲h̲o̲l̲d̲

         The initialization step carried out by SAR is to set
         the filling rate of the off-line volume.  A SET INTERMEDIATE
         STORAGE THRESHOLD command with sector count as input
         parameter is handled to SFM under this process.



5.15.1.3 P̲a̲c̲k̲a̲g̲e̲ ̲C̲o̲n̲t̲r̲o̲l̲

         The control of SAR is carried out by the following
         packages.

         TEP, TMP and LOG initiate either a storage or a retrieval
         process.  THP initiates a storage procedure upon storage
         of incoming and outgoing messages.

         SSC controls start up during system generation and
         recovery situations.



5.15.1.4 C̲h̲a̲r̲a̲c̲t̲e̲r̲i̲s̲t̲i̲c̲s̲



5.15.1.4.1 P̲e̲r̲f̲o̲r̲m̲a̲n̲c̲e̲





5.15.1.4.1.1 O̲n̲-̲L̲i̲n̲e̲ ̲D̲i̲s̲k̲ ̲A̲r̲e̲a̲

         The on-line disk area controlled by SAR is the online
         catalogue used for converting retrieval key parameters
         into item-id.  A table used for keeping track of all
         off-line volumes in use and their corresponding time
         interval under which they were used for storage, is
         as well on-line and controlled by SAR.



5.15.1.4.1.2 O̲f̲f̲-̲L̲i̲n̲e̲ ̲D̲i̲s̲k̲ ̲A̲r̲e̲a̲

         SAR controls the off-line catalogues on each off-line
         volume in conjunction with the conversion of retrieval
         key parameters into item-id's.



5.15.1.4.1.3 S̲t̲o̲r̲a̲g̲e̲ ̲C̲a̲p̲a̲c̲i̲t̲y̲

         Refer SRS 3.4.1.3-5.



5.15.1.4.1.4 R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲T̲i̲m̲i̲n̲g̲

         Refer SRS 3.4.1.6.4.



5.15.1.5 D̲e̲s̲i̲g̲n̲ ̲a̲n̲d̲ ̲C̲o̲n̲s̲t̲r̲u̲c̲t̲i̲o̲n̲

         Refer section 2.5.



5.15.1.6 D̲o̲c̲u̲m̲e̲n̲t̲a̲t̲i̲o̲n̲

         Refer section 2.6