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

⟦866192f49⟧ Wang Wps File

    Length: 72309 (0x11a75)
    Types: Wang Wps File
    Notes: CPS/SDS/048               
    Names: »4664A «

Derivation

└─⟦249f842e7⟧ Bits:30006192 8" Wang WCS floppy, CR 0445A
    └─ ⟦this⟧ »4664A « 

WangText

…00……00……00……00……00…6…0a……00……00…6…0b…6…06…5…01…4…0b…4…0f…4
4…06…3…0b…)…00…)
) (…0a…(…0f…(…00…(…06…'…0a…'…0b…'…0c…'…0d…'…0e…'…0f…'…00…'…01…'…02…'
'…07…&…0b…&…0e…&…00…& %…08…%…0b…%…0f…%
%…07…$…0b…$…0d…$…00…$
$…07…#…0a…#…0e……86…1                                             …02…           …02…   …02…        

…02…CPS/SDS/048

…02…JBS/840815…02……02…
MESSAGE SERVICE VDU
…02……02…CAMPS










       4.1.5 Common Package Procedure ...............
                 
         4.1.5.1 TEP Queue Error ....................
                     
         4.1.5.2 TEP Internal Error .................
                     
         4.1.5.3 TEP Dismantle ......................
                     
         4.1.5.4 Display Header Queue ...............
                     
         4.1.5.5 Set Header Text ....................
                     
         4.1.5.6 Set Header Classification ..........
                     
         4.1.5.7 Internal Representation to ASCII
                 Conversion .........................
                     
         4.1.5.8 ASCII to Internal Representation
                 Conversion .........................
                     

         4.1.5.9 Move Words .........................
                     
         4.1.5.10  Display Header Information .......
                       

       4.1.6 Global Elements ........................
                 
       4.1.7 Interfaces .............................
                 
         4.1.7.1 External Interfaces ................
                     
         4.1.7.2 Package Interfaces .................
                     
           4.1.7.2.1 SSC I/E ........................
                         
           4.1.7.2.2 TMP I/E ........................
                         
           4.1.7.2.3 Log F/E ........................
                         
           4.1.7.2.4 SAR I/E ........................
                         
           4.1.7.2.5 THP/I/E ........................
                         
           4.1.7.2.6 MDP I/E ........................
                         

         4.1.7.3 Subpackage I/E .....................
                     
           4.1.7.3.1 Process Interfaces .............
                         
           4.1.7.3.2 Coroutine Interfaces ...........
                         
           4.1.7.3.3 Other I/E ......................
                         

     4.2 SUBPACKAGE SPECIFICATION ...................
             
       4.2.1 Message Assistance VDU Control
             Subpackage (MAVCO) .....................
                 
         4.2.1.1 Functional Specification ...........
                     
           4.2.1.1.1 Initialization (1.0) ...........
                         
           4.2.1.1.2 TEMCO Command Processing (2.0) .
                         
           4.2.1.1.3 VDU Header Control (3.0) .......
                         
           4.2.1.1.4 Error Reporting (4.0). .........
                         

         4.2.1.2 Software Structure .................
                     
           4.2.1.2.1 MAVCO Control (1.0) ............
                         
           4.2.1.2.2 Start User (2.0) ...............
                         
           4.2.1.2.3 Stop User/Close Down (3.0) .....
                         
           4.2.1.2.4 Timer Event Processing (4.0) ...
                         
           4.2.1.2.5 Flash Action (5.0) .............
                         
           4.2.1.2.6 Queue Fields Update (6.0) ......
                         
           4.2.1.2.7 Common Procedures ..............
                         



         4.2.1.3 Dataflow and Control Logic Within 
                 MAVCO ..............................
                     
           4.2.1.3.1 Data Flow ......................
                         
           4.2.1.3.2 Control Logic ..................
                         

         4.2.1.4 MVCO Module Specification ..........
                     
           4.2.1.4.1 MVCO Control ...................
                         
           4.2.1.4.2 Start User .....................
                         
           4.2.1.4.3 Stop User ......................
                         
           4.2.1.4.4 Timer Event Processing .........
                         
           4.2.1.4.5 Flash Action ...................
                         
           4.2.1.4.6 Queue Fields Update ............
                         

         4.2.1.5 Common Subpackage Data .............
                     
         4.2.1.6 Common Subpackage Procedures .......
                     
           4.2.1.6.1 Request Periodic Timeout .......
                         
           4.2.1.6.2 Send MART Command ..............
                         
           4.2.1.6.3 Send MAFCO Command .............
                         
           4.2.1.6.4 Clear Header Split .............
                         
           4.2.1.6.5 Send Reply To SSC ..............
                         
           4.2.1.6.6 Get Date Time ..................
                         
           4.2.1.6.7 Cancel Periodic Timeout ........
                         
           4.2.1.6.8 Remove User Connection  ........
                         
           4.2.1.6.9 Check VDU Attributes ...........
                         

       4.2.2 Message Service Function Control
             Subpackage (MAFCO) .....................
                 
         4.2.2.1 Functional Specification ...........
                     
           4.2.2.1.1 MAFCO Software Error Functions .
                         
           4.2.2.1.2 F/C Key Command Functions ......
                         
           4.2.2.1.3 MAVCO Control Functions ........
                         
           4.2.2.1.4 MSA Command Execution Functions.
                         
           4.2.2.1.5 Transaction Execution Functions.
                         
           4.2.2.1.6 Transaction Accounting .........
                         

         4.2.2.2 Software Structure .................
                     
           4.2.2.2.1 SFCO Main (1.0) ................
                         
           4.2.2.2.2 F/C Key Command Execution (2.0).
                         
           4.2.2.2.3 Validate Command (3.0) .........
                         
           4.2.2.2.4 Full Parameter Check (4.0) .....
                         
           4.2.2.2.5 MSA Command Validation (5.0) ...
                         
           4.2.2.2.6 Execute Transaction (6.0) ......
                         
           4.2.2.2.7 System Sequence Control (7.0) ..
                         
           4.2.2.2.8 Execute System Sequence (8.0) ..
                         
           4.2.2.2.9 Transaction Control (9.0) ......
                         
           4.2.2.2.10  SVUP Exception (10.0) ........
                           
           4.2.2.2.11  Command Confirmation (11.0) ..
                           
           4.2.2.2.12  Execute MSA Function (12.0) ..
                           
           4.2.2.2.13  Send Action (13.0) ...........
                           


           4.2.2.2.14  MASS Answer Queue Processing
                       (14.0) .......................
                           
           4.2.2.2.15  SVC Handling (15.0) ..........
                           
           4.2.2.2.16  Create New View (16.0) .......
                           
           4.2.2.2.17  UMAM Request (17.0) ..........
                           
           4.2.2.2.18  Create New C/F Version (18.0) 
                           
           4.2.2.2.19  Create New C/F (19.0) ........
                           
           4.2.2.2.20  Retrieval Request (20.0) .....
                           
           4.2.2.2.21  Get First (21.0) .............
                           
           4.2.2.2.22  Get Next (22.0) ..............
                           
           4.2.2.2.23  Receive First (23.0) .........
                           
           4.2.2.2.24  Receive Next (24.0) ..........
                           
           4.2.2.2.25  Calculate MASS Format (25.0) .
                           

         4.2.2.3 Data Flow and Control Logic Within
                 MAFCO ............................. 
                     
         4.2.2.4 MAFCO Module Specification .........
                     
           4.2.2.4.1 SFCO Main ......................
                         
           4.2.2.4.2 F/C Key Command Execution ......
                         
           4.2.2.4.3 Validate Command ...............
                         
           4.2.2.4.4 Execute Transaction ............
                         
           4.2.2.4.5 Full Parameter Check ...........
                         
           4.2.2.4.6 System Control Sequence ........
                         
           4.2.2.4.7 Execute System Sequence ........
                         
           4.2.2.4.8 Transaction Control ............
                         
           4.2.2.4.9 Command Confirmation ...........
                         
           4.2.2.4.10  SVUP Exception ...............
                           
           4.2.2.4.11  Answer Queue Processing ......
                           
           4.2.2.4.12  Calculate MASS Format ........
                           
           4.2.2.4.13  Send Action ..................
                           
           4.2.2.4.14  Execute MSA Function .........
                           
           4.2.2.4.15  Get First ....................
                           
           4.2.2.4.16  Get Next .....................
                           
           4.2.2.4.17  Recv First ...................
                           
           4.2.2.4.18  Recv Next ....................
                           
           4.2.2.4.19  Create CIF ...................
                           
           4.2.2.4.20  Create New CIF Version .......
                           
           4.2.2.4.21  Create New View ..............
                           
           4.2.2.4.22  MSA Command Validation .......
                           
           4.2.2.4.23  Retrieval Request ............
                           
           4.2.2.4.24  UMAM Request .................
                           
           4.2.2.4.25  SVC Handling .................
                           


4.1.5    C̲o̲m̲m̲o̲n̲ ̲P̲a̲c̲k̲a̲g̲e̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲s̲

         These procedures are common for SUP and MSA and only
         a brief description will be given in this document.
         For further details refer CPS/SDS/035 section 4.1.5.



4.1.5.1  T̲E̲P̲ ̲Q̲U̲E̲U̲E̲ ̲E̲R̲R̲O̲R̲

         The purpose of this procedure is to report queue errors
         to the SSC.



4.1.5.2  T̲E̲P̲ ̲I̲N̲T̲E̲R̲N̲A̲L̲ ̲E̲R̲R̲O̲R̲

         The purpose of this procedure is to report internal
         errors to the SSC.



4.1.5.3  T̲E̲P̲ ̲D̲I̲S̲M̲A̲N̲T̲L̲E̲

         The purpose of this procedure is to dismantle an object
         referenced by a QEL.

         The referenced view will be checkpointed if the Checkpoint
         Status is true.

         The referenced view will be closed if demanded.



4.1.5.4  D̲I̲S̲P̲L̲A̲Y̲ ̲H̲E̲A̲D̲E̲R̲ ̲Q̲U̲E̲U̲E̲

         This procedure displays the time and queue fields of
         the VDU header split by calling the Format Handler.



4.1.5.5  S̲E̲T̲ ̲H̲E̲A̲D̲E̲R̲ ̲T̲E̲X̲T̲

         The purpose of this procedure is to update the VDU
         ̲HEADER ̲AREA with the HEADER ̲TXT which is specified
         by the caller.





4.1.5.6  S̲E̲T̲ ̲H̲E̲A̲D̲E̲R̲ ̲C̲L̲A̲S̲S̲I̲F̲I̲C̲A̲T̲I̲O̲N̲

         The VDU ̲HEADER ̲AREA is updated with the required classification
         which can be either CURRENT ̲CLASS or MAX ̲CLASS.



4.1.5.7  I̲n̲t̲e̲r̲n̲a̲l̲ ̲R̲e̲p̲r̲e̲s̲e̲n̲t̲a̲t̲i̲o̲n̲ ̲t̲o̲ ̲A̲S̲C̲I̲I̲ ̲C̲o̲n̲v̲e̲r̲s̲i̲o̲n̲

         Converts an integer in internal representation to ASCII.



4.1.5.8  A̲S̲C̲I̲I̲ ̲t̲o̲ ̲I̲n̲t̲e̲r̲n̲a̲l̲ ̲R̲e̲p̲r̲e̲s̲e̲n̲t̲a̲t̲i̲o̲n̲ ̲C̲o̲n̲v̲e̲r̲s̲i̲o̲n̲

         Converts an integer represented in ASCII to internal
         representation.



4.1.5.9  M̲o̲v̲e̲ ̲W̲o̲r̲d̲s̲

         Moves a given number of words in the memory into another
         place.



4.1.5.10 D̲i̲s̲p̲l̲a̲y̲ ̲H̲e̲a̲d̲e̲r̲ ̲I̲n̲f̲o̲r̲m̲a̲t̲i̲o̲n̲

         This procedure displays the terminal function and classification
         fields of the VDU header area in the VDU header split.



4.1.6    G̲l̲o̲b̲a̲l̲ ̲D̲a̲t̲a̲ ̲E̲l̲e̲m̲e̲n̲t̲s̲

         All Global Data used by MSA is described in ref. CPS/DBD/001.



4.1.7    I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲



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

         Supervisor Commands and procedures refer CPS/230/ICD/0002.


4.1.7.2  P̲a̲c̲k̲a̲g̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲



4.1.7.2.1    S̲S̲C̲ ̲I̲/̲F̲

         This interface is implemented by the coroutine MAVCO.
         For details refer ref. c).



4.1.7.2.2    T̲M̲P̲ ̲I̲/̲F̲

         The following coroutines use TMP functions MAFCO and
          VDIA.
         For details refer ref. c).



4.1.7.2.3    L̲o̲g̲ ̲I̲/̲F̲

         This interface is implemented by the coroutine MAFCO.
         For details refer ref. c).



4.1.7.2.4    S̲A̲R̲ ̲I̲/̲F̲

         This interface is implemented by the coroutines MAFCO
         and MART.
         For details refer ref. c).



