top - download
⟦94e238896⟧ Wang Wps File
Length: 12019 (0x2ef3)
Types: Wang Wps File
Notes: FIX/1266/PSP/0063
Names: »5055A «
Derivation
└─⟦1f5010eea⟧ Bits:30006143 8" Wang WCS floppy, CR 0473A
└─ ⟦this⟧ »5055A «
WangText
5055A/bna …02…FIX/1266/PSP/0063
…02…JL/840614…02……02…#
FIKS MIOMON PROCEDURES PSP
…02… …02…FK7809
FIKS MIOMON PROCEDURES PSP
FIX/1266/PSP/0063
J]rgen Lindballe
Ole Eskedal
AMC (6), LOL, APE, REV, LU
…0e… FIKS S/W Mgr. 840614
1
840614
Config. Mgr. 840614…0f…
5055A/bna…02… FIX/1266/PSP/0063
…02… JL/840614…02……02…ii
FIKS MIOMON PROCEDURES PSP
…02……02…
840614 All Issue one of Document
5055A/bna…02…FIX/1266/PSP/0063
…02…JL/840614…02……02… iii
FIKS MIOMON PROCEDURES PSP
…02……02……02…
T̲A̲B̲L̲E̲ ̲O̲F̲ ̲C̲O̲N̲T̲E̲N̲T̲S̲
1 SCOPE .........................................
1
1.1 INTRODUCTION ...............................
1
1.2 ABBREVIATIONS ..............................
2
1.3 DEFINITION OF TERMS ........................
2
2 APPLICABLE DOCUMENTS ..........................
3
3 MODULE SPECIFICATION ..........................
4
3.1 FUNCTIONAL CAPABILITIES ....................
4
3.2 INTERFACE DESCRIPTION ......................
4
3.3 PROCESSING .................................
6
3.3.1 DEQUEUE (QDCB; MTCB-INDEX, CC) .........
6
3.3.2 ENQUEUE (MTCB-INDEX, QDCB; CC) .........
7
3.3.3 GET-MTCB (MTCB-INDEX, MPCB; TYPE, CC) ..
8
3.3.4 PUT-MTCB (MTCB-INDEX, MPCB; CC) ........
9
3.3.5 OPEN
(MTCB-INDEX, MFDCB; FILE DESCRIPTOR) ...
10
3.3.6 SET-POSITION (POSITION, MFDCB) .........
11
3.3.7 LOAD (MFDCB) ...........................
12
3.3.8 CLOSE (MFDCB; MTCB-INDEX) ..............
13
3.3.9 Initialization .........................
14
3.4 DATA ORGANIZATION ..........................
14
3.5 STORAGE ALLOCATION .........................
14
3.5.1 Memory Space Requirements ..............
14
3.5.2 Disc Space Requirements ................
14
3.6 PERFORMANCE CHARACTERISTICS ................
15
3.7 LIMITATIONS ................................
15
3.8 ERROR CODES ................................
15
3.9 LISTING REFERENCES .........................
15
4 QUALITY ASSURANCE .............................
16
4.1 QUALIFICATION TESTS ........................
16
4.2 OTHER QUALITY ASSURANCE PROVISIONS .........
16
5 PREPARATIONS FOR DELIVERY .....................
17
6 FLOW CHARTS ...................................
18
1 S̲C̲O̲P̲E̲
1.1 I̲N̲T̲R̲O̲D̲U̲C̲T̲I̲O̲N̲
This document specifies the M̲I̲O̲M̲O̲N̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲s̲ within
the FIKS application software. The design is based
on issue 5 of the Requirements Specifications.
The main tasks of the eight procedures are:
o to dequeue a queue element
o to enqueue a queue element
o to read an MTCB
o to write an MTCB
o to open a file
o to set a file position
o to read a block from a file
o to close a file
respectively.
1.2 A̲B̲B̲R̲E̲V̲I̲A̲T̲I̲O̲N̲S̲
CC Completion Code
MFDCB Message File Descriptor Control Block
MPCB MTCB Parameter Control Block
MTCB Message Transition Control Block
QDCB Queue Description Control Block
QIOCB QACCESS I/O Control Block
1.3 D̲E̲F̲I̲N̲I̲T̲I̲O̲N̲ ̲O̲F̲ ̲T̲E̲R̲M̲S̲
Message Transition Control Block (MTCB)
A core resident representative for a message.
2 A̲P̲P̲L̲I̲C̲A̲B̲L̲E̲ ̲D̲O̲C̲U̲M̲E̲N̲T̲S̲
1. REQUIREMENTS SPECIFICATION
FIX/0000/SPC/0002
Vol. I-III
2. FIKS SYSTEM DESIGN SPECIFICATION
FIX/1000/DSP/0001
3. FIKS SOFTWARE INTERFACE REFERENCE
FIKS//0100/MAN/0003
4. FIKS DATA INTERFACE REFERENCE
FIX/0100/MAN/0004
5. CR80 AMOS KERNEL
CSS/302/PSP/0008
6. CR80 AMOS I/O SYSTEM
CSS/006/PSP/0006
7. CR80 FILE SYSTEM PSP
CSS/910/EWP/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 MIOMON complex consists of 8 independent procedures:
o DEQUEUE
o ENQUEUE
o GET ̲MTCB
o PUT ̲MTCB
o OPEN
o SET ̲POSITION
o LOAD
o CLOSE
and
o INITIALIZATION
which are described in the sections 3.3.1 through 3.3.9.
3.2 I̲N̲T̲E̲R̲F̲A̲C̲E̲ ̲D̲E̲S̲C̲R̲I̲P̲T̲I̲O̲N̲
The format of a procedure call is for DEQUEUE:
MON, MIOMON ;
procedure name ;
link + 0: ; error
link + 1: ; queue empty
link + 2: ; done
and for the remaining procedures:
MON, MIOMON ;
procedure name ;
link + 0: ; error
link + 1: ; done
The QDCB record has this format:
QDCB: ; Queue Description Control
Block
QDTN ; Terminal No.
QDQN ; Queue No.
QDEN ; Entry No.
QDQIO 1:5 ; IO-Control Block
QIOWRK 1:8 ; Work Area
The MPCB record has the following format:
MPCB: ; MTCB Parameter Control
Block
MPWORK ; Work
MPMBE 0:9 ; MTCB Block
MPMBEA ; - -
MPMBEB ; - -
MPMBEC ; - -
The MFDCB record has the format described below:
MFDCB: ; Message File Descriptor
Control Block
MFDSTA ; Status Word
MFDLNK ; Return Link
MFDPOS ; File Position
MFDPFS 0:1 ; Physical Start of File
MFDMBX ; MTCB Index
MFDFD ; File Descriptor
MFDBLE o:3 ; Buffer List Element
MFDFAD o:3 ; File Address
MFDCNT o:1 ; Current Number of Words
3.3 P̲R̲O̲C̲E̲S̲S̲I̲N̲G̲
An overview of the procedures and the initialization
is found in figure 3.3-1.
3.3.1 D̲E̲Q̲U̲E̲U̲E̲ (QDCB; MTCB-INDEX, CC)
P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲N̲a̲m̲e̲: MDEQQE
E̲n̲t̲r̲y̲:
R4: QDCB ref. (Queue Description Control Block)
R7: Link
QDCB.QDGN: Group Queue no.
QDCB.QDQN: Queue No. (-1 for group queue)
ODCB.QDEN: Entry No. (0/1/N = last, first, no.)
E̲x̲i̲t̲:
R0: MTCB-Index
R1: Destroyed
R2: Destroyed
R4: QDCB-ref
R7: CC/link
Returns: Link + 0: error
Link + 1: queue empty
Link + 2: done
R̲e̲f̲e̲r̲e̲n̲c̲e̲:
Figure 3.3.1-1.
N̲a̲r̲r̲a̲t̲i̲v̲e̲
The queue element in the queue specified by the Queue
Descriptor is removed and deleted. The MTCB-index is
returned. The MTCB-usecount is left unchanged.
3.3.2 E̲N̲Q̲U̲E̲U̲E̲ (MTCB-INDEX, QDCB; CC)
P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲N̲a̲m̲e̲: MENQQE
E̲n̲t̲r̲y̲:
R0: MTCB-index
R4: QDCB ref. (Queue Description Control Block)
R7: Link
QDCB.QDTN: Group No.
QDCB.QDQN: Queue No.
QDCB.QDEN: Entry No.
E̲x̲i̲t̲:
R0: MTCB-index
R1: Destroyed
R2: Destroyed
R4: Link/QDCB-ref
R7: CC/link
Returns: Link + 0: error
Link + 1: done
R̲e̲f̲e̲r̲e̲n̲c̲e̲:
Figure 3.3.2-1
N̲a̲r̲r̲a̲t̲i̲v̲e̲:
A queue element specified by the MTCB-index is inserted
into the queue specified by QDCB.
3.3.3 G̲E̲T̲-̲M̲T̲C̲B̲ (MTCB-INDEX, MPCB; TYPE, CC)
P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲N̲a̲m̲e̲: MGETMTCB
E̲n̲t̲r̲y̲:
R0: MTCB-index
R4: MPCB-ref.
R7: Link
E̲x̲i̲t̲:
R0: Destroyed/MTCB-index
R1: Nil/type
R2: Destroyed
R4: Link/MPCB-ref
R7: CC/link
Returns: Link + 0: error
Link + 1: done
R̲e̲f̲e̲r̲e̲n̲c̲e̲:
Figure 3.3.3-1
N̲a̲r̲r̲a̲t̲i̲v̲e̲:
The MTCB specified by its index is read and loaded
into the MTCB Parameter Control Block (MPCB).
3.3.4 P̲U̲T̲-̲M̲T̲C̲B̲ (MTCB-INDEX, MPCB; CC)
P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲N̲a̲m̲e̲: MPUTMTCB
E̲n̲t̲r̲y̲:
R0: MTCB-index
R4: MPCB-ref.
R7: Link
E̲x̲i̲t̲:
R0: Destroyed/MTCB-index
R1: Destroyed
R2: Destroyed
R4: Link/MPCB-ref
R7: CC/link
Returns: Link + 0: error
Link + 1: done
R̲e̲f̲e̲r̲e̲n̲c̲e̲:
Figure 3.3.4-1
N̲a̲r̲r̲a̲t̲i̲v̲e̲:
The MTCB specified by its index is updated according
to the MTCB Parameter Control Block (MPCB).
3.3.5 O̲P̲E̲N̲ (MTCB-INDEX, MFDCB; FILE DESCRIPTOR)
P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲N̲a̲m̲e̲: MOPEN
E̲n̲t̲r̲y̲:
R0: MTCB-index
R4: MFDCB-ref.
R7: Link
E̲x̲i̲t̲:
R0: Destroyed
R1: Destroyed
R2: Destroyed
R3: Destroyed/File Descriptor
R4: MFDCB-ref
R7: CC/link
CC = 1: File already open
CC = 3: Illegal size code
Returns: Link + 0: error
Link + 1: done
R̲e̲f̲e̲r̲e̲n̲c̲e̲:
Figure 3.3.5-1
N̲a̲r̲r̲a̲t̲i̲v̲e̲:
If not already open the file specified by the MF.DCB
(Message File Descriptor Control Block) is opened.
3.3.6 S̲E̲T̲-̲P̲O̲S̲I̲T̲I̲O̲N̲ (POSITION, MFDCB)
P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲N̲a̲m̲e̲: MSETPOS
E̲n̲t̲r̲y̲:
R0: Position
R4: MFDCB-ref.
R7: Link
E̲x̲i̲t̲:
R0: Position
R4: MFDCB-ref
R7: Link
CC = 2: Not open
Returns: Link + 0: error
Link + 1: done
R̲e̲f̲e̲r̲e̲n̲c̲e̲:
Figure 3.3.6-1
N̲a̲r̲r̲a̲t̲i̲v̲e̲:
Within the record MFDCB (Message File Descriptor Control
Block) the variables MFD-POS is set to the position
specified, and MFD-CNT is set to 0, i.e. the MFDCB
is flagged empty.
3.3.7 L̲O̲A̲D̲ (MFDCB)
P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲N̲a̲m̲e̲: MLOAD
E̲n̲t̲r̲y̲:
R4: MFDCB-ref.
R7: Link
E̲x̲i̲t̲:
R0: Destroyed
R1: Destroyed
R2: Destroyed
R3: Destroyed
R4: MFDCB-ref
R7: CC/link
CC = 0: Error during READ-BYTES
CC = 2: File not open
Returns: Link + 0: error
Link + 1: done
R̲e̲f̲e̲r̲e̲n̲c̲e̲:
Figure 3.3.7-1
N̲a̲r̲r̲a̲t̲i̲v̲e̲:
If the file specified by the MFDCB (Message File Descriptor
Control Block) is open, a block is read into the data
buffer.
3.3.8 C̲L̲O̲S̲E̲ (MFDCB; MTCB-INDEX)
P̲r̲o̲c̲e̲d̲u̲r̲e̲ ̲N̲a̲m̲e̲: MCLOSE
E̲n̲t̲r̲y̲:
R4: MFDCB-ref.
R7: Link
E̲x̲i̲t̲:
R0: Destroyed/MTCB-index
R1: Destroyed
R4: MFDCB-ref
R7: CC/link
CC = 0: Error during RESERVE-MTCB, RELEASE-FILE, RELEASE-MTCB
CC = 2: File already closed
Returns: Link + 0: error
Link + 1: done
R̲e̲f̲e̲r̲e̲n̲c̲e̲:
Figure 3.3.8-1
N̲a̲r̲r̲a̲t̲i̲v̲e̲:
If the file is open it is released, and the MFDCB (Message
File Descriptor Control Block) is closed.
3.3.9 I̲n̲i̲t̲i̲a̲l̲i̲z̲a̲t̲i̲o̲n̲
R̲e̲f̲e̲r̲e̲n̲c̲e̲:
Figure 3.3.9-1.
N̲a̲r̲r̲a̲t̲i̲v̲e̲:
The monitor procedure MONINIT is called, whereby the
entry point MIOSTART is declared.
3.4 D̲A̲T̲A̲ ̲O̲R̲G̲A̲N̲I̲Z̲A̲T̲I̲O̲N̲
Not applicable.
3.5 S̲T̲O̲R̲A̲G̲E̲ ̲A̲L̲L̲O̲C̲A̲T̲I̲O̲N̲
3.5.1 M̲e̲m̲o̲r̲y̲ ̲S̲p̲a̲c̲e̲ ̲R̲e̲q̲u̲i̲r̲e̲m̲e̲n̲t̲s̲
The procedures occupy approximately 200 words of program
area.
3.5.2 D̲i̲s̲c̲ ̲S̲p̲a̲c̲e̲ ̲R̲e̲q̲u̲i̲r̲e̲m̲e̲n̲t̲s̲
No disc space is required.
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̲
Not applicable.
3.7 L̲I̲M̲I̲T̲A̲T̲I̲O̲N̲S̲
None.
3.8 E̲R̲R̲O̲R̲ ̲C̲O̲D̲E̲S̲
The error codes are specified in the sections 3.3.1
through 3.3.8.
3.9 L̲I̲S̲T̲I̲N̲G̲ ̲R̲E̲F̲E̲R̲E̲N̲C̲E̲S̲
Source listings may be obtained from the FIKS library
(FIXLIB, ref. to SCCLDD).
4 Q̲U̲A̲L̲I̲T̲Y̲ ̲A̲S̲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̲
Not applicable.
4.2 O̲T̲H̲E̲R̲ ̲Q̲U̲A̲L̲I̲T̲Y̲ ̲A̲S̲S̲U̲R̲A̲N̲C̲E̲ ̲P̲R̲O̲V̲I̲S̲I̲O̲N̲S̲
Not applicable.
5 P̲R̲E̲P̲A̲R̲A̲T̲I̲O̲N̲S̲ ̲F̲O̲R̲ ̲D̲E̲L̲I̲V̲E̲R̲Y̲
Preparation of the binary object code starts with an
editing of the source text.
Then the source text is merged together with the prefix
files:
GENS.D* S2SYSS
GENS.D* X2ION1
GENS.D* X2GEN1
SCCNAMES.D* MIONAMES.N
SCCNAMES.D* ISHNAMES.N
GENS.D* X2I0N2
GENS.D* X2GEN2
The merge file is compiled by running the Assembler,
and the listing is printed.
Finally the binary code may be installed.
Exact instructions may be obtained from the file "INFORMATION"
in the most recent ESP-directory of FIXLIB.
6 F̲L̲O̲W̲ ̲C̲H̲A̲R̲T̲S̲
