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

⟦806aa1f80⟧ Wang Wps File

    Length: 19670 (0x4cd6)
    Types: Wang Wps File
    Notes: CPS/SDS/035               
    Names: »2090A «

Derivation

└─⟦83672169b⟧ Bits:30006105 8" Wang WCS floppy, CR 0165A
    └─ ⟦this⟧ »2090A « 

WangText




…02…CPS/SDS/035

…02…850601…02…
SUPERVISOR VDU
DETAILED DESIGN
 SPECIFICATION
 …02…ISSUE 1…02…CAMPS










       4.1.5 Common Package Procedures ..............
                 
         4.1.5.1 SVUP QUEUE ERROR ...................
                     
         4.1.5.2 SVUP INTERNAL ERROR ................
                     
         4.1.5.3 SVUP DISMANTLE .....................
                     
         4.1.5.3.4 Procedure Design .................
                       
         4.1.5.4 DISPLAY VDU HEADER .................
                     
         4.1.5.5 VALIDATE RETR MSG ..................
                     
         4.1.5.6 SET HEADER TXT FIELD ...............
                     
         4.1.5.7 SET HEADER CLASSIFICATION FIELD ....
                    
         4.1.5.8 Internal Representation to ASCII 
                 Con ................................
                     
         4.1.5.9 ASCII to Internal Representation Con
                     

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

         4.1.7.3 Subpackage I/F .....................
                     
           4.1.7.3.1 Process Interfaces .............
                         
           4.1.7.3.2 Coroutine Interfaces ...........
                         
           4.1.7.3.4 Other I/F ......................
                         


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̲



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



4.1.5.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 purpose of this procedure is to report queue errors
         to the SSC.

         The referenced queue element will be set to nil.



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

         C̲A̲L̲L̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         a)  TEP ̲QUEUE ̲ERR (USER ̲ACTION: USER ̲ACTION ̲TYPE,
                            QEL: QEL ̲REFERENCE,)

         b)  TEP ̲QUEUE ̲ERR (R1, R3, R6)

         R̲e̲g̲i̲s̲t̲e̲r̲ ̲C̲o̲n̲v̲e̲n̲t̲i̲o̲n̲

         C̲a̲l̲l̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         R1      USER ̲ACTION:USER ̲ACTION ̲TYPE    C   D
         R3      QEL:QEL ̲REFERENCE               C   D
         R6      LINK                            C   D

         R̲e̲t̲u̲r̲n̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         None

         R0 - R7                        DEST


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

         a)  D̲a̲t̲a̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲

             Refer CPS Prefixes
             Refer SUP Package prefixes.

         b)  E̲x̲t̲e̲r̲n̲a̲l̲ ̲D̲a̲t̲a̲

             Refer SUP Package data.
             TEP ̲ERROR:GARBLE ̲PARAMS         -   R

         c)  L̲o̲c̲a̲l̲ ̲D̲a̲t̲a̲

             Refer source listing.



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

         This procedure reports queue errors to the SSC by calling
         the SEND ̲GARBLE-procedure.



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



4.1.5.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 purpose of this procedure is to report internal
         errors to the SSC.

         The action taken can either be GIVE ̲UP or CONTINUE.



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

         C̲a̲l̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         a)  TEP ̲INT ̲ERR (USER ̲ACTION: USER ̲ACTION ̲TYPE,
                          INT ̲ERROR: INTERNAL ̲ERROR ̲INF ̲TYPE)


         b)  TEP ̲INT ̲ERR (R1, R2, R3, R4, R5, R6)

         R̲e̲g̲i̲s̲t̲e̲r̲ ̲C̲o̲n̲v̲e̲n̲t̲i̲o̲n̲

         C̲a̲l̲l̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         R1  USER ̲ACTION:USER ̲ACTION ̲TYPE    C   D
         R2  SUBPACK NO                      C   D
         R3  MODULE NO                       C   D
         R4  PROCEDURE NO                    C   D
         R5  ERROR NO                        C   D
         R6  LINK                            C   D

         R̲e̲t̲u̲r̲n̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         None

         R0 - R7                             DEST



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

         a)  D̲a̲t̲a̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲

             Refer CPS Prefixes

         b)  E̲x̲t̲e̲r̲n̲a̲l̲ ̲D̲a̲t̲a̲

             Refer SUP Package data
             TEP ̲ERROR:GARBLE ̲PARAMS         -   R

         c)  L̲o̲c̲a̲l̲ ̲D̲a̲t̲a̲

             Refer source listings.



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

         This procedure reports internal errors to the SSC by
         calling the SEND ̲GARBLE-procedure.


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