4.1.7.2.5    T̲H̲P̲ ̲I̲/̲F̲

         This interface is implemented by the coroutine MAFCO.
         For details refer ref. c).



4.1.7.2.6    M̲D̲P̲ ̲I̲/̲F̲

         This interface is implemented by the coroutine MAFCO.
         For details refer ref. c).





4.1.7.3  S̲u̲b̲p̲a̲c̲k̲a̲g̲e̲ ̲I̲/̲F̲



4.1.7.3.1    P̲r̲o̲c̲e̲s̲s̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲

         Process Interfaces constitute in the VUP the interface
         between UMAM and MSA.

         a)  F̲r̲o̲m̲ ̲M̲S̲A̲ ̲t̲o̲ ̲U̲M̲A̲M̲

             1.  Service Message Status Requests
             2.  Edit Request
             3.  Service Message Deletion Requests
             4.  Access State Changes
             5.  Message Deletion Requests

         b)  U̲M̲A̲M̲ ̲t̲o̲ ̲M̲S̲A̲

             1.  Access Key to CIF (QEL reference)
             2.  Outgoing Service Message Status
             3.  Acknowledge to Deletion Requests



4.1.7.3.2    C̲o̲r̲o̲u̲t̲i̲n̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲

         Coroutine Interfaces in MSA are the interfaces between
         MAVCO, MAFCO, VDIA, and MART.

         a)  F̲R̲O̲M̲ ̲M̲A̲V̲C̲O̲ ̲t̲o̲ ̲M̲A̲F̲C̲O̲

             1.  Start MAFCO Command
             2.  Restart MAFCO Command
             3.  Stop MAFCO Command
             4.  Close MAFCO Command
             5.  Display VDU Header Command

         b)  F̲r̲o̲m̲ ̲M̲A̲V̲C̲O̲ ̲t̲o̲ ̲M̲A̲R̲T̲

             1.  Start MART Command
             2.  Stop MART Command

         c)  F̲r̲o̲m̲ ̲M̲A̲F̲C̲O̲ ̲t̲o̲ ̲M̲A̲V̲C̲O̲

             1.  Answer to Start MAFCO Command
             2.  Answer to Restart MAFCO Command
             3.  Answer to Stop MAFCO Command
             4.  Answer to Close MAFCO Command
             5.  Answer to Display VDU Header Command





         d)  F̲r̲o̲m̲ ̲M̲A̲F̲C̲O̲ ̲t̲o̲ ̲V̲D̲I̲A̲

             1.  Output Format Command
             2.  Output Data Command
             3.  Input Data Command
             4.  Insert Line Command
             5.  Delete Line Command
             6.  Cancel I/O Command
             7.  Close I/O Command
             8.  Clear VDU Command
             9.  Display Menu Command
             10. Copy CIF Command

         e)  F̲r̲o̲m̲ ̲V̲D̲I̲A̲ ̲t̲o̲ ̲M̲A̲F̲C̲O̲

             1.  Answer to Output Format
             2.  Answer to Output Data Format
             3.  Answer to Input Data Format
             4.  Answer to Insert Line Command
             5.  Answer to Delete Line Command
             6.  Answer to Cancel I/O Command
             7.  Answer to Close I/O Command
             8.  Answer to Clear VDU Command
             9.  Answer to Display Menu Command
             10. Answer to Copy CIF Command

         f)  F̲r̲o̲m̲ ̲M̲A̲R̲T̲ ̲t̲o̲ ̲M̲A̲V̲C̲O̲

             1.  Answer to Start MART
             2.  Answer to Stop MART


         g)  F̲r̲o̲m̲ ̲M̲A̲R̲T̲ ̲t̲o̲ ̲M̲A̲F̲C̲O̲

             1.  SAR on-line retrieval notification
             2.  SAR off-line retrieval notification
             3.  On-line retrieval result
             4.  Qerror Notification
             5.  Retrieval Error



4.1.7.3.3    O̲t̲h̲e̲r̲ ̲I̲/̲F̲

         The MSA Initialization subpackage has no interface
         to any of the other subpackages, except for the initialization
         of the MSA coroutines.




4.2      S̲U̲B̲P̲A̲C̲K̲A̲G̲E̲ ̲S̲P̲E̲C̲I̲F̲I̲C̲A̲T̲I̲O̲N̲



4.2.1    M̲e̲s̲s̲a̲g̲e̲ ̲A̲s̲s̲i̲s̲t̲a̲n̲c̲e̲ ̲V̲D̲U̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲S̲u̲b̲p̲a̲c̲k̲a̲g̲e̲ ̲(̲M̲A̲V̲C̲O̲)̲

         This subpackage is the controlling subpackage within
         the package. The control is exercised by issue of commands
         and reception of responses.



4.2.1.1  F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         The subpackage contains the following functions:

         -   Initialization
         -   TEMCO command processing
         -   Timer event processing
         -   VDU header control
         -   MAFCO control
         -   Flash action
         -   Error reporting

         Figure 4.2.1.1-1 presents the functional breakdown.



















































                     FIGURE 4.2.1.1-1
             MAVCO Functional Specification.


4.2.1.1.1    I̲n̲i̲t̲i̲a̲l̲i̲z̲a̲t̲i̲o̲n̲ ̲(̲1̲.̲0̲)̲

         a)  Initialize Format Handler (1.1)
             Performs initialization of the Format Handler within
             IOC and opens the files to be used.



4.2.1.1.2    T̲E̲M̲C̲O̲ ̲C̲o̲m̲m̲a̲n̲d̲ ̲P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲ ̲(̲2̲.̲0̲)̲

         a)  Process Start User Command (2.1).
             This command is received after a successful SIGN
             ON procedure has taken place. MAVCO will then start
             MAFCO.

         b)  Process Stop User/Close Down Command (2.2).
             The stop user command is received when a SIGN OFF
             has taken place. The close down command informs
             MAVCO that a system close down procedure is to
             take place. MAFCO will be stopped by MAVCO.

         c)  Send response to TEMCO (2.3).
             For each TEMCO command a corresponding command
             to MAFCO exists and to each MAFCO command a corresponding
             completion response exists. When MAVCO has received
             the expected completion response from MAFCO an
             acknowledge to the TEMCO command is sent to TEMCO.



4.2.1.1.3    V̲D̲U̲ ̲H̲e̲a̲d̲e̲r̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲(̲3̲.̲0̲)̲

         a)  Update Date/Time Field (3.1).
             Maintains the date/time field in the VDU header
             when a periodic timeout occurs.

         b)  Update Q-Status Fields (3.2).
             Maintains the queue length fields in the VDU header.

         c)  Display VDU Header (3.3).
             Updates the VDU header display.

         d)  Invert Fields (3.4).
             Inverts the queue length fields for queues containing
             flash items.


4.2.1.1.4    E̲r̲r̲o̲r̲ ̲R̲e̲p̲o̲r̲t̲i̲n̲g̲ ̲(̲4̲.̲0̲)̲.̲

         a)  Queue Error Reporting (4.1).
             Reports to SSC that an unexpected queue element
             has been received.

         b)  Internal Error Handling (4.2).
             Reports to SSC that an unexpected response has
             been received from MAFCO or from monitor procedures
             called.



4.2.1.2  S̲o̲f̲t̲w̲a̲r̲e̲ ̲S̲t̲r̲u̲c̲t̲u̲r̲e̲

         The software structure is shown on figure 4.2.1.2-1.
         MAVCO consists of one coroutine containing 6 modules
         and 9 common procedures.



4.2.1.2.1    M̲A̲V̲C̲O̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲(̲1̲.̲0̲)̲

         This is the module containing the mainloop of MAVCO.
         The module initializes the Format Handler and opens
         the format and FCP-files, receives and processes items
         arriving in the command queue.

         The following component procedures are contained in
         this module:

         a)  Clear Answer Queue (1.1)
             After reception of a start user command the items
             staying in the answer queue are received.

         b)  Send to Destination (1.2)
             Item received from answer queue are analyzed and
             sent to the originating queue which can be either
             IMQ, OMQ, or MDQ.



















































                     FIGURE 4.2.1.2-1
                MAVCO Software Structure.


4.2.1.2.2    S̲t̲a̲r̲t̲ ̲U̲s̲e̲r̲ ̲(̲2̲.̲0̲)̲

         The module creates the connection to the VDU (after
         SIGN ̲ON) and updates the VDU header, sends a start
         command to MART and MAFCO, awaits answer from MART
         and MAFCO and sends acknowledge to TEMCO.



4.2.1.2.3    S̲t̲o̲p̲ ̲U̲s̲e̲r̲/̲C̲l̲o̲s̲e̲ ̲D̲o̲w̲n̲ ̲(̲3̲.̲0̲)̲

         This module performs the stop user/close down action
         (after SIGN ̲OFF or system close down). A stop command
         is sent to MART and MAFCO and an answer is awaited.
         The VDU is disconnected and an acknowledge is sent
         to TEMCO.



4.2.1.2.4    T̲i̲m̲e̲r̲ ̲E̲v̲e̲n̲t̲ ̲P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲ ̲(̲4̲.̲0̲)̲

         Investigates the timeout received. The date/time field
         and the queue length fields are updated and the VDU
         header area is displayed.



4.2.1.2.5    F̲l̲a̲s̲h̲ ̲A̲c̲t̲i̲o̲n̲ ̲(̲5̲.̲0̲)̲

         This module interprets the flash notification received
         and the corresponding queue length field is inverted.
         The VDU is demanded to ring the bell. 

         The module contains one module component:

         a)  Flash other (5.1).
             Sends a copy of the flash notification received
             to the other MSA processes.



4.2.1.2.6    Q̲u̲e̲u̲e̲ ̲F̲i̲e̲l̲d̲s̲ ̲U̲p̲d̲a̲t̲e̲ ̲(̲6̲.̲0̲)̲

         The purpose of this module is to read the length of
         all the queues contained in the VDU-header. The following
         component procedures are contained in the module:

         a)  Get Queuelength (6.1).
             Reads queuelength of the queue specified.



         b)  Convert Queuelength (6.2).
             Converts specified length into ASCII.

         c)  Calculate Precedence Length (6.3).
             Reads queuelength of all subqueues in current mainqueue.

         d)  Convert Precedence Length (6.4).
             Converts length of precedence queues into ASCII.
             The result is placed in VDU Header.



4.2.1.2.7    C̲o̲m̲m̲o̲n̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲s̲

         For description of the 9 common procedures refer section
         4.2.1.2.6.



4.2.1.3  D̲a̲t̲a̲f̲l̲o̲w̲ ̲a̲n̲d̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲ ̲w̲i̲t̲h̲i̲n̲ ̲M̲A̲V̲C̲O̲



4.2.1.3.1    D̲a̲t̲a̲ ̲F̲l̲o̲w̲

         An overview of the dataflow through MAVCO is shown
         on diagrams 4.2.1.3-1 to 3.



4.2.1.3.2    C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲

         The call structure within MAVCO is shown on figure
         4.2.1.3-4 identifying all calls between modules within
         MAVCO. The calls of common procedures are shown on
         figure 4.2.1.3-5 to 9.



















































                     FIGURE 4.2.1.3-1
                        Start User



















































                     FIGURE 4.2.1.3-2
                   STOP USER/CLOSE DOWN



















































                     FIGURE 4.2.1.3-3
                       TIMER EVENT



















































                     FIGURE 4.2.1.3-4
                  MAVCO MODULE CALL TREE



















































                     FIGURE 4.2.1.3-5
              MAVCO CONTROL MODULE STRUCTURE



















































                     FIGURE 4.2.1.3-6
               START USER MODULE STRUCTURE



















































                     FIGURE 4.2.1.3-7
                STOP USER MODULE STRUCTURE



















































                     FIGURE 4.2.1.3-8
         TIMER EVENT PROCESSING MODULE STRUCTURE



















































                     FIGURE 4.2.1.3-9
              FLASH ACTION MODULE STRUCTURE


4.2.1.4  M̲V̲C̲O̲ ̲M̲o̲d̲u̲l̲e̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲



4.2.1.4.1    M̲V̲C̲O̲ ̲C̲o̲n̲t̲r̲o̲l̲



4.2.1.4.1.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         This module is the controlling module within this subpackage.
         The tasks for the module are:

         -   initialization of the Format Handler
         -   creation of connections to the FCP and format files
         -   reception of QEL's from the command queue

         The module analyses the input from the queue to identify:

         -   SSC commands
         -   Timeout
         -   Flash notification

         and calls appropriate modules.

4.2.1.4.1.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  SVCO ̲CONTROL(  )
         b)  SVCO ̲CONTROL(R6)

         Register Convention

         Call Registers

             R6           LINK          (DEST)

         Return Register

         None

4.2.1.4.1.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲





4.2.1.4.1.3.1 C̲L̲E̲A̲R̲ ̲A̲N̲S̲W̲E̲R̲ ̲Q̲U̲E̲U̲E̲

         After reception of a Start User command, messages staying
         in the answer queue are removed. Maintype and subtype
         are analyzed and the message is sent to the queue to
         which it belongs.



4.2.1.4.1.3.2 S̲E̲N̲D̲ ̲D̲E̲S̲T̲

         The CIF received from the answer queue is sent to its
         destination



4.2.1.4.1.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             SVUP ̲QNAME(m)
             SVUP ̲SEND ̲PARAMS(m)
             SVUP ̲RECV ̲ATTR(m)
             RECV ̲QEL(m)
             SVUP ̲ARRQ
             FF ̲HANDLE(m)
             HEADER ̲IFCB(m)
             FORMAT ̲IFCB(m)
             SVUP ̲QEL ̲ATTR(m)
             CURRENT ̲SFCO ̲STATE(m)
             CMD ̲QEL(m)
             SVCO ̲SEM

         c)  Local Data

             Refer source list



4.2.1.4.1.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.4.1.1 and figure 4.2.1.4.1-1



         OPEN FCP AND FORMAT FILE

         INITIALIZE FORMAT HANDLER

         REPEAT

             RECEIVE ̲FIRST ̲QEL (MSA ̲CMDQ)(CMD ̲QEL)

             CASE SVUP ̲QEL ̲ATTR.MAINTYPE OF

                 SSC ̲COMMAND?         S̲S̲C̲ ̲C̲O̲M̲M̲A̲N̲D̲ ̲A̲C̲T̲I̲O̲N̲(̲-̲2̲)̲

                 TIME ̲OUT?            T̲I̲M̲E̲R̲ ̲E̲V̲E̲N̲T̲ ̲P̲R̲O̲C̲E̲S̲S̲I̲N̲G̲

                 FLASH ̲NOTIFICATION?  F̲L̲A̲S̲H̲ ̲A̲C̲T̲I̲O̲N̲

                 OTHERWISE?           T̲E̲P̲ ̲Q̲U̲E̲U̲E̲ ̲E̲R̲R̲O̲R̲ ̲(̲C̲O̲N̲T̲I̲N̲U̲E̲)̲

             END CASE

             T̲E̲P̲ ̲D̲I̲S̲M̲A̲N̲T̲L̲E̲ ̲(̲C̲M̲D̲ ̲Q̲E̲L̲)̲

         UNTIL CURRENT ̲SFCO ̲STATE = CLOSE ̲STATE

         REPEAT

             WAIT ̲OPSEM (SVCO ̲SEM)

         UNTIL FOREVER



















                    FIGURE 4.2.1.4.1-1



CASE SVUP ̲QEL ̲ATTR.SUBTYPE OF

 START ̲USER?-CURRENT ̲SFCO ̲STATE NE INIT ̲STOP ̲STATE?
 -S̲S̲C̲ ̲R̲E̲P̲L̲Y̲(̲N̲O̲K̲)̲

             S̲V̲U̲P̲ ̲S̲T̲A̲R̲T̲ ̲U̲S̲E̲R̲

             C̲L̲E̲A̲R̲ ̲A̲N̲S̲W̲E̲R̲ ̲Q̲U̲E̲U̲E̲



 BLOCK TERM
 STOP ̲USER?-CURRENT ̲SFCO ̲STATE NE START ̲RESTART ̲STATE?-S̲S̲C̲
 ̲R̲E̲P̲L̲Y̲(̲N̲O̲K̲)̲

            S̲V̲U̲P̲ ̲S̲T̲O̲P̲ ̲U̲S̲E̲R̲

 CLOSE DOWN?-S̲V̲U̲P̲ ̲S̲T̲O̲P̲ ̲U̲S̲E̲R̲



OTHERWISE?     T̲E̲P̲ ̲Q̲U̲E̲U̲E̲ ̲E̲R̲R̲O̲R̲(̲C̲O̲N̲T̲I̲N̲U̲E̲)̲


























                FIGURE 4.2.1.4.1-2
                SSC ̲COMMAND ̲ACTION



4.2.1.4.2    S̲t̲a̲r̲t̲ ̲U̲s̲e̲r̲



4.2.1.4.2.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         This module performs the functions which must be executed
         when a Start User command has been received from TEMCO.

         The following actions are taken:

         -   The buffer received is read and global variables
             are updated depending on current capability.

         -   The VDU interface is opened.

         -   The VDU header is updated and displayed.

         -   A periodic timeout is requested

         -   The MART and MAFCO coroutines are started.

         -   Acknowledge is sent to TEMCO.



4.2.1.4.2.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  SVUP ̲START ̲USER (  )
         b)  SVUP ̲START ̲USER (R6)

         Register Convention

         Call Registers

                 R6                 LINK           (DEST)

         Return Registers

             R0-R7                                 (DEST)



4.2.1.4.2.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲

         None





4.2.1.4.2.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             CMD ̲QEL
             INIT ̲AREA(m)
             TRANSACTION ̲ID(m)
             CURRENT ̲PREC ̲QUEUE(m)
             CMD ̲TABLE ̲ID(m)
             SVUP ̲ARRQ(m)
             IMQ ̲INVERT(m)
             OMQ ̲INVERT(m)
             MDQ ̲INVERT(m)
             CUR ̲MAX ̲RESP ̲NO(m)
             HEADER ̲IFCB
             FORMAT ̲IFCB

         c)  Local Data

             Refer source list.


4.2.1.4.2.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.4.2.1



4.2.1.4.3    S̲t̲o̲p̲ ̲U̲s̲e̲r̲



4.2.1.4.3.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         This modules performs the functions which must be executed
         when a Stop User or Close Down command has been received
         from TEMCO.

         The following actions are taken:

         -   The MART and MAFCO coroutines are stopped.

         -   Pending periodic timeouts are cancelled.

         -   The VDU header split is cleared.

         -   The VDU connections are disconnected.

         -   Acknowledge is sent to TEMCO.




4.2.1.4.3.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  SVUP ̲STOP ̲USER (CMD: SVCO ̲CMD ̲TYPE)

         b)  SVUP ̲STOP ̲USER (R0, R6)

         Register Convention

         Call Registers

                 R0             CMD           (DEST)
                 R6             LINK          (DEST)


           Return Registers

                 R0-R7                        (DEST)



4.2.1.4.3.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲

             None



4.2.1.4.3.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

         b)  External Data

             CURRENT ̲SFCO ̲STATE
             INIT ̲AREA (m)

         c)  Local Data

             Refer source list



4.2.1.4.3.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.4.3.1



4.2.1.4.4    T̲i̲m̲e̲r̲ ̲E̲v̲e̲n̲t̲ ̲P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲



4.2.1.4.4.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         The module analyses the timeout QEL received.

         If a periodic timeout is received then the VDU header
         area is updated. If the QEL refers to a cancelled timeout
         then no action is taken, otherwise an error is reported.



4.2.1.4.4.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲f̲i̲n̲i̲t̲i̲o̲n̲

         Call Specification

         a)  TIMER ̲EVENT ̲PROCESSING(  )
         b)  TIMER ̲EVENT ̲PROCESSING(R6)

         Register Convention

         Call Registers

                 R6             LINK          (DEST)

           Return Registers

                 R0 - R7                      (DEST)



4.2.1.4.4.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲

         None.



4.2.1.4.4.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             CURRENT ̲SFCO ̲STATE
             SVUP ̲QEL ̲ATTR
             CMD ̲QEL

         c)  Local Data

             Refer source list.



4.2.1.4.4.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.4.4.1



4.2.1.4.5    F̲l̲a̲s̲h̲ ̲A̲c̲t̲i̲o̲n̲



4.2.1.4.5.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         This module analyses the flash notification QEL received.

         If more than one MSA process is loaded then the first
         MSA process will send a copy of the flash notification
         to the other MSA processes.

         If the notification concerns a queue to which the user
         currently signed on has access then the VDU header
         is updated.

         MAFCO is demanded to ring the bell and the queue length
         field is inverted.



4.2.1.4.5.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲f̲i̲n̲i̲t̲i̲o̲n̲

         Call Specification

         a)  FLASH ̲ACTION (  )
         b)  FLASH ̲ACTION (R6)

         Register Convention

         Call Registers

                 R6             LINK          (DEST)

         Return Registers

                 R0-R7                        (DEST)



4.2.1.4.5.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲





4.2.1.4.5.3.1 F̲L̲A̲S̲H̲ ̲O̲T̲H̲E̲R̲ ̲M̲A̲S̲S̲E̲S̲

         If more than one MSA process is loaded then this procedure
         will send a copy of the notification received to the
         other MSA-processes.



4.2.1.4.5.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             MASS ̲SUBPROCESS ̲NO
             SVUP ̲SEND ̲PARAMS (m)
             SVUP ̲QEL ̲ATTR
             SVUP ̲SEND ̲Q (m)
             CURRENT ̲SFCO ̲STATE
             INIT ̲AREA
             CMD ̲QEL

         c)  Local Data

             Refer source list.



4.2.1.4.5.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.4.5.1



4.2.1.4.6    Q̲u̲e̲u̲e̲ ̲F̲i̲e̲l̲d̲s̲ ̲U̲p̲d̲a̲t̲e̲



4.2.1.4.6.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         This module reads the queue length for a subset of
         the following queues:

         -   response queue (RESPQ)
         -   receive queue (RECVQ)
         -   incoming message queue (IMQ)
         -   outgoing message queue (OMQ)
         -   message distribution queue (MDQ)

         The queues selected are depending on current mode (MSO
         mode or MDCO mode)





4.2.1.4.6.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  QUEUE ̲FIELDS ̲UPDATE (  )
         b)  QUEUE ̲FIELDS ̲UPDATE (R6)

         Register Convention

         Call Registers

                 R6             LINK          (DEST)

         Return Registers

                 R0-R7                        (DEST)



4.2.1.4.6.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲



4.2.1.4.6.3.1 G̲E̲T̲ ̲Q̲L̲E̲N̲G̲T̲H̲

         This procedure reads the queue length of the specified
         queue.



4.2.1.4.6.3.2 C̲N̲V̲ ̲Q̲L̲E̲N̲G̲T̲H̲

         This procedure converts the work number to ASCII and
         stores it in the position in VDU ̲HD ̲AREA pointed to
         by offset. Overflow - greater than 99 - is represented
         by '**'.



4.2.1.4.6.3.3 C̲A̲L̲C̲ ̲C̲U̲R̲ ̲P̲R̲E̲C̲

         The procedure reads queuelength for all the precedence
         queues in a given mainqueue.



4.2.1.4.6.3.4 C̲O̲N̲V̲E̲R̲T̲ ̲P̲R̲E̲C̲ ̲L̲E̲N̲G̲T̲H̲

         This procedure converts the contents of WORK into ASCII
         and inserts the result into VDU ̲HD ̲AREA.





4.2.1.4.6.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             WORK (m)
             SVUP ̲QNAME (m)
             VDU ̲HD ̲AREA (m)
             SVUP ̲ARRQ

         c)  Local Data

             Refer source list



4.2.1.4.6.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.4.6.1



4.2.1.5  C̲o̲m̲m̲o̲n̲ ̲S̲u̲b̲p̲a̲c̲k̲a̲g̲e̲ ̲D̲a̲t̲a̲

         a)  Common Types

             Refer source list for

             SVCO ̲PREFIX.S

         b)  Common Data

             Refer source list for

             SVCO ̲DATA.S





4.2.1.6  C̲o̲m̲m̲o̲n̲ ̲S̲u̲b̲p̲a̲c̲k̲a̲g̲e̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲s̲



4.2.1.6.1    R̲e̲q̲u̲e̲s̲t̲ ̲P̲e̲r̲i̲o̲d̲i̲c̲ ̲T̲i̲m̲e̲o̲u̲t̲



4.2.1.6.1.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         This procedure requests a periodic timeout. The period
         is set to one minute.



4.2.1.6.1.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲f̲i̲n̲i̲t̲i̲o̲n̲

         Call Specification

         a)  REQUEST ̲PERIODIC ̲TIMEOUT (  )
         b)  REQUEST ̲PERIODIC ̲TIMEOUT (R6)

         Register Convention

         Call Registers

                 R6             LINK          (DEST)

         Return Registers

                 R0-R7                        (DEST)



4.2.1.6.1.3 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             S ̲REQUEST ̲TIME

         c)  Local Data

             None



4.2.1.6.1.4 P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.6.1.1





4.2.1.6.2    S̲e̲n̲d̲ ̲M̲A̲R̲T̲ ̲C̲o̲m̲m̲a̲n̲d̲



4.2.1.6.2.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         Sends the demanded command to the MART coroutine and
         awaits the answer.



4.2.1.6.2.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲f̲i̲n̲i̲t̲i̲o̲n̲

         Call Specification

         a)  SEND ̲RETR ̲CMD (CMD:RETR ̲CMD ̲TYPE)
         b)  SEND ̲RETR ̲CMD (R0, R6)

         Register Convention

         Call Registers

                 R0             CMD           (DEST)
                 R6             LINK          (DEST)

         Return Registers

                 R0-R7                        (DEST)



4.2.1.6.2.3 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list


         b)  External Data

             SVCO ̲OP ̲PT
             RETR ̲SEM
             SVCO ̲SEM

         c)  Local Data

             Refer source list



4.2.1.6.2.4 P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.6.2.1.


4.2.1.6.3    S̲e̲n̲d̲ ̲M̲A̲F̲C̲O̲ ̲C̲o̲m̲m̲a̲n̲d̲



4.2.1.6.3.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         This procedure sends the specified command and parameters
         to MAFCO and awaits the answer.



4.2.1.6.3.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲f̲i̲n̲i̲t̲i̲o̲n̲

         Call Specification

         a)  SVUP ̲SFCO ̲CMD(CMD:SVCO ̲CMD ̲TYPE;
                 PARA1,
                 PARA2,
                 PARA3:INTEGER)

                 (ANSWER:TEP ̲CMD ̲CC;
                  OPERATION:POINTER)

         b)  SVUP ̲SFCO ̲CMD(R0,R1,R2,R3,R4,R5,R6)

         Register Convention

         Call Registers

                 R0             CMD           (DEST)
                 R1             PARA1         (DEST)
                 R2             PARA2         (DEST)
                 R3             PARA3         (DEST)
                 R6             LINK          (DEST)

         Return Registers

                 R4             ANSWER
                 R5             OPERATION
                 R0-R3,R6-R7                  (DEST)



4.2.1.6.3.3 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list



         b)  External Data

             SVCO ̲OP ̲PT
             SFCO ̲SEM
             SVCO ̲SEM

         c)  Local Data

             Refer source list.



4.2.1.6.3.4 P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.6.3.1.



4.2.1.6.4    C̲l̲e̲a̲r̲ ̲H̲e̲a̲d̲e̲r̲ ̲S̲p̲l̲i̲t̲



4.2.1.6.4.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         This procedure clears the header split of the VDU



4.2.1.6.4.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲f̲i̲n̲i̲t̲i̲o̲n̲

         Call Specification

         a)  CLEAR ̲HD ̲SPLIT (  )
         b)  CLEAR ̲HD ̲SPLIT (R6)

         Register Convention

         Call Registers

                 R6             LINK          (DEST)

         Return Registers

                 R0-R7                        (DEST)





4.2.1.6.4.3 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             HEADER ̲IFCB

         c)  Local Data

             Refer source list.



4.2.1.6.4.4 P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.6.4.1



4.2.1.6.5    S̲e̲n̲d̲ ̲R̲e̲p̲l̲y̲ ̲T̲o̲ ̲S̲S̲C̲



4.2.1.6.5.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         An acknowledge telling the result of a SSC command
         is returned to SSC.



4.2.1.6.5.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲f̲i̲n̲i̲t̲i̲o̲n̲

         Call Specification

         a)  SSC ̲REPLY(REPLY:SSC ̲REPLY ̲TYPE,
                       OPERATION:TEP ̲COROUTINE ̲OP)

         b)  SSC ̲REPLY (R4,R5,R6)

         Register Convention

         Call Registers

                 R4             REPLY         (DEST)
                 R5             OPERATION     (DEST)
                 R6             LINK          (DEST)

         Return Registers

                 R0-R7                        (DEST)





4.2.1.6.5.3 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             SVUP ̲SEND ̲PARAMS (m)
             CMD ̲QEL

         c)  Local Data

             Refer source list.



4.2.1.6.5.4 P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.6.5.1.



4.2.1.6.6    G̲e̲t̲ ̲D̲a̲t̲e̲ ̲T̲i̲m̲e̲



4.2.1.6.6.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         This procedure reads current date and time, and puts
         it in the VDU ̲HD ̲AREA.



4.2.1.6.6.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲f̲i̲n̲i̲t̲i̲o̲n̲

         Call Specification

         a)  GET ̲DATE ̲TIME (  )
         b)  GET ̲DATE ̲TIME (R6)

         Register Convention

         Call Registers

                 R6             LINK          (DEST)

         Return Registers

                 R0-R7                        (DEST)





4.2.1.6.6.3 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             CUR ̲TIME (m)
             VDU ̲HD ̲AREA (m)

         c)  Local Data

             Refer source list



4.2.1.6.6.4 P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.6.6.1.



4.2.1.6.7    C̲a̲n̲c̲e̲l̲ ̲P̲e̲r̲i̲o̲d̲i̲c̲ ̲T̲i̲m̲e̲o̲u̲t̲



4.2.1.6.7.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         This procedure cancels the previously requested periodic
         timeout.



4.2.1.6.7.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲f̲i̲n̲i̲t̲i̲o̲n̲

         Call Specification

         a)  CANCEL ̲PERIODIC ̲TIMEOUT (  )
         b)  CANCEL ̲PERIODIC ̲TIMEOUT (R6)

         Register Convention

         Call Registers

                 R6             LINK          (DEST)

         Return Registers

                 R0-R7                        (DEST)





4.2.1.6.7.3 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             S ̲REQUEST ̲TIME

         c)  Local Data

             None



4.2.1.6.7.4 P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.6.7.1.



4.2.1.6.8    R̲e̲m̲o̲v̲e̲ ̲U̲s̲e̲r̲ ̲C̲o̲n̲n̲e̲c̲t̲i̲o̲n̲ 



4.2.1.6.8.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         The purpose of this procedure is to disconnect the
         connections to the terminal.



4.2.1.6.8.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲f̲i̲n̲i̲t̲i̲o̲n̲

         Call Specification

         a)  REMOVE ̲USER ̲CONNECTION (  )
         b)  REMOVE ̲USER ̲CONNECTION (R6)

         Register Convention

         Call Registers

                 R6             LINK          (DEST)

         Return Registers

                 R0-R7                        (DEST)





4.2.1.6.8.3 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             FORMAT ̲IFCB
             HEADER ̲IFCB

         c)  Local Data

             Refer source list



4.2.1.6.8.4 P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.6.8.1.



4.2.1.6.9    C̲h̲e̲c̲k̲ ̲V̲D̲U̲ ̲A̲t̲t̲r̲i̲b̲u̲t̲e̲s̲



4.2.1.6.9.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         This procedure investigates the length of OMQ, IMQ
         and MDQ depending on current mode (MSO or MDCO mode).

         If the length is equal to zero and the corresponding
         VDU field is inverted then the inversion is removed.

         If the length is unequal to zero then the corresponding
         VDU field is inverted.



4.2.1.6.9.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲f̲i̲n̲i̲t̲i̲o̲n̲

         Call Specification

         a)  CHECK ̲VDU ̲ATTR (  )
                 (CMD:SEC ̲IO ̲CMD;
                 FIRST ̲FIELD,
                 SEC ̲FIELD:INTEGER)



         b)  CHECK ̲VDU ̲ATTR (R1,R2,R3,R6)

         Register Convention

         Call Registers

                 R6             LINK          (DEST)

         Return Registers

                 R1             CMD
                 R2             FIRST ̲FIELD
                 R3             SEC ̲FIELD
                 R0,R4-R7                     (DEST)



4.2.1.6.9.3 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             INIT ̲AREA
             IMQ ̲PREC
             OMQ ̲PREC
             MDQ ̲PREC
             IMQ ̲INVERT (m)
             OMQ ̲INVERT (m)
             MDQ ̲INVERT (m)

         c)  Local Data

             Refer source list



4.2.1.6.9.4 P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.1.6.9.1.


4.2.2    M̲e̲s̲s̲a̲g̲e̲ ̲S̲e̲r̲v̲i̲c̲e̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲S̲u̲b̲p̲a̲c̲k̲a̲g̲e̲ ̲(̲M̲A̲F̲C̲O̲)̲

         MAFCO Controls the execution of Message Service Transactions,
         thereby controlling the functional behaviour of VDIA
         and MART.

         Control is imposed by issue of commands and reception
         of answers.

         MAFCO is controlled by MAVCO with respect to if and
         which transactions may be executed. MAVCO control is
         imposed by use of commands and answers to commands.



4.2.2.1  F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         The subpackage has the functional responsibilities
         as listed below:

         -   React on MAVCO control Commands

         -   Execution of f/c key entered commands

         -   MSA command validation

         -   Transaction Sequencing Control

         -   Transaction Accounting

         -   Transaction Interruption 

         -   Sending Request to the CAMPS System

         -   MSA Command Execution 

         Refer fig. 4.2.2.1-1 through 4.2.2.l-2




















































                     FIGURE 4.2.2.1-1
              MAFCO FUNCTIONAL SPECIFICATION




















































                     FIGURE 4.2.2.1-2
              MSA COMMAND EXECUTION FUNCTION


4.2.2.1.1    M̲A̲F̲C̲O̲ ̲S̲o̲f̲t̲w̲a̲r̲e̲ ̲E̲r̲r̲o̲r̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲s̲ ̲(̲1̲.̲0̲)̲

         a)  Q̲u̲e̲u̲e̲ ̲E̲r̲r̲o̲r̲ ̲R̲e̲p̲o̲r̲t̲i̲n̲g̲ ̲(̲1̲.̲1̲)̲

             Reports to SSC that an unexpected or erroneous
             queue element has been received. 

         b)  I̲n̲t̲e̲r̲n̲a̲l̲ ̲E̲r̲r̲o̲r̲ ̲R̲e̲p̲o̲r̲t̲i̲n̲g̲ ̲(̲1̲.̲2̲)̲

             Reports to SSC that an unexpected (illegal) event
             has occurred during Software execution.



4.2.2.1.2    F̲/̲C̲ ̲K̲e̲y̲ ̲C̲o̲m̲m̲a̲n̲d̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲s̲ ̲(̲2̲.̲0̲)̲

         a)  D̲i̲s̲p̲l̲a̲y̲ ̲E̲r̲r̲o̲r̲ ̲M̲e̲s̲s̲a̲g̲e̲ ̲(̲2̲.̲1̲)̲

             Reads and validates a number entered in the command
             line of the VDU Header Area. If the number is valid
             the corresponding error message is displayed otherwise
             an error message indicating the parameter error
             is displayed. 

         b) D̲i̲s̲p̲l̲a̲y̲ ̲P̲a̲r̲e̲n̲t̲ ̲M̲e̲n̲u̲ ̲(̲2̲.̲2̲)̲

             Fetches the parent Menu of the Menu currently displayed
             and displayes it in the VDU Format Area. 

         c) M̲S̲A̲ ̲C̲o̲m̲m̲a̲n̲d̲ ̲E̲x̲e̲c̲u̲t̲i̲o̲n̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲s̲ ̲(̲2̲.̲3̲)̲

             These are the functions for execution of message
             service commands identified by command code and
             command parameters. (Refer section 4.2.2.l.4)



4.2.2.1.3    M̲A̲V̲C̲O̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲s̲ ̲(̲3̲.̲0̲)̲

         a)  S̲t̲a̲r̲t̲ ̲M̲A̲F̲C̲O̲ ̲P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲ ̲(̲3̲.̲1̲)̲

             MAFCO Software is activated in the normal operation
             mode. This includes display of the Main Menu, opening
             for f/c key input from the VDU Header Area and
             positioning of the Cursor in the command line of
             the VDU Header Area.



         b) S̲t̲o̲p̲ ̲M̲A̲F̲C̲O̲ ̲P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲ ̲(̲3̲.̲2̲)̲

             The MAFCO Software is deactivated. This includes
             clearing of the VDU screen (if possible) and work
             space. After deactivation the MAFCO Software will
             await a start command. 

         c)  C̲l̲o̲s̲e̲ ̲M̲A̲F̲C̲O̲ ̲P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲ ̲(̲3̲.̲3̲)̲

             The MAFCO Software is deactivated. This includes
             clearing of the VDU screen (if possible) and of
             work space. After deactivation MAFCO cannot be
             activated again, (i.e. MAFCO activation requires
             initialization or restart of the entire MSA process.)



4.2.2.1.4    M̲S̲A̲ ̲C̲o̲m̲m̲a̲n̲d̲ ̲E̲x̲e̲c̲u̲t̲i̲o̲n̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲s̲ ̲2̲.̲3̲)̲

         a)  M̲S̲A̲ ̲C̲o̲m̲m̲a̲n̲d̲ ̲V̲a̲l̲i̲d̲a̲t̲i̲o̲n̲ ̲(̲2̲.̲3̲.̲l̲)̲

             Reads the Command (Command Code and parameters)
             entered in the commandline of the VDU Header Area.
             Validates the command - this includes:

             1)  Command Code Validation

             2)  Parameter Syntax check, if applicable and 1)
                 above was successfull

             3)  Semantic check af parameters, if applicable
                 and 1) and 2) above were successfull. 

             If validation is unsuccessfull an appropriate error
             message is displayed, identifying the error or
             in case more than one error was detected the numbers
             of the applicable errormessages are displayed in
             the responseline of the VDU Header Area. 

         b)  T̲r̲a̲n̲s̲a̲c̲t̲i̲o̲n̲ ̲E̲x̲e̲c̲u̲t̲i̲o̲n̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲s̲ ̲(̲2̲.̲3̲.̲2̲)̲

             These are the functions for execution of transactions.
             The transaction type to be executed is indentified
             through entry of a message service command (refer
             4.2.2.l.4 a) above). Display of Menus on command
             are included in these functions as well. 
             Refer 4.2.2.1.5



         c)  S̲e̲n̲d̲ ̲R̲e̲q̲u̲e̲s̲t̲ ̲t̲o̲ ̲C̲A̲M̲P̲S̲ ̲(̲2̲.̲3̲.̲3̲)̲

             These are the functions issuing retrieval requests
             to SAR, preparation and status requests to UMAM,
             distribution requests to MDP and rerun requests
             to THP.



4.2.2.1.5    T̲r̲a̲n̲s̲a̲c̲t̲i̲o̲n̲ ̲E̲x̲e̲c̲u̲t̲i̲o̲n̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲s̲ ̲(̲2̲.̲3̲.̲2̲)̲

         a)  T̲r̲a̲n̲s̲a̲c̲t̲i̲o̲n̲ ̲A̲c̲c̲o̲u̲n̲t̲i̲n̲g̲ ̲(̲2̲.̲3̲.̲2̲.̲1̲)̲

             These are the functions for transaction accounting
             and logging.
             Refer 4.2.2.1.6

         b)  T̲r̲a̲n̲s̲a̲c̲t̲i̲o̲n̲ ̲S̲e̲q̲u̲e̲n̲c̲e̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲(̲2̲.̲3̲.̲2̲.̲2̲)̲

             These are the functions for controlling the transaction
             in progress with respect to display of correct
             formats in right sequence possibly directed through
             the use af f/c keys. 

         c)  T̲r̲a̲n̲s̲a̲c̲t̲i̲o̲n̲ ̲i̲n̲t̲e̲r̲u̲p̲t̲i̲o̲n̲s̲ ̲(̲2̲.̲3̲.̲2̲.̲3̲)̲

             These are the functions for interruption of a transaction
             in progress, i.e.  interruption of the transaction
             sequence control. (refer 4.2.2.l.5 b) above)



4.2.2.l.6    T̲r̲a̲n̲s̲a̲c̲t̲i̲o̲n̲ ̲A̲c̲c̲o̲u̲n̲t̲i̲n̲g̲ ̲(̲2̲.̲3̲.̲2̲.̲1̲)̲

         a)  I̲n̲i̲t̲i̲a̲l̲ ̲L̲O̲G̲ ̲d̲a̲t̲a̲ ̲c̲o̲l̲l̲e̲c̲t̲i̲o̲n̲ ̲(̲2̲.̲3̲.̲2̲.̲l̲.̲l̲)̲

             Assigns a transaction serial number and fetches
             the current time.

         b)  F̲i̲n̲a̲l̲ ̲l̲o̲g̲ ̲d̲a̲t̲a̲ ̲c̲o̲l̲l̲e̲c̲t̲i̲o̲n̲ ̲(̲2̲.̲3̲.̲2̲.̲l̲.̲2̲)̲

             Collection of log format indentification, exit
             cause, termination time and item reference (if
             applicable)



         c)   F̲o̲r̲m̲a̲t̲ ̲I̲/̲O̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲(̲2̲.̲3̲.̲2̲.̲2̲.̲3̲)̲

             These are the functions for input/output of formats
             and data to the VDU Format Area, i.e. VDIA communication
             functions. 

         d)  M̲e̲s̲s̲a̲g̲e̲ ̲H̲a̲n̲d̲l̲i̲n̲g̲ ̲T̲r̲a̲n̲s̲a̲c̲t̲i̲o̲n̲ ̲S̲e̲q̲u̲e̲n̲c̲e̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲(̲2̲.̲3̲.̲2̲.̲2̲.̲4̲)̲

             These are the functions for message related transactions
             and includes: CIF creation, deletion and manipulation,
             identification of valid guidance- and control f/c
             keys at each stage of the transaction sequence,
             identification of requests to be issued to the
             CAMPS System. 



4.2.2.2  S̲o̲f̲t̲w̲a̲r̲e̲ ̲S̲t̲r̲u̲c̲t̲u̲r̲e̲

         The software structure od MAFCO is shown on figure
         4.2.2.2-1 and 4.2.2.2-2.

         MAFCO consists of one coroutine containing 25 modules
         and 61 common procedures.

         The modules on figure 4.2.2.2-1 except box 5.0 and
         12.0 are common for MSA and SVUP and only a brief description
         of these modules will be given in this document. For
         further information refer CPS/SDS/035.

         Common subpackage procedures are shown on figure 4.2.2.2-3
         thru 4.2.2.2-6.



4.2.2.2.1    S̲F̲C̲O̲ ̲M̲a̲i̲n̲ ̲(̲1̲.̲0̲)̲

         This module implements the function described in 4.2.2.1.3.



4.2.2.2.2    F̲/̲C̲ ̲K̲e̲y̲ ̲C̲o̲m̲m̲a̲n̲d̲ ̲E̲x̲e̲c̲u̲t̲i̲o̲n̲ ̲(̲2̲.̲0̲)̲

         This module implements the functions described in 4.2.2.1.2.





















































                     FIGURE 4.2.2.2-1
                 MAFCO SOFTWARE STRUCTURE



















































                     FIGURE 4.2.2.2-2
                 MAFCO SOFTWARE STRUCTURE



















































                     FIGURE 4.2.2.2-3




















































                     FIGURE 4.2.2.2-4



















































                     FIGURE 4.2.2.2-5



















































                     FIGURE 4.2.2.2-6


4.2.2.2.3    V̲a̲l̲i̲d̲a̲t̲e̲ ̲C̲o̲m̲m̲a̲n̲d̲ ̲(̲3̲.̲0̲)̲

         This module implements the function described in 4.2.2.1.4.a.



4.2.2.2.4    F̲u̲l̲l̲ ̲P̲a̲r̲a̲m̲e̲t̲e̲r̲ ̲C̲h̲e̲c̲k̲ ̲(̲4̲.̲0̲)̲

         This module performs the syntax and semantic check
         of the parameter entered in the command line.



4.2.2.2.5    M̲S̲A̲ ̲C̲o̲m̲m̲a̲n̲d̲ ̲V̲a̲l̲i̲d̲a̲t̲i̲o̲n̲ ̲(̲5̲.̲0̲)̲

         The purpose of this module is to preset global variables
         for each MSA command.



4.2.2.2.6    E̲x̲e̲c̲u̲t̲e̲ ̲T̲r̲a̲n̲s̲a̲c̲t̲i̲o̲n̲ ̲(̲6̲.̲0̲)̲

         Implements the functions for initial log data collection
         and calls System Sequence Control.



4.2.2.2.7    S̲y̲s̲t̲e̲m̲ ̲S̲e̲q̲u̲e̲n̲c̲e̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲(̲7̲.̲0̲)̲

         Implements the control functions described in section
         4.2.2.1.5.b)



4.2.2.2.8    E̲x̲e̲c̲u̲t̲e̲ ̲S̲y̲s̲t̲e̲m̲ ̲S̲e̲q̲u̲e̲n̲c̲e̲ ̲(̲8̲.̲0̲)̲

         Implements the functions described in 4.2.2.1.6 c)
         and d) apart from F/C key identification.



4.2.2.2.9    T̲r̲a̲n̲s̲a̲c̲t̲i̲o̲n̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲(̲9̲.̲0̲)̲

         Implements the functions described in section 4.2.2.1.6
         a) and b).




4.2.2.2.10   S̲V̲U̲P̲ ̲E̲x̲c̲e̲p̲t̲i̲o̲n̲ ̲(̲1̲0̲.̲0̲)̲

         The procedure terminates a transaction in progress
         and is called when a command is received from MAVCO
         while a transaction is in progress.



4.2.2.2.11   C̲o̲m̲m̲a̲n̲d̲ ̲C̲o̲n̲f̲i̲r̲m̲a̲t̲i̲o̲n̲ ̲(̲1̲1̲.̲0̲)̲

         Displays restrictive warning text if present. Inputs
         and validates command confirmation code.



4.2.2.2.12   E̲x̲e̲c̲u̲t̲e̲ ̲M̲S̲A̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲ ̲(̲1̲2̲.̲0̲)̲

         Implements the functions described in section 4.2.2.1.6
         d) apart from F/C key identification, as well as those
         in 4.2.2.1.5 b) and c).



4.2.2.2.13   S̲e̲n̲d̲ ̲A̲c̲t̲i̲o̲n̲ ̲(̲1̲3̲.̲0̲)̲

         Sends the message currently displayed on the VDU for
         conversion or distribution. Waits for the next event
         which must be one of the following:

         -   F/C key input request
         -   stop or close command from MAVCO
         -   an acknowledge

         This module contains two module components.



4.2.2.2.14   M̲A̲S̲S̲ ̲A̲n̲s̲w̲e̲r̲ ̲Q̲u̲e̲u̲e̲ ̲P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲ ̲(̲1̲4̲.̲0̲)̲

         This module awaits and validates acknowledges received
         from the Answer queue in case of:

         -   alternative distribution
         -   garble correction
         -   RI-assignment
         -   abb. service message preparation.





4.2.2.2.15   S̲V̲C̲ ̲H̲a̲n̲d̲l̲i̲n̲g̲ ̲(̲1̲5̲.̲0̲)̲

         This module handles acknowledges received concerning
         abbreviated service messages. If the transmission request
         is rejected then the message is included in the Preparation
         database. One module component is contained in this
         module.



4.2.2.2.16   C̲r̲e̲a̲t̲e̲ ̲N̲e̲w̲ ̲V̲i̲e̲w̲ ̲(̲1̲6̲.̲0̲)̲

         The purpose of this module is to create a new view
         of an existing CIF. The new view will be opened.



4.2.2.2.17   U̲M̲A̲M̲ ̲R̲e̲q̲u̲e̲s̲t̲ ̲(̲1̲7̲.̲0̲)̲

         Sends a request of specified type to UMAM. Waits for
         the next event which must be one of the following:

         -   F/C key input
         -   stop or close command from MAVCO
         -   an acknowledge from UMAM

         This module contains 6 module components.



4.2.2.2.18   C̲r̲e̲a̲t̲e̲ ̲N̲e̲w̲ ̲C̲I̲F̲ ̲V̲e̲r̲s̲i̲o̲n̲ ̲(̲1̲8̲.̲0̲)̲

         Creates and opens a new version of an existing CIF.



4.2.2.2.19   C̲r̲e̲a̲t̲e̲ ̲N̲e̲w̲ ̲C̲I̲F̲ ̲(̲1̲9̲.̲0̲)̲

         Creates and opens a new CIF. The access profile is
         set in accordance with current subprocess profile.



4.2.2.2.20   R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲R̲e̲q̲u̲e̲s̲t̲ ̲(̲2̲0̲.̲0̲)̲

         Sends a request of specified type to SAR. Waits for
         the next event which must be one of the following:

         -   F/C key input
         -   stop or close command from MAVCO
         -   an acknowledge from SAR

         This module contains 4 component procedures.





4.2.2.2.21   G̲e̲t̲ ̲F̲i̲r̲s̲t̲ ̲(̲2̲1̲.̲0̲)̲

         Receives the first item in a specified queue by call
         of common procedure.



4.2.2.2.22   G̲e̲t̲ ̲N̲e̲x̲t̲ ̲(̲2̲2̲.̲0̲)̲

         Receives the next item in a specified queue by call
         of common procedures.



4.2.2.2.23   R̲e̲c̲e̲i̲v̲e̲ ̲F̲i̲r̲s̲t̲ ̲(̲2̲3̲.̲0̲)̲

         Implements the functions for reception of the first
         item in a queue. The input validated and the CIF will
         be opened.



4.2.2.2.24   R̲e̲c̲e̲i̲v̲e̲ ̲N̲e̲x̲t̲ ̲(̲2̲4̲.̲0̲)̲

         Implements the functions for reception of the item
         next to the one given as input. The received item is
         validated and the CIF will be opened.



4.2.2.2.25   C̲a̲l̲c̲u̲l̲a̲t̲e̲ ̲M̲A̲S̲S̲ ̲F̲o̲r̲m̲a̲t̲ ̲(̲2̲5̲.̲0̲)̲

         Validates the input received from one of the common
         queues and sets up the format in which the item received
         shall be displayed. One module component is contained
         in this module.



4.2.2.3  D̲a̲t̲a̲ ̲F̲l̲o̲w̲ ̲a̲n̲d̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲ ̲W̲i̲t̲h̲i̲n̲ ̲M̲A̲F̲C̲O̲

         An overview of the dataflow through MAFCO is given
         in diagrams 4.2.2.3-1 to 4.2.2.3-5.

         The call structure within MAFCO is shown in figure
         4.2.2.2-1 to 2 identifying all calls between modules.

         The calls of common procedures are shown in figure
         4.2.2.3-6 to 20.



















































                     FIGURE 4.2.2.3-1
                        SFCO MAIN



















































                     FIGURE 4.2.2.3-2
                     F/C KEY COMMANDS



















































                     FIGURE 4.2.2.3-3
                    TRANSACTION EXEC.



















































                     FIGURE 4.2.2.3-4
                     EXECUTE SEQUENCE



















































                     FIGURE 4.2.2.3-5
                   TRANSACTION CONTROL



















































                     FIGURE 4.2.2.3-6
                  MODULE CALL STRUCTURE


4.2.2.4  M̲A̲F̲C̲O̲ ̲M̲o̲d̲u̲l̲e̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲



4.2.2.4.1    S̲F̲C̲O̲ ̲M̲a̲i̲n̲

         (Refer CPS/SDS/035 sec. 4.2.2.4)



4.2.2.4.2    F̲/̲C̲ ̲K̲e̲y̲ ̲C̲o̲m̲m̲a̲n̲d̲ ̲E̲x̲e̲c̲u̲t̲i̲o̲n̲

         (Refer CPS/SDS/035 sec. 4.2.2.4)



4.2.2.4.3    V̲a̲l̲i̲d̲a̲t̲e̲ ̲C̲o̲m̲m̲a̲n̲d̲

         (Refer CPS/SDS/035 sec. 4.2.2.4)



4.2.2.4.4    E̲x̲e̲c̲u̲t̲e̲ ̲T̲r̲a̲n̲s̲a̲c̲t̲i̲o̲n̲

         (Refer CPS/SDS/035 sec. 4.2.2.4)



4.2.2.4.5    F̲u̲l̲l̲ ̲P̲a̲r̲a̲m̲e̲t̲e̲r̲ ̲C̲h̲e̲c̲k̲

         (Refer CPS/SDS/035 sec. 4.2.2.4)



4.2.2.4.6    S̲y̲s̲t̲e̲m̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲S̲e̲q̲u̲e̲n̲c̲e̲

         (Refer CPS/SDS/035 sec. 4.2.2.4)



4.2.2.4.7    E̲x̲e̲c̲u̲t̲e̲ ̲S̲y̲s̲t̲e̲m̲ ̲S̲e̲q̲u̲e̲n̲c̲e̲

         (Refer CPS/SDS/035 sec. 4.2.2.4)



4.2.2.4.8    T̲r̲a̲n̲s̲a̲c̲t̲i̲o̲n̲ ̲C̲o̲n̲t̲r̲o̲l̲

         (Refer CPS/SDS/035 sec. 4.2.2.4)





4.2.2.4.9    C̲o̲m̲m̲a̲n̲d̲ ̲C̲o̲n̲f̲i̲r̲m̲a̲t̲i̲o̲n̲

         (Refer CPS/SDS/035 sec. 4.2.2.4)



4.2.2.4.10   S̲V̲U̲P̲ ̲E̲x̲c̲e̲p̲t̲i̲o̲n̲

         (Refer CPS/SDS/035 sec. 4.2.2.4)



4.2.2.4.11   A̲n̲s̲w̲e̲r̲ ̲Q̲u̲e̲u̲e̲ ̲P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲



4.2.2.4.11.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         The purpose of this module is to await and validate
         acknowledges received in the Answer queue.

         The module will be activated in case of:

         -   alternative distribution
         -   garble correction
         -   RI assignment
         -   abbreviated service message preparation

         The type of acknowledge will be determined and if an
         invalid element is received then an error report will
         be generated.



4.2.2.4.11.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  MASS ̲ANQ ̲PROC (CC:EXIT ̲CC)
         b)  MASS ̲ANQ ̲PROC (R5,R6)

         Register Convention

         Call Register

             R6                 LINK            (DEST)


         Return Register

             R5                 CC
             R0-R4, R6-R7                       (DEST)




4.2.2.4.11.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲

         None



4.2.2.4.11.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             ANQ ̲OP ̲PT
             ANQ ̲QEL (m)
             ANQ ̲ATTR (m)

         c)  Local Data

             Refer source list for this module.



4.2.2.4.11.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.11.1.



4.2.2.4.12   C̲a̲l̲c̲u̲l̲a̲t̲e̲ ̲M̲A̲S̲S̲ ̲F̲o̲r̲m̲a̲t̲


4.2.2.4.12.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         This module validates input received from one of the
         following queues:

         -   MDCO ̲MDQ
          ̲   MSO ̲IMQ
          ̲   MSO ̲OMQ

         The attributes are inspected and the format in which
         the message shall be displayed is calculated. If any
         of the parameters are invalid then an error report
         is generated. Furthermore the text to be displayed
         in the VDU header is calculated. In case of Garble
         Correction the reason for diversion is collected.




4.2.2.4.12.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  CAL ̲MASS ̲FOR (ATTRIBUTES: QEL ̲ATTRIBUTES)
                          (CC:EXIT ̲CC):EXIT ̲CC

         b)  CAL ̲MASS ̲FOR (R0,R4,R6):EXIT ̲CC

         Register Convention

         Call Register

             R4       POINTER TO ATTRIBUTES     (DEST)
             R6                 LINK            (DEST)

         Return Registers

             R0                 CC
             R1-R7                              (DEST)


4.2.2.4.12.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲



4.2.2.4.12.3.1 E̲X̲T̲R̲A̲C̲T̲ ̲M̲D̲C̲O̲ ̲D̲E̲L̲V̲ ̲B̲I̲T̲S̲

         The reason for sending a message for Incoming Distribution
         Assistance is delivered by MDP in a bitmask.
         This bitmask is analyzed and the bits are counted and
         converted.



4.2.2.4.12.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             ACCOUNT ̲AREA.NO ̲OF ̲DELV ̲CODES (m)
             ACCOUNT ̲AREA.DELV ̲BITS (m)
             PROBLEM ̲NO (m)
             HD ̲TXT (m)
             SEQ ̲REC.NEW ̲FORMAT (m)

         c)  Local Data

             Refer source list for this module.





4.2.2.4.12.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.12.1.



4.2.2.4.13   S̲e̲n̲d̲ ̲A̲c̲t̲i̲o̲n̲


4.2.2.4.13.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         The message currently displayed on the VDU is sent
         to THP, OAS or MDP for conversion or distribution and
         an acknowledge will be awaited. The next event will
         be one of the following:

         -   F/C key input
         -   stop or close command
         -   an acknowledge

         -   If an F/C key is received then a response message
             will be displayed on the VDU.
         -   If a Stop or Close Down command is received then
             the acknowledge will be awaited and the message
             will be returned to the queue to which it belongs.
         -   The acknowledge received is analyzed.
             If the message is returned for further assistance
             then an open-request will be issued.



4.2.2.4.13.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  THP ̲MDP ̲SEND ̲ACTION (FUNCTION:MDP ̲THP ̲SEND ̲TYPE)
                                 (STATE: SEQ ̲STATE ̲TYPE)

         b)  THP ̲MDP ̲SEND ̲ACTION (R0,R5,R6)

         Register Convention

         Call Register

             R0                 FUNCTION        (DEST)
             R6                 LINK            (DEST)

         Return Register

             R5                 STATE
             R0-R4,R6-R7                        (DEST)




4.2.2.4.13.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲



4.2.2.4.13.3.1 S̲E̲T̲ ̲C̲O̲D̲E̲

         The purpose of this procedure is to setup the Sequence
         Table keys for reception of the next entry in the current
         queue.



4.2.2.4.13.3.2 F̲A̲T̲A̲L̲ ̲E̲R̲R̲O̲R̲

         The purpose of this procedure is to collect parameters
         required for reporting of internal errors.



4.2.2.4.13.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             CURRENT ̲MAINQUEUE
             SEQ ̲TABLE ̲KEY (m)
             INPUT ̲CIF (m)
             OUTPUT ̲CIF (m)
             ANQ ̲OP ̲PT
             CURRENT ̲SUBQUEUE (m)
             ANQ ̲QEL (m)
             ANQ ̲ATTR
             SVUP ̲RECV ̲ATTR (m)
             ANS ̲FLAG (m)

         c)  Local Data

             Refer source list for this module



4.2.2.4.13.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.13.1 and figure 4.2.2.4.13-1



 CASE  SEND TYPE OF

     MSO ̲INSP? - OUTPUT ̲CIF = INPUT ̲CIF

     OTHERWISE? - T̲E̲P̲ ̲D̲I̲S̲M̲A̲N̲T̲L̲E̲(̲I̲N̲P̲U̲T̲ ̲C̲I̲F̲)̲

 END ̲CASE

 CASE SEND ̲TYPE OF

     MSO ̲GARB,

     MSO ̲INSP? - S̲E̲N̲D̲ ̲T̲H̲P̲(̲S̲E̲N̲D̲ ̲T̲Y̲P̲E̲)̲

     MSO ̲RIAS? - S̲E̲N̲D̲ ̲T̲H̲P̲(̲S̲E̲N̲D̲ ̲T̲Y̲P̲E̲)̲

     MDO ̲ALTE,

     MDO ̲INCO? - S̲E̲N̲D̲ ̲M̲D̲P̲(̲S̲E̲N̲D̲ ̲T̲Y̲P̲E̲)̲

     MSO ̲OCR?  - S̲E̲N̲D̲ ̲O̲C̲R̲(̲S̲E̲N̲D̲ ̲T̲Y̲P̲E̲)̲

     OTHERWISE? - F̲A̲T̲ ̲E̲R̲R̲(̲1̲)̲

 END CASE

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

 R̲E̲Q̲U̲E̲S̲T̲ ̲A̲N̲Q̲ ̲I̲N̲P̲U̲T̲

 W̲A̲I̲T̲ ̲A̲N̲Q̲ ̲I̲N̲P̲U̲T̲(̲-̲2̲)̲

















               FIGURE 4.2.2.4.13-1
                   SEND ̲ACTION


 REPEAT

     W̲A̲I̲T̲ ̲S̲F̲C̲O̲ ̲E̲V̲E̲N̲T̲(̲W̲O̲R̲K̲4̲ ̲S̲T̲A̲T̲E̲)̲(̲A̲N̲Q̲ ̲O̲P̲)̲

     CASE ANQ ̲OP.ID OF

         FC ̲KEY ̲ID? - D̲I̲S̲P̲L̲A̲Y̲ ̲R̲E̲S̲P̲ ̲M̲S̲G̲ ̲(̲C̲A̲M̲P̲S̲ ̲B̲U̲S̲Y̲)̲

                      LOOPEXIT = FALSE

         VCO ̲ID? -    M̲A̲S̲S̲ ̲A̲N̲Q̲ ̲P̲R̲O̲C̲(̲C̲C̲)̲

                      CC NE S ̲OPEN?

                      R̲E̲T̲U̲R̲N̲ ̲C̲I̲F̲ ̲T̲O̲ ̲Q̲U̲E̲U̲E̲ ̲(̲A̲N̲Q̲ ̲Q̲E̲L̲)̲

                      T̲E̲P̲ ̲D̲I̲S̲M̲A̲N̲T̲L̲E̲ ̲(̲A̲N̲Q̲ ̲Q̲E̲L̲)̲

         ANQ ̲ID? -    M̲A̲S̲S̲ ̲A̲N̲Q̲ ̲P̲R̲O̲C̲ ̲(̲C̲C̲)̲

                      CASE CC OF

                         S ̲QERROR? - D̲I̲S̲P̲L̲A̲Y̲ ̲R̲E̲S̲P̲ ̲M̲S̲G̲(̲C̲P̲S̲
                         ̲F̲A̲I̲L̲U̲R̲E̲)̲

                         S ̲QEL?    - S̲E̲T̲ ̲C̲O̲D̲E̲

                         S ̲OPEN?   - O̲P̲E̲N̲ ̲A̲C̲T̲I̲O̲N̲(̲-̲3̲)̲

                         OTHERWISE?- F̲A̲T̲ ̲E̲R̲R̲(̲2̲)̲

                      END CASE

         OTHERWISE? - F̲A̲T̲ ̲E̲R̲R̲(̲3̲)̲

     END CASE

 UNTIL LOOPEXIT = TRUE












               FIGURE 4.2.2.4.13-2
                  WAIT ̲ANQ ̲INPUT


 R̲E̲Q̲U̲E̲S̲T̲ ̲O̲P̲E̲N̲ ̲C̲I̲F̲(̲A̲N̲Q̲ ̲Q̲E̲L̲)̲

 REPEAT

     W̲A̲I̲T̲ ̲S̲F̲C̲O̲ ̲E̲V̲E̲N̲T̲(̲W̲O̲R̲K̲7̲ ̲S̲T̲A̲T̲E̲)̲(̲O̲P̲E̲N̲ ̲O̲P̲)̲

     CASE  OPEN ̲OP.IF OF

         …02…FC ̲KEY ̲ID? - D̲I̲S̲P̲L̲A̲Y̲ ̲R̲E̲S̲P̲ ̲M̲S̲G̲ ̲(̲C̲A̲M̲P̲S̲ ̲B̲U̲S̲Y̲)̲

                          OPENLOOP=FALSE

             VCO ̲ID?    - W̲A̲I̲T̲ ̲O̲P̲E̲N̲ ̲C̲I̲F̲(̲C̲C̲)̲

                          R̲E̲T̲U̲R̲N̲ ̲C̲I̲F̲ ̲T̲O̲ ̲Q̲U̲E̲U̲E̲(̲A̲N̲Q̲ ̲Q̲E̲L̲)̲

                          T̲E̲P̲ ̲D̲I̲S̲M̲A̲N̲T̲L̲E̲(̲A̲N̲Q̲ ̲Q̲E̲L̲)̲

             OPEN ̲CIF ̲ID?-W̲A̲I̲T̲ ̲O̲P̲E̲N̲ ̲C̲I̲F̲(̲C̲C̲)̲

                          CASE  CC  OF

                             O ̲STOPPED? - T̲E̲P̲ ̲D̲I̲S̲M̲A̲N̲T̲L̲E̲(̲A̲N̲Q̲
                             ̲Q̲E̲L̲)̲

                                          D̲I̲S̲P̲L̲A̲Y̲ ̲R̲E̲S̲P̲
                                     ̲M̲S̲G̲(̲D̲E̲L̲E̲T̲E̲D̲)̲

                             O ̲NOT ̲OPEN?- R̲E̲T̲U̲R̲N̲ ̲C̲I̲F̲
                             ̲T̲O̲ ̲Q̲U̲E̲U̲E̲
                                                   
                                     (̲A̲N̲Q̲ ̲Q̲E̲L̲)̲

                                          T̲E̲P̲ ̲D̲I̲S̲M̲A̲N̲T̲L̲E̲(̲A̲N̲Q̲
                                     ̲Q̲E̲L̲)̲

                             O ̲OPEN?    - S̲E̲T̲ ̲C̲O̲D̲E̲

                             OTHERWISE? - F̲A̲T̲ ̲E̲R̲R̲(̲4̲)̲

                          END CASE

             OTHERWISE? - F̲A̲T̲ ̲E̲R̲R̲(̲5̲)̲

     END CASE

 UNTIL OPENLOOP = TRUE







               FIGURE 4.2.2.4.13-3
                   OPEN ̲ACTION


4.2.2.4.14   E̲x̲e̲c̲u̲t̲e̲ ̲M̲S̲A̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲


4.2.2.4.14.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         Performs the function specified by caller either by
         executing the function itself or by calling another
         module or procedure.

         Completion code will on return have the following value:

             TSTOP,TCLOSE:      Indicates that function execution
                                has been terminated because
                                a MVCO command has been received.
             TEXC:              Indicates that a VDU failure
                                has been detected during function
                                execution.
             TOK:               Indicates that function execution
                                terminated normally.
             TCON:              Indicates that a new set of
                                SEC ̲
                                TABLE ̲KEYS has been fetched
                                and System Sequence shall be
                                called.


4.2.2.4.14.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  EXEC ̲MSA ̲FUNC (OPERATION: TEP ̲COROUTINE ̲OPERATION,
                                CC: SEQ ̲STATE)

         b)  EXEC ̲MSA ̲FUNC (R5,R7,R6)

         Register Convention

         Call Registers

             R6                 LINK            (DEST)

         Return Register

             R5      POINTER TO OPERATION
             R7                 CC
             R0-R4, R6                          (DEST)





4.2.2.4.14.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲



4.2.2.4.14.3.1 M̲A̲F̲C̲O̲ ̲T̲I̲M̲E̲

         Reads current time by call to TIMER ̲MONITOR.



4.2.2.4.14.3.2 M̲A̲F̲C̲O̲ ̲T̲M̲P̲

         Sets up parameters for call of Search Primary Key and
         executes the TMP request.



4.2.2.4.14.3.3 D̲I̲S̲P̲L̲A̲Y̲ ̲S̲M̲P̲R̲ ̲H̲E̲A̲D̲E̲R̲

         This procedure updates the Terminal function and Classification
         fields in the VDU header area.



4.2.2.4.14.3.4 S̲T̲A̲R̲T̲ ̲R̲E̲C̲E̲P̲T̲I̲O̲N̲

         Call the modules and common procedures required for
         receiving the first item in a given queue.



4.2.2.4.14.3.5 K̲E̲E̲P̲ ̲D̲E̲L̲E̲T̲E̲ ̲A̲C̲T̲I̲O̲N̲

         The next item to which the user has access is received
         from current mainqueue. If the F/C key KEEP ̲AND ̲PRESENT
         was depressed then the old item will be returned to
         the queue from where it was received. Otherwise the
         old item will be dismantled.



4.2.2.4.14.3.6 C̲A̲N̲C̲E̲L̲ ̲P̲E̲N̲D̲I̲N̲G̲ ̲V̲D̲I̲A̲

         This procedure sends a Cancel I/O command to VDIA and
         awaits completion of all pending VDIA commands.



4.2.2.4.14.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list.



         b)  External Data

             SFCO ̲TMP ̲KEY1
             SFCO ̲TMP ̲PARAM1    (m)
             INPUT ̲CIF          (m)
             OUTPUT ̲CIF         (m)
             ANS ̲FLAG           (m)
             SEQ ̲REC            (m)
             SVUP ̲RECV ̲ATTR
             SEQ ̲TABLE ̲KEY      (m)
             CURRENT ̲SUBQUEUE   (m)
             INIT ̲AREA
             ANQ ̲ATTR
             ANQ ̲QEL
             CURRENT ̲MAINQUEUE
             CURRENT ̲CLASS      (m)
             CUR ̲IT ̲REF         (m)
             ACCOUNT ̲AREA       (m)
             CIF ̲ATTR
             SUPV ̲CMD ̲REC       (m)

         c)  Local Data

             Refer source list for this module.



4.2.2.4.14.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.14.1 and source list.



4.2.2.4.15   G̲e̲t̲ ̲F̲i̲r̲s̲t̲



4.2.2.4.15.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         Receives by call of common procedures the first item
         in the queue specified by Current Mainqueue. If a Stop
         or Close command is received then a Transaction serial
         number is fetched for Log purpose.





4.2.2.4.15.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specifications

         a)  GET ̲FIRST          (QEL  : QEL ̲REFERENCE,
                                 CC   : ERROR ̲OKAY,
                                 STATE: SEQ ̲STATE)

         b)  GET ̲FIRST (R2,R3,R5,R6)

         Register Convention

         Call Register

             R6                 LINK            (DEST)

         Return Registers

             R2                 QEL
             R3                 CC
             R5                 STATE
             R0-R1,R4,R6-R7                     (DEST)


4.2.2.4.15.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲

         None.


4.2.2.4.15.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             None

         c)  Local Data

             Refer source list



4.2.2.4.15.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.15.1





4.2.2.4.16   G̲e̲t̲ ̲N̲e̲x̲t̲


4.2.2.4.16.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         This module receives by call of common procedures the
         item next to the one specified as input. If a Stop
         or Close command is received then a Transaction serial
         number is fetched for Log purpose.



4.2.2.4.16.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  GET ̲NEXT           (QEL  : QEL ̲REFERENCE)
                                (QEL  : QUE ̲REFERENCE;
                                STATE : SEQ ̲STATE)

         b)  GET ̲NEXT (R2,R5,R6)

         Register Convention

         Call Register

             R2                 QEL             (DEST)
             R6                 LINK            (DEST)

         Return Register

             R2                 QEL
             R5                 SEQ ̲STATE       
         R0-R1, R3-R4, R6-R7                    (DEST)



4.2.2.4.16.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲

         None



4.2.2.4.16.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data Reference
             Refer source list
         b)  External Data
             None
         c)  Local Data
             Refer source list





4.2.2.4.16.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.16.1



4.2.2.4.17   R̲e̲c̲v̲ ̲F̲i̲r̲s̲t̲



4.2.2.4.17.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         The first item in Current Mainqueue is received. The
         attributes are validated and the display format is
         calculated. If the received item is of the type CIF
         then an open request is issued.

         The procedure has the following return points:

         Working:    The reception has terminated successfully

         Stopping:   The reception has been interrupted by a
                     Stop or Close command

         Closing:    A requested Open CIF has been rejected
                     by the system

         If the working exit is used then the result of the
         reception will be returned in a completion code.



4.2.2.4.17.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  RECV ̲FIRST (QEL: QEL ̲REFERENCE,
                         CC: RECV ̲CC): WORK ̲STOP ̲CLOSE
         b)  RECV ̲FIRST (R2,R3,R6): WORK ̲STOP ̲CLOSE

         Register Convention

         Call Register

             R6                 LINK            (DEST)

         Return Register

             R2                 QEL
             R3                 CC
         R0-R1, R4-R6                           (DEST)





4.2.2.4.17.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲

         None



4.2.2.4.17.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             CURRENT ̲MAINQUEUE
             CURRENT ̲SUBQUEUE (m)
             SVUP ̲QNAME (m)
             SVUP ̲RECV ̲ATTR (m)
             SAVE ̲SVCO ̲PTR (m)

         c)  Local Data

             Refer source list.



4.2.2.4.17.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.17.1



4.2.2.4.18   R̲e̲c̲v̲ ̲N̲e̲x̲t̲


4.2.2.4.18.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         The item next to the one given as input is received
         from Current Mainqueue. If the requester has no access
         to the item received then it is returned to the queue
         and the next item is received. If subqueue is empty
         and a mainqueue is specified, then the first item in
         the next subqueue is received.

         If an item is received then the attributes are validated
         and a display format is calculated.

         If the received item is of the type CIF then an open
         request will be issued. The procedure has the following
         return points:





         Working:    The reception has terminated successfully

         Stopping:   The reception procedure has been interrupted
                     by a Stop or Close command

         Closing:    A requested Open CIF has been rejected
                     by the system

         If the working exit is used then the result of the
         reception is returned in a completion code.



4.2.2.4.18.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  RECV ̲NEXT (RECV ̲QEL: QEL ̲REFERENCE)
                       (OUT ̲QEL: QEL ̲REFERENCE,
                        CC: RECV ̲CC): WORK ̲STOP ̲CLOSE
         b)  RECV ̲NEXT (R2,R3,R6): WORK ̲STOP ̲CLOSE

         Register Convention

         Call Register

             R2                 RECV ̲QEL        (DEST)
             R6                 LINK            (DEST)

         Return Register

             R2                 OUT ̲QEL
             R3                 CC
         R0-R1,R4-R7                            (DEST)



4.2.2.4.18.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲

         None


4.2.2.4.18.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data Reference
             Refer source list
         b)  External Data
             SVUP ̲RECV ̲ATTR (m)
             CURRENT ̲SUBQUEUE (m)
             RECV ̲MAIN
             CURRENT ̲MAINQUEUE
             CURRENT ̲CLASS (m)



         c)  Local Data

             Refer source list.



4.2.2.4.18.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.18.1



4.2.2.4.19   C̲r̲e̲a̲t̲e̲ ̲C̲I̲F̲



4.2.2.4.19.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         This procedure creates a CIF and opens it by a call
         to Message Monitor.

         The CIF profile is set in accordance with current subprocess
         profile and message type.



4.2.2.4.19.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  TEP ̲CREATE ̲CIF (QEL: QEL ̲REFERENCE)

         B)  TEP ̲CREATE ̲CIF (R2,R6)

         Register Convention

         Call Registers

             R6                 LINK            (DEST)

         Return Registers

             R2                 QEL             
         R0-R1, R3-R7                           (DEST)



4.2.2.4.19.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲

         None





4.2.2.4.19.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References
             Refer source list

         b)  External Data

             CIF ̲ATTR (m)
             INIT ̲AREA
             SVUP ̲QNAME (m)
             SVUP ̲ARRQ

         c)  Local Data

         Refer source list



4.2.2.4.19.4 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.19.1



4.2.2.4.20   C̲r̲e̲a̲t̲e̲ ̲N̲e̲w̲ ̲C̲I̲F̲ ̲V̲e̲r̲s̲i̲o̲n̲



4.2.2.4.20.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         This procedure creates and opens a new version of an
         existing CIF. The profile of the CIF will be unchanged.



4.2.2.4.20.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  TEP ̲CREATE ̲NEW ̲CIF (INPUT ̲CIF: QEL ̲REFERENCE)
                               (OUTPUT ̲CIF: QEL ̲REFERENCE)

         b)  TEP ̲CREATE ̲NEW ̲CIF (R2,R6)

         Register Convention

         Call Registers

             R2                 INPUT ̲CIF       (DEST)
             R6                 LINK            (DEST)





         Return Registers

             R2                 OUTPUT ̲CIF
         R0-R1, R3-R7                           (DEST)



4.2.2.4.20.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲

         None



4.2.2.4.20.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References
             Refer source list

         b)  External Data

             CIF ̲ATTR (m)
             CUR ̲IT ̲REF (m)
             SVUP ̲QNAME (m)
             SVUP ̲ARRQ

         c)  Local Data

             Refer source list



4.2.2.4.20.4 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.20.1



4.2.2.4.21   C̲r̲e̲a̲t̲e̲ ̲N̲e̲w̲ ̲V̲i̲e̲w̲



4.2.2.4.21.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         Creates a new view of an existing CIF. The view will
         be opened and if the CIF has been stopped (deleted
         by Supervisor) then an error completion is returned.



4.2.2.4.21.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification





         a)  TEP ̲NEW ̲VIEW (OLD ̲CIF: VIEW ̲REFERENCE
                           FIELDS: VIEW ̲TYPE)
                          (NEXT ̲CIF: VIEW ̲REFERENCE,
                           CC: ERROR ̲OK)

         b)  TEP ̲NEW ̲VIEW (R2,R3,R5,R6)

         Register Convention

         Call Registers

             R2                 OLD ̲CIF         (DEST)
             R3                 FIELDS          (DEST)
             R6                 LINK             DEST

         Return Registers

             R2                 NEW ̲CIF
             R5                 CC
         R0-R1,R3-R4,R6-R7                      (DEST)



4.2.2.4.21.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲

         None



4.2.2.4.21.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References

             Refer source list

         b)  External Data

             CIF ̲ATTR (m)
             SVUP ̲QNAME (m)
             SVUP ̲ARRQ

         c)  Local Data

             Refer source list



4.2.2.4.21.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.21.1





4.2.2.4.22   M̲S̲A̲ ̲C̲o̲m̲m̲a̲n̲d̲ ̲V̲a̲l̲i̲d̲a̲t̲i̲o̲n̲



4.2.2.4.22.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         The purpose of this module is to initialize global
         data.

         Current mainqueue will be updated for the commands
         concerning reception. For the message handling commands
         will preparation-and retrieval state be updated.



4.2.2.4.22.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  MSA ̲CMD ̲VAL (CMD: MSA:CMD ̲TYPE): ERROR ̲OK

         b)  MSA ̲CMD ̲VAL (R0,R6): ERROR ̲OK

         Register Convention

         Call Registers

             R0                 CMD             (DEST)
             R6                 LINK            (DEST)

         Return Registers

             R0-R7                              (DEST)



4.2.2.4.22.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲

         None


4.2.2.4.22.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References
             Refer source list

         b)  External Data

             SUPV ̲CMD ̲REC
             CURRENT ̲MAINQUEUE  (m)
             CURRENT ̲PRECQUEUE  (m)


             RECV ̲MAIN          (m)
             ACCOUNT ̲AREA       (m)
             INS ̲DEL ̲ACC        (m)
             INS ̲DEL ̲MAX        (m)

         c)  Local Data

             Refer source list



4.2.2.4.22.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.22.1



4.2.2.4.23   R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲R̲e̲q̲u̲e̲s̲t̲



4.2.2.4.23.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         The data read from all VDU will be sent to SAR and
         an acknowledge will be awaited. The next event will
         be one of the following:

         -   F/C key interrupt
         -   MVCO command
         -   Retrieval notification

         a)  If an F/C key is received then a response message
             will be displayed on the VDU.

         b)  If a Stop or Close Down command is received then
             the module will return a stop completion code to
             the caller.

         c)  In case of an offline notification a response message
             is displayed and the transaction is terminated.

             If an online notification is received then the
             retrieved item is awaited and if a CIF is received
             then an open request is issued.





4.2.2.4.23.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  RETR ̲REQUEST (  )
                          (CC: SEQ ̲STATE)

         b)  RETR ̲REQUEST (R5,R6)

         Register Convention

         Call Registers

             R6                 LINK            (DEST)

         Return Registers

             R5                 CC
         R0-R4, R6-R7                           (DEST)



4.2.2.4.23.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲


4.2.2.4.23.3.1 P̲E̲R̲F̲O̲R̲M̲ ̲F̲C̲ ̲K̲E̲Y̲

         The received F/C key is analyzed and an error message
         is displayed. A new F/C key input request is issued.



4.2.2.4.23.3.2 C̲H̲E̲C̲K̲ ̲S̲T̲A̲T̲E̲

         This procedure checks the specified command against
         the specified state.



4.2.2.4.23.3.3 P̲E̲R̲F̲O̲R̲M̲ ̲O̲P̲E̲N̲ ̲C̲I̲F̲

         An open CIF is initiated and awaited. The procedure
         can be abnormally terminated by a stop command.

         Function keys are accepted but have no effect.



4.2.2.4.23.3.4 A̲N̲A̲L̲Y̲Z̲E̲ ̲R̲E̲C̲E̲I̲V̲E̲D̲ ̲O̲P̲

         The procedure analyzes the received operation, performs
         the corresponding action and returns the operation
         to be pool shared with the Retrieval subpackage.





4.2.2.4.23.3.5 Data Description

         a)  Data References

             Refer source list

         b)  External Data

             INPUT ̲CIF (m)
             SAVE ̲SVCO ̲PTR (m)
             HD ̲TXT
             SEQ ̲TABLE ̲KEY (m)
             RETR ̲OP ̲POOL

         c)  Local Data

             Refer source list.



4.2.2.4.23.3.6 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.23.1.



4.2.2.4.24 U̲M̲A̲M̲ ̲R̲e̲q̲u̲e̲s̲t̲



4.2.2.4.24.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         The purpose of this module is to control the interface
         between MSA and UMAM. A request of the demanded type
         is sent to UMAM and an answer is awaited in the Answer
         queue. The procedure can be abnormally terminated by
         a stop command. Function keys are accepted but have
         no effect.

         When the answer from UMAM arrives then the attributes
         are validated and if a CIF is received then an open
         CIF is initiated.



4.2.2.4.24.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification
         a)  UMAM ̲REQ (REQUEST:MSA ̲UMAM ̲REQ)
                      (CC: SEQ ̲STATE)
         b)  UMAM ̲REQ (R0,R5,R6)

         Register Convention



         Call Registers

             R0                 REQUEST         (DEST)
             R6                 LINK            (DEST)

         Return Registers

             R5                 CC
         R0-R4, R6-R7                           (DEST)



4.2.2.4.24.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲


4.2.2.4.24.3.1 S̲E̲N̲D̲ ̲U̲M̲A̲M̲

         Sets up data for each request type according to interface
         description.



4.2.2.4.24.3.2 V̲A̲L̲ ̲A̲N̲Q̲ ̲I̲N̲P̲U̲T̲

         If an error response is received from UMAM then a response
         message is displayed.

         If the requested CIF is received then an open request
         is initiated and awaited..



4.2.2.4.24.3.3 O̲P̲E̲N̲ ̲A̲C̲T̲I̲O̲N̲

         This procedure analyzes the result of an open CIF and
         performs the corresponding action and returns a completion
         code.



4.2.2.4.24.3.4 U̲M̲A̲M̲ ̲A̲N̲Q̲ ̲P̲R̲O̲C̲

         Awaits acknowledge from UMAM and validates the received
         attributes.



4.2.2.4.24.3.5 C̲H̲E̲C̲K̲ ̲A̲T̲T̲R̲

         Validates the received attributes if an error response
         is received.


4.2.2.4.24.3.6 S̲E̲T̲ ̲C̲O̲D̲E̲

         Sets up sequence table keys in case of reception of
         an error acknowledge.



4.2.2.4.24.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References
             Refer source list

         b)  External Data

             SEQ ̲REC
             SEQ ̲TABLE ̲KEY      (m)
             ANQ ̲OP ̲PT
             ANQ ̲ATTR           (m)
             ANQ ̲QEL            (m)
             INPUT ̲CIF          (m)
             OUTPUT ̲CIF         (m)
             SVUP ̲RECV ̲ATTR     (m)
             SAVE ̲SVCO ̲PTR      (m)
             ACCOUNT ̲AREA
             SVDIA ̲TMP ̲REC ̲PT
             INIT ̲AREA
             SVUP ̲SEND ̲PARAMS   (m)
             SVUP ̲SEND ̲Q        (m)
             SVUP ̲REQ ̲ANS ̲Q     (m)

         c)  Local Data

             Refer source list



4.2.2.4.24.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.24.1



4.2.2.4.25   S̲V̲C̲ ̲H̲a̲n̲d̲l̲i̲n̲g̲





4.2.2.4.25.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         The purpose of this module is to handle acknowledges
         concerning service messages. If the prepared SVC can
         be sent then a response message is displayed and message
         status is updated. If not the SVC can be transmitted
         on the demanded channel then the message will be included
         in the Preparation database.



4.2.2.4.25.2 M̲o̲d̲u̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲

         Call Specification

         a)  THP ̲SVC ̲ACK (ANQ ̲OP: ANQ ̲PENDING)
                         (CC: SEQ ̲STATE)

         b)  THP ̲SVC ̲ACK (R0,R5,R6)

         Register Convention

         Call Registers

             R0                 ANQ ̲OP          (DEST)
             R6                 LINK            (DEST)

         Return Registers

             R5                 CC
         R0-R4, R6-R7                           (DEST)



4.2.2.4.25.3 M̲o̲d̲u̲l̲e̲ ̲C̲o̲m̲p̲o̲n̲e̲n̲t̲s̲



4.2.2.4.25.3.1 T̲HP̲ ̲A̲N̲Q̲ ̲P̲R̲O̲C̲

         The operation is received and the attributes are validated.
         If a CIF is received then it will be sent to UMAM.



4.2.2.4.25.4 D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲

         a)  Data References
             Refer source list



         b)  External Data

             ANQ ̲OP ̲PT
             ANQ ̲ATTR           (m)
             ANQ ̲QEL            (m)
             SEQ ̲REC            (m)
             INPUT ̲CIF          (m)
             OUTPUT ̲CIF         (m)
             SAVE ̲SVCO ̲PTR      (m)

         c)  Local data
             Refer source list



4.2.2.4.25.5 M̲o̲d̲u̲l̲e̲ ̲D̲e̲s̲i̲g̲n̲

         Refer 4.2.2.4.25.1.