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

⟦6b786c76c⟧ Wang Wps File

    Length: 10032 (0x2730)
    Types: Wang Wps File
    Notes: FIX/1256/PSP/0055         
    Names: »3877A «

Derivation

└─⟦a0a781934⟧ Bits:30006149 8" Wang WCS floppy, CR 0333A
    └─ ⟦this⟧ »3877A « 

WangText




     
 3877A/jaa…02…FIX/1256/PSP/0055
 

…02…CAH/830720…02……02…#
LCFH Monitor
 PSP 
…02……02… FK 7809












                 LCFH Monitor PSP



                 FIX/1256/PSP/0055














                 Carl H]gstedt




                 Carl H]gstedt







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














                          FIKS Manager    830720


         …0f…1



         830720…0e…




    3877A/jaa      …02…FIX/1256/PSP/0055

…02…CAH/830720…02……02…R
LCFH Monitor PSP
…02……02…FK 7809












        830720                All      Issue 1 of Document




    3877A/jaa      …02…FIX/1256/PSP/0055

…02…CAH/830720…02……02…i
LCFH Monitor PSP
…02……02…FK 7809









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



         1   SCOPE ................................ 01
             1.1 INTRODUCTION ..................... 01
             1.2 ABBREVIATIONS .................... 01

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

         3   MODULE SPECIFICATION ................. 03
             3.1 FUNCTIONAL CAPABILITIES .......... 03
             3.2 INTERFACE DESCRIPTION ............ 03
                 3.2.1 INPUT ...................... 04
                 3.2.2 OUTPUT ..................... 04

             3.3 PROCESSING ....................... 05
             3.5 STORAGE ALLOCATION ............... 11
                 3.5.1 PROGRAM SIZE ............... 11
                 3.5.2 PROCESS SIZE ............... 11

             3.6 PERFORMANCE CHARACTERISTICS ...... 11
             3.7 LIMITATIONS ...................... 11
             3.8 ERROR CODES AND ERROR LOCATION.... 11
             3.9 LISTING REFERENCES ............... 11

         4   QUALITY ASSURANCE .................... 12
             4.1 QUALIFICATION TESTS .............. 12

         5   PREPARATIONS FOR DELIVERY ............ 13
             5.1 COMPILE PARAMETERS ............... 13
             5.2 LINK PARAMETERS .................. 13


1        S̲C̲O̲P̲E̲

         This specification contains the detailed design documentation
         and listings of the LCFH Monitor Procedure.



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

         The LCFH Monitor Procedure is the application program
         interface to the TDX Systems (Red and Black) during
         TDX Configuration.



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

         LCFH        LTUX Configuration File Handler
         FSN         File System Name
         F ̲A         File Address
         BLE         Buffer List Element
         WA          Work Array





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

         FIKS TDX System Design
             FIX/3131/DSP/0011/           Chap. 3.4

         FIKS Product Specification
             FIX/1000/PSP/0038

         LCFGEN Users's Manual
             FIX/1000/USM/0001


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



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

         The procedure is used to configurate/reconfigurate
         the Red and Black TDX System by means of the LTUX Configuration
         Files (LCF).

         The procedures handles the LCF by reading and executing
         one record at a time, until a terminate record is found.



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

         MON (LCFH, R0, R1, R2, R4, R5, R6, R7): X2

         Use of Registers:

                     Input                Output

         R0      Ref.FILE ̲ADDR            kept
         R1      Ref.FILE ̲NAME            kept
         R2      Ref. BLE                 kept
         R4      FD(MOVHEAD)              kept
         R5      -  -                     EOF(1 if end of file)
         R6      Ref(Work area 64W)       kept
         R7      LINK                     Compl. code if error

         Return points:

         Error       Link + 0
         Successful  Link + 1

         Completion codes:

             AAA:    if an erroneous OP ̲REF is received in WAITOPERATIONS
             ABB:    if timeout (1 sec) in WAITOPERATIONS
             AXX:    if an erroneous compl. code is received
                     from the LTUX (XX is then the erroneous
                     byte)


3.2.1    I̲N̲P̲U̲T̲

         -   FILE ̲ADDR.FIRST ̲BYTE  =      Offset to next record
                                          on actual file (LCF).

         -   FILE ̲NAME             =      Name of actual file
                                          (LCF). (See FIKS TDX
                                          System Design Spec.
                                          FIX/3131/DSP/0011).

         -   Work Area             =      if actual file is
                                          a dismantle file (LCFRD
                                          dd ), then word 0
                                          = log line id



3.2.2    O̲U̲T̲P̲U̲T̲

         -   FILE ̲ADDR.FIRST ̲BYTE  =      Offset to next record
                                          on actual file (LCF).

         -   Work Area             =      Log Line id         0
                                          CR ID               1
                                                              2
                                                              3
         If R7 (compl.code) = AXX                             4
         Mismatch between data                                5
         received from LTUX and           read record
         data in the read record
         from file (LCF)




                                          date received      21
                                          from LTUX



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

         When called, the procedure reset the whole work array
         except for word 0, and lookup the user is given configuration
         file.

         Now record after record is fetched to WA.LCF ̲BUFF and
         executed as follows:

         .   FSN Record

                 The file system name is saved in WA.FSN ̲NAME

         .   Create Record

                 With file system name (WA.FSN ̲NAME) and file
                 attr( WA.LCF ̲BUFF) as input, the actual channel
                 is created, and the log line id is saved in
                 WA.LOG ̲LINE

         .   Init Read Record

                 The WA.F ̲A ̲INIT and WA.BLE ̲INIT is initiated
                 as follows:

                     No of bytes  = constant
                     Addr         = Addr (WA.CC ̲BUFF)

                 and an init read is issued to the log line
                 defined in CRID (WA.LCF ̲BUFF  2  ). The operation
                 reference is saved in WA.OPER ̲REF.

         .   Append Record

                 The User given F ̲A and BLE is initiated as
                 follows:

                     No of bytes  = WA.LCF ̲BUFF  0    - 6
                     Addr         = Addr (WA.LCF ̲BUFF) + 3

                 and the data is appended to the log line defined
                 in CRID (WA.LCF ̲BUFF  2  )



         .   Complete Read Record

                 A  WAIT Operation is setup with a delay of
                 1 sec.

                 If IO is done, then the WA.OPER ̲REF is reset,
                 and the bytes received (WA.CC ̲BUFF) is compared
                 to the bytes to the bytes in the complete read
                 record (WA.LCF ̲BUFF  3...  )

                 If delay erroneously occurs the error is saved
                 in WA.ERR ̲CODE.

         .   Dismantle Record

                 The log line id defined by CRID (WA.LCF ̲BUFF
                  2  ) is fetched from WA.LOG ̲LINE.

                 If id = 0 then fetch log line id from WA.RETURN
                 ̲1 ( in this case it is the user process, which
                 wants a channel dismantled).

                 The final log line is now dismantled.

         .   Terminate Record

                 The log line id defined by CRID (WA.LCF ̲BUFF
                  2  ) and the CRID itself, is moved to
                 WA.RETURN ̲1/2
                 If the record is the last one in the file,
                 an EOF Mark is set in WA.REG ̲SAVE  5  .

         .   Dummy Record

                 This record is only used to jump in the file.

         When a terminate record is found, the procedure dismantle
         the configuration file and returns to the user process.

         If an error occurs during all of these operations,
         the error code is saved in WA.ERR ̲CODE, and all open
         channels and pending reads are dismantle and cancelled,
         before returning to the user process in link + 0, with
         the error code in reg. 7.
















































            FIG. 3.3-1: LCFH MONITOR FLOWCHART
















































            FIG. 3.3-2: LCFH MONITOR FLOWCHART
















































            FIG 3.3-3: LCFH MONITOR FLOWCHART
















































          FIG. 3.4: LCFH MONITOR WORKARRAY (WA)


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



3.5.1    P̲R̲O̲G̲R̲A̲M̲ ̲S̲I̲Z̲E̲

         333 words



3.5.2    P̲R̲O̲C̲E̲S̲S̲ ̲S̲I̲Z̲E̲

         No process area, it is a monitor



3.6      P̲E̲R̲F̲O̲R̲M̲A̲N̲C̲E̲ ̲C̲H̲A̲R̲A̲C̲T̲E̲R̲I̲S̲T̲I̲C̲S̲



3.7      L̲I̲M̲I̲T̲A̲T̲I̲O̲N̲S̲

         Only a Dummy Record may be greater than 28 bytes.

         A LTUX Completion Code must not be greater than 16
         bytes.

         Only one init read must be pending.

         Subdevice no. greater than 9 is not allowed.


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

         Error codes are returned to calling process as completion
         codes (see 3.2 Interface Description).



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

                                    LCFH.S




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



4.1      Q̲U̲A̲L̲I̲F̲I̲C̲A̲T̲I̲O̲N̲ ̲T̲E̲S̲T̲S̲


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

5.1    C̲O̲M̲P̲I̲L̲E̲ ̲P̲A̲R̲A̲M̲E̲T̲E̲R̲S̲
     ^            ^  Mandatory   ^  Default     ^ Comments
     ^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲
     ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
     ^            ^              ^              ^
     ^ I:         ^  LCFH.S      ^              ^ Source
                                                  file
     ^ O:         ^  LCFH.L      ^              ^ Object
                                                  file
     ^ P:         ^  LCFH.P      ^  Current Out ^ Print
                                                  file
     ^ L:         ^  1           ^       0      ^ List level
     ^ X:         ^              ^      2/3     ^ Cross
                                                  references
     ^ TA:        ^              ^       NO     ^ Target
                                                  computer
     ^            ^              ^              ^

5.2    L̲I̲N̲K̲ ̲P̲A̲R̲A̲M̲E̲T̲E̲R̲S̲
     ^            ^  Mandatory   ^  Default     ^ Comments
     ^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲
     ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
     ^            ^              ^              ^
     ^ MAIN:      ^  LCFH.L      ^              ^ Main module
     ^ SUB:       ^              ^              ^ Sub module
     ^ O:         ^  LCFH.C      ^              ^ Object
                                                  file
     ^ P:         ^  LCFH.LP     ^  Current out ^ Print
                                                  file
     ^ L:         ^  4           ^       0      ^ List level
     ^ X:         ^              ^      NO      ^ Cross
                                                  reference
     ^ TARGET:    ^              ^     2/3      ^ Target
                                                  computer
     ^ PROGFILL:  ^              ^              ^ Program
                                                  fill spec.
     ^ PROCFILL:  ^              ^              ^ Process
                                                  fill spec.
     ^ PRIORITY:  ^              ^       1      ^ 
     ^ CAPABILITY:^              ^       0      ^
     ^ EXECLEVEL: ^              ^       2      ^
     ^ FDS:       ^  0           ^       4      ^ File descriptors
     ^ IOCBS:     ^              ^       3      ^ I/O control
                                                  blocks
     ^ STREAMS:   ^  0           ^       2      ^ 0 if N/M
     ^ TLES:      ^              ^       9      ^ Transfer
                                                  list
     ^            ^              ^              ^ elements
     ^ MESSAGES:  ^              ^       4      ^ 
     ^ WORKAREA:  ^              ^       0      ^ Free data
                                                  space
     ^ VERSION:   ^  0201        ^       0      ^ 
     ^ OVERLAY:   ^              ^       0      ^ Min. program
                                                  size
     ^ DATA:      ^  NO          ^     YES      ^ Process
     ^            ^              ^              ^ generat.flag
     ^ PROGHEADER:^  YES         ^     YES      ^ Program
                                                  header
     ^            ^              ^              ^ generation
                                                  flag
     ^ REENTRANT: ^              ^     YES      ^ 
     ^ RESIDENT:  ^              ^      NO      ^ 
     ^ PERMANENT: ^              ^      NO      ^ 
     ^ MONITOR:   ^  YES         ^      NO      ^
     ^ UTILITY:   ^  NO          ^     YES      ^ 
     ^ PROGNAME:  ^  LCFH        ^              ^ Program
                                                  name
     ^ PROCNAME:  ^              ^              ^ Process
                                                  name
     ^ CPUNAME:   ^              ^   CPU000     ^ CPU000
                                                  or CPU001
     ^ USERIDO:   ^              ^       0      ^ 
     ^ USERID1:   ^              ^       0      ^ 
     ^            ^              ^              ^