4.1.5.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̲

         Dismantles an object referenced by QEL. If specified,
         the referenced view will be checkpointed and/or closed.


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

         C̲a̲l̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         a)  TEP ̲DISMANTLE      (QEL:        QEL ̲REFERENCE
                                CP ̲STATUS:   BOOLEAN,
                                OBJECT:      OBJECT ̲TYPE,
                                CLOSE:       BOOLEAN)

         b)  TEP ̲DISMANTLE      (R2, R3, R4, R5, R6)

         R̲e̲g̲i̲s̲t̲e̲r̲ ̲C̲o̲n̲v̲e̲n̲t̲i̲o̲n̲

         C̲a̲l̲l̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         R2      PTK TO QEL:QEL ̲REFERENCE    C   D
         R3      CHECKPOINT ̲STATUS:BOOLEAN   C   D
         R4      OBJECT:OBJECT ̲TYPE          C   D
         R5      CLOSE:NO ̲YES                C   D
         R6      LINK                        C   D

         R̲e̲t̲u̲r̲n̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         None

         R0 - R7                             DEST


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

         a)  D̲a̲t̲a̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲

             Refer CPS Prefixes
             Refer SUP Package Prefixes

         b)  E̲x̲t̲e̲r̲n̲a̲l̲ ̲D̲a̲t̲a̲

             None

         c)  L̲o̲c̲a̲l̲ ̲D̲a̲t̲a̲

             Refer SUP Package data.



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

         If PTR to QEL (R2) is nil, the procedure returns without
         performing anything.
         Otherwise the object (Qel, buffer or view) is dismantled.
         If the objects is a view and CP ̲STATUS is true the
         view is saved.



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



4.1.5.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 displays the time and queue fields of
         the VDU Header in the header split.



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

         C̲a̲l̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         a)  DISP ̲HEADER ̲QUE (  ):ERROR ̲OK

         b)  DISP ̲HEADER ̲QUE (R6)

         R̲e̲g̲i̲s̲t̲e̲r̲ ̲C̲o̲n̲v̲e̲n̲t̲i̲o̲n̲

         C̲a̲l̲l̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         R6      LINK                          C   K

         R̲e̲t̲u̲r̲n̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         R0 - R7                               DESTROYED

         F̲a̲t̲a̲l̲ ̲E̲r̲r̲o̲r̲s̲

         None



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

         a)  D̲a̲t̲a̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲

             Refer CPS prefixes.
             Refer SUP Package Prefixes.


         b)  E̲x̲t̲e̲r̲n̲a̲l̲ ̲D̲a̲t̲a̲

             Refer SUP Package data

             INIT ̲AREA:RECORD                C   K
             VDU ̲HD ̲BLE:BUFFER ̲LIST ̲ELEMENT  C   R
             HEADER ̲IFCB:INTEGER             C   K
             SPLIT ̲DIGIT:INTEGER             C   K

         c)  L̲o̲c̲a̲l̲ ̲D̲a̲t̲a̲

             Refer Source listings.



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

         The Format Handler procedure FIELDS ̲OUTPUT is called.
         If VDU ̲SPLIT ̲FAILED then the procedure will return
         to the ERROR lable otherwise the OK lable will be used.


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



4.1.5.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 procedure displays the Header and Class Fields
         of the VDU Header in the Header Split.


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

         C̲a̲l̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         a)  IDSP ̲HEADER ̲INF (): ERROR ̲OK

         b)  DISP ̲HEADER ̲INF (R6)

         R̲e̲g̲i̲s̲t̲e̲r̲ ̲C̲o̲n̲v̲e̲n̲t̲i̲o̲n̲

         C̲a̲l̲l̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         R6  LINK                            C   K

         R̲e̲t̲u̲r̲n̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         None

         R0 - R7                             (Dest.)


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

         a)  D̲a̲t̲a̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲

             Refer CPS Prefixes.
             Refer SUP Package Prefixes.

         b)  E̲x̲t̲e̲r̲n̲a̲l̲ ̲D̲a̲t̲a̲

             Refer SUP Package data.

             VDU ̲HD ̲BLE:BUFFER ̲LIST ̲ELEMENT  C   R
             HEADER ̲IFCB:INTEGER             C   K
             SPLIT ̲DIGIT:INTEGER             C   K

         c)  L̲o̲c̲a̲l̲ ̲D̲a̲t̲a̲

             Refer Source listing.


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

         The Format Handler procedure FIELDS ̲OUTPUT is called.
         If VDU ̲SPLIT ̲FAILED then the procedure will return
         to the ERROR lable otherwise the OK lable will be used.



4.1.5.6  S̲E̲T̲ ̲H̲E̲A̲D̲E̲R̲ ̲T̲X̲T̲ ̲F̲I̲E̲L̲D̲



4.1.5.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̲

         The procedure inserts the specified text in the header
         text IOC record of the VDU ̲HD ̲AREA.

         If HEADER ̲TXT ̲CALL equals OWN ̲TEXT the text pointed
         out by 'POINTER TO TEXT' is inserted, otherwise the
         text indicated by HEADER ̲TEXT is inserted.



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

         C̲a̲l̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         a)  SET ̲HEADER ̲TEXT (HEADER ̲TXT ̲CALL: TXT ̲CALL ̲TYPE,
                              HEADER ̲TEXT: HEADER ̲TEXT ̲TYPE
                              TXT ̲POINTER:POINTER)

         b)  SET ̲HEADER ̲TEXT (R0, R1, R5, R6)

         R̲e̲g̲i̲s̲t̲e̲r̲ ̲C̲o̲n̲v̲e̲n̲t̲i̲o̲n̲

         C̲a̲l̲l̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲

         R0  HEADER ̲TXT ̲CALL:TXT ̲CALL ̲TYPE     C   D
         R1  HEADER ̲TEXT:HEADER ̲TEXT ̲TYPE      C   D
         R5  POINTER TO TEXT                   C   D
         R6  LINK                              C   D

         R̲e̲t̲u̲r̲n̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲

         None
         R0-R7                   DEST



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

         a)  D̲a̲t̲a̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲

             Refer SUP Package Prefixes.



         b)  E̲x̲t̲e̲r̲n̲a̲l̲ ̲D̲a̲t̲a̲

             Refer SUP Package data.

             VDU ̲HD ̲AREA:CHAR ARRAY(1..HD ̲LENGTH) OF  -  R

             VDU ̲HD ̲PT: POINTER                  -  R

         c)  L̲o̲c̲a̲l̲ ̲D̲a̲t̲a̲

             Refer source listings.



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

         N/A


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



4.1.5.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̲

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



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

         C̲a̲l̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         a)  SET ̲HEADER ̲CLASS (REQUIRED ̲CLASS:  REQ ̲CLASS ̲TYPE;
                               CURRENT ̲CLASS:  CLASSIFICATION
                     ̲TYPE)

         b)  SET ̲HEADER ̲CLASS (R0, R1, R6)

         R̲e̲g̲i̲s̲t̲e̲r̲ ̲C̲o̲n̲v̲e̲n̲t̲i̲o̲n̲

         C̲a̲l̲l̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         R0  REQUIRED ̲CLASS                    C   D
         R1  CURRENT ̲CLASS                     C   D
         R6  LINK                              C   D

         R̲e̲t̲u̲r̲n̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         None
         R0-R7                                 DEST



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

         a)  D̲a̲t̲a̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲

             Refer CPS Prefixes.
             Refer SUP Package Prefixes.

         b)  E̲x̲t̲e̲r̲n̲a̲l̲ ̲D̲a̲t̲a̲

             INIT ̲AREA:RECORD                  C   K
             VDU ̲HD ̲AREA:ARRAY                 C   R



         c)  L̲o̲c̲a̲l̲ ̲D̲a̲t̲a̲

             Refer Source listing.



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

         N/A


4.1.5.8  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̲



4.1.5.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̲

         INT ̲TO ̲ASCIT converts an integer to the corresponding
         ASCII format. Only as many characters as needed are
         converted.

         Both input and output are specified through a pointer
         and a byte offset. The pointer points the first word.
         If the input/output starts on a, the word-boundary,
         byte offset should be d, otherwise it should be 1.
         If byte offset of the source is 1 (across a word-boundary),
         the bytes are extracted as:

             R1
             ^
             V
         ^  LSB  N/A  ^  N/A  MSB  ^



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

         C̲a̲l̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         a)  INT ̲TO ̲ASCII  (INPUT ̲FIELD ̲POINTER,
                            BYTE ̲OFFSET:INTEGER,
                            LENGTH ̲IN ̲BYTES:INTEGER,
                            OUTPUT ̲FIELD:POINTER,
                            BYTE ̲OFFSET:INTEGER)

         b)  INT ̲TO ̲ASCII  (R1, R2, R3, R4, R5, R6)

         R̲e̲g̲i̲s̲t̲e̲r̲ ̲C̲o̲n̲v̲e̲n̲t̲i̲o̲n̲

         C̲a̲l̲l̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         R1  POINTER TO INPUT-FIELD            C   D
         R2  BYTE OFFSET                       C   D
         R3  LENGTH IN BYTES                   C   R
         R4  POINTER TO OUTPUT-FIELD           C   D
         R5  BYTE OFFSET                       C   D
         R6  LINK                              C   K




         R̲e̲t̲u̲r̲n̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         R0 - R2                               DEST
         R3      LENGTH IN BYTES (of converted value)
         R4 - R5                               DEST
         R6      LINK
         R7                                    DEST



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

         a)  D̲a̲t̲a̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲

             Refer CPS Prefixes.

         b)  E̲x̲t̲e̲r̲n̲a̲l̲ ̲D̲a̲t̲a̲

             N/A

         c)  L̲o̲c̲a̲l̲ ̲D̲a̲t̲a̲

             Refer Source listings.



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

         The number is extracted from the source array, and
         converted into an internal variable. The needed number
         of characters are then moved to the specified destination.



4.1.5.9  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̲



4.1.5.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̲

         ASCII ̲TO ̲INT converts an ASCII Text-String to the correspinding
         integer value.



         Both input and output are specified through a pointer
         and a byte offset. The pointer points the first word.
         If the input/output starts on a word boundary, byte
         offset should be d, otherwise it should be 1. If byte
         offset of the destination is 1 (accross a word-boundary),
         the bytes are placed as:

             R4
             ^
             V
         ^  LSB  N/A  ^  N/A  MSB  ^



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

         C̲a̲l̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         a)  ASCII ̲TO ̲INT  (INPUT ̲FIELD:POINTER,
                            BYTE ̲OFFSET:INTEGER,
                            LENGTH ̲IN ̲BYTES:INTEGER,

                            OUTPUT ̲FIELD:POINTER,
                            BYTE ̲OFFSET:INTEGER)

         b)  ASCII ̲TO ̲INT (R1, R2, R3, R4, R5, R6)

             R̲e̲g̲i̲s̲t̲e̲r̲ ̲C̲o̲n̲v̲e̲n̲t̲i̲o̲n̲

             C̲a̲l̲l̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

             R1  POINTER TO INPUT-FIELD        C   D
             R2  BYTE OFFSET                   C   D
             R3  LENGTH IN BYTES               C   R
             R4  POINTER TO OUTPUT-FIELD       C   D
             R5  BYTE OFFSET                   C   D
             R6  LINK                          C   K

             R̲e̲t̲u̲r̲n̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

             R0 - R2                           DEST
             R3      LENGTH IN BYTES (OF CONVERTED VALUE)
             R4 - R5                           DEST
             R6                                LINK
             R7                                DEST





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

         a)  D̲a̲t̲a̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲

             Refer CPS Prefixes

         b)  E̲x̲t̲e̲r̲n̲a̲l̲ ̲D̲a̲t̲a̲

             N/A

         c)  L̲o̲c̲a̲l̲ ̲D̲a̲t̲a̲

             Refer Source Listing.



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

         The characters, from the last to the first, are extracted,
         converted to digits, and added to the number. If non-numeric
         characters are found OK. If the number exceeds 65535
         (unsigned), TEP ̲INT ̲ERR is called.



4.1.5.10 M̲O̲V̲E̲ ̲W̲o̲r̲d̲s̲



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

         Moves a given no. of words from one place in the memory
         into another place.



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

         C̲a̲l̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         a)  MOVE ̲WORDS    (WORDSIZE ̲OF ̲AREA ̲MOVED: INTEGER,
                            SOURCE: POINTER,
                            DESTINATION: POINTER)

         b)  MOVE ̲WORDS (R0, R4, R5, R6)



         R̲e̲g̲i̲s̲t̲e̲r̲ ̲C̲o̲n̲v̲e̲n̲t̲i̲o̲n̲

         C̲a̲l̲l̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         R0  SIZE IN WORDS OF AREA MOVED       C   D
         R4  PTR TO SOURCE C   D
         R5  PTR TO DESTINATION                C   D
         R6  LINK                              C   D

         R̲e̲t̲u̲r̲n̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         None

         R0 - R7                               DEST



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

         a)  D̲a̲t̲a̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲

             Refer CPS Prefixes.

         b)  E̲x̲t̲e̲r̲n̲a̲l̲ ̲D̲a̲t̲a̲

             N/A

         c)  L̲o̲c̲a̲l̲ ̲D̲a̲t̲a̲

             Refer Source Listing.



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

         N/A



4.1.5.11 C̲a̲p̲a̲b̲i̲l̲i̲t̲y̲ ̲P̲a̲c̲k̲



4.1.5.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̲

         Converts CAPS to a CAP ̲LIST or vice versa depending
         of the value of pack. Pack (R0) = true converts CAP
         ̲LIST to CAPS.

         CAPS and CAP ̲LIST are data structures as described
         in SUP prefixes.





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

         C̲a̲l̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         a)  CAPABILITY ̲PACK (PACK:BOOLEAN,
                              CAPS:POINTER,
                              CAP ̲LIST:POINTER)

         b)  CAPABILITY ̲PACK (R0, R4, R5, R6)

         R̲e̲g̲i̲s̲t̲e̲r̲ ̲C̲o̲n̲v̲e̲n̲t̲i̲o̲n̲

         C̲a̲l̲l̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         R0  PACK:BOOLEAN                      C   D
         R4  PTR TOCAPS                        C   D
         R5  PTR TOCAPS ̲LIST                   C   D
         R6  LINK                              C   D

         R̲e̲t̲u̲r̲n̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

         None

         R0 - R7           DEST



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

         a)  D̲a̲t̲a̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲

             Refer CPS Prefixes
             REfer SUP Package Prefixes.

         b)  E̲x̲t̲e̲r̲n̲a̲l̲ ̲D̲a̲t̲a̲

             N/A

         c)  L̲o̲c̲a̲l̲ ̲D̲a̲t̲a̲

             Refer Source Listing.



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

         N/A


4.1.5.12 S̲p̲e̲c̲i̲a̲l̲ ̲H̲a̲n̲d̲l̲i̲n̲g̲ ̲P̲a̲c̲k̲



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

         Converts SPH to A SPH ̲LIST or vice versa depending
         on the value of pack.
         PACK(R0) = TRUE CONVERTS SPH ̲LIST TO SPH.
         SPH and SPH ̲LIST are data structures as described in
         SUP Prefixes.



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

         C̲a̲l̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲

         a)  SPEC ̲HAND ̲PACK     (PACK:BOOLEAN
                                 COUNT:INTEGER (1..20)
                                 SPH:POINTER
                                 SPH ̲LIST:POINTER)

         b)  SPEC ̲HAND ̲PACK (R0, R1, R4, R5, R6)

             R̲e̲g̲i̲s̲t̲e̲r̲ ̲C̲o̲n̲v̲e̲n̲t̲i̲o̲n̲

             C̲a̲l̲l̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

             R0  PACK:BOOLEAN                  C   D
             R1  COUNT:INTEGER (1..20)         C   D
             R4  PTR TO SPH                    C   D
             R5  PTR TO SPH ̲LIST               C   D
             R6  LINK                          C   D

             R̲e̲t̲u̲r̲n̲ ̲R̲e̲g̲i̲s̲t̲e̲r̲s̲

             None

             R0 - R7            DEST





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

         a)  D̲a̲t̲a̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲

             Refer CPS Prefixes
             Refer SUP Package Prefixes.

         b)  E̲x̲t̲e̲r̲n̲a̲l̲ ̲D̲a̲t̲a̲

             N/A

         c)  L̲o̲c̲a̲l̲ ̲D̲a̲t̲a̲

             Refer Source Listing.



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

         N/A


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 SVUP are 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 ref. b).



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 coroutines SVCO,
         SFCO and SCREP (VODL).  For details refer ref. c).



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

         The following coroutines use TMP functions SFCO, VDIA
         and SCREP.
         For details refer ref. c).



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

         This interface is implemented by the coroutines SFCO
         and SCREP.
         For details refer ref. c).



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

         This interface is implemented by the coroutines SFCO
         and SCREP.
         For details refer ref. c).


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

         This interface is implemented by the coroutines SFCO
         and SCREP.  For details refer ref. c).



4.1.7.2.6    S̲P̲R̲I̲ ̲I̲/̲F̲

         This interface is implemented by the coroutine SFCO
         and SCREP.
         For details refer ref. c).



4.1.7.2.7    S̲T̲P̲ ̲I̲/̲F̲

         This interface is implemented by the coroutines SFCO
         and SCREP.
         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̲

         N/A


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 SUP (SVUP) are the interfaces
         between SVCO, SFCO, VDIA, SCREP and VODL.

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

             1.  Start SFCO Command
             2.  Restart SFCO Command
             3.  Stop SFCO Command
             4.  Close SFCO Command
             5.  Update VDU Header
             6.  Close all incoming channels (threshold)

         b)  F̲r̲o̲m̲ ̲S̲V̲C̲O̲ ̲t̲o̲ ̲S̲V̲D̲I̲A̲ ̲a̲n̲d̲ ̲S̲C̲R̲E̲P̲

             None

         c)  F̲r̲o̲m̲ ̲S̲V̲C̲O̲ ̲t̲o̲ ̲V̲O̲D̲L̲

             1.  Close VODL Command

         d)  F̲r̲o̲m̲ ̲S̲F̲C̲O̲ ̲t̲o̲ ̲S̲V̲C̲O̲

             1.  Answer to Start SFCO Command
             2.  Answer to Restart SFCO Command
             3.  Answer to Stop SFCO Command
             4.  Answer to Close SFCO Command
             5.  Answer to Update VDU Header
             6.  Answer to close all incoming channels

         e)  F̲r̲o̲m̲ ̲S̲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



         f)  F̲r̲o̲m̲ ̲S̲F̲C̲O̲ ̲t̲o̲ ̲S̲C̲R̲E̲P̲

             1.  Initiate Table Reorganization (REOR)
             2.  Abandon Table Reorganization  (ABRO)
             3.  Initiate Copy of System Parameter File (COPY)
             4.  Unblock Circuit Queue         (UBCQ)
             5.  Block Circuit Queue           (BLCQ)
             6.  Block Terminal Queue          (BLTQ)
             7.  Unblock Terminal Queue        (UETQ)
             8.  Block Device Queue            (BLOQL)
             9.  Unblock Device Queue          (UBDQ)
             10. Cancel Circuit Queue          (CACQ)
             11. Cancel Terminal Queue         (CATQ)
             12. Cancel Device Queue           (CADQ)
             13. Cancel System Queue           (CASQ)
             14. Cancel All Circuit Queues     (CAAC)
             15. Cancel All Terminal Queues    (CAAT)
             16. Cancel All Device Queues      (CAAD)

         g)  F̲r̲o̲m̲ ̲S̲F̲C̲O̲ ̲t̲o̲ ̲V̲O̲D̲L̲

             1.  Delete Volume

         h)  F̲r̲o̲m̲ ̲V̲D̲I̲A̲ ̲t̲o̲ ̲S̲V̲C̲O̲

             None.

         i)  F̲r̲o̲m̲ ̲V̲D̲I̲A̲ ̲t̲o̲ ̲S̲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

         j)  F̲r̲o̲m̲ ̲V̲D̲I̲A̲ ̲t̲o̲ ̲S̲C̲R̲E̲P̲ ̲a̲n̲d̲ ̲V̲O̲D̲L̲

             None

         k)  F̲r̲o̲m̲ ̲S̲C̲R̲E̲P̲ ̲t̲o̲ ̲S̲V̲C̲O̲

             None



         l)  F̲r̲o̲m̲ ̲S̲C̲R̲E̲P̲ ̲t̲o̲ ̲S̲F̲C̲O̲

             1.  Answer to REOR Command
             2.  Answer to ABRO Command
             3.  Answer to COPY Command
             4.  Answer to UBCQ Command
             5.  Answer to BLCQ Command
             6.  Answer to BLTQ Command
             7.  Answer to UBTQ Command
             8.  Answer to BLDQ Command
             9.  Answer to UBDQ Command
             10. Answer to CACQ Command
             11. Answer to CATQ Command
             12. Answer to CADQ Command
             13. Answer to CASQ Command
             14. Answer to CAAC Command
             15. Answer to CAAT Command
             16. Answer to CAAD Command

         m)  F̲r̲o̲m̲ ̲S̲C̲R̲E̲P̲ ̲t̲o̲ ̲V̲D̲I̲A̲ ̲a̲n̲d̲ ̲V̲O̲D̲L̲

             None

         n)  F̲r̲o̲m̲ ̲V̲O̲D̲L̲ ̲t̲o̲ ̲S̲V̲C̲O̲

             1.  Answer to Close VODL Command

         o)  F̲r̲o̲m̲ ̲V̲O̲D̲L̲ ̲t̲o̲ ̲S̲F̲C̲O̲

             1.  Anser to delete Volume Command.

         p)  F̲r̲o̲m̲ ̲V̲O̲D̲L̲ ̲t̲o̲ ̲S̲C̲R̲E̲P̲ ̲a̲n̲d̲ ̲V̲D̲I̲A̲

             None.



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

         The SVUP Initialization subpackage (SUPI) has no interface
         to any of the other subpackages, except for the initialization
         of the SVUP coroutines.

         The Supervisor VDU Procedures subpackage is called
         solely by VDIA.