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 ^
^ ^ ^ ^