top - download
⟦39d6d817a⟧ Wang Wps File
Length: 6801 (0x1a91)
Types: Wang Wps File
Notes: FIX/1256/PSP/0102
Names: »3402A «
Derivation
└─⟦3b8d69e90⟧ Bits:30005794 8" Wang WCS Floppy ( A0306A )
└─ ⟦this⟧ »3402A «
WangText
…02…FIX/1256/PSP/0102
…02… OK/830307…02……02…#
TEST ̲HDB
MONITOR
PSP
…02……02…FK 7809
TEST ̲HDB MONITOR PSP
FIX/1200/PSP/0102
Ove Kaastrup
Carl H]gstedt
AMC (6)
CR (3)
FILE (2)
FIKS Manager 830307
1
830307
…0f…3402A…02… FIX/1200/PSP/0102
…02… OK/830307…02……02…R
TEST ̲HDB MONITOR PSP
…02……02…FK 7809…0e…
830307 All Issue 1 of Document
3402A…02… FIX/1200/PSP/0102
…02… OK/830307…02……02…i
TEST ̲HDB MONITOR PSP
…02……02…FK 7809
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
2 APPLICABLE DOCUMENTS .......................... 3
3 MODULE SPECIFICATIONS ......................... 4
3.1 Functional Capabilities ................... 4
3.2 Interface Description ..................... 5
3.3 Processing ................................ 6
3.4 Data Organization ......................... 8
3.5 Storage Allocation ........................ 8
3.6 Performance Characteristics ............... 8
3.7 Limitations ............................... 8
3.8 Error Codes/Error Locations ............... 8
3.9 Listing References ........................ 8
4 QUALITY ASSURANCE ............................. 9
5 PREPARATIONS FOR DELIVERY ..................... 10
1 S̲C̲O̲P̲E̲
This document contains a detailed product specification of the monitor procedure TEST ̲HDB.
1.1 I̲n̲t̲r̲o̲d̲u̲c̲t̲i̲o̲n̲
TEST ̲HDB is a monitor procedure, used by the subsystems PIP, TEP and NSS, when accessing
messages located on HDB.
The HDB ̲file MTF (Message Test File) is a syclic file, which means that new messages meant
for storage will overwrite the oldest messages on the file.
Access to the MTF file is performed via the MTCB monitor, which gives the offset to and
length of the message.
If new messages arrive for storage in the time span between the MTCB call and the actual
file access, the message may be overwritten. To prevent data confusion (or illegal access
to the new message) the monitor TEST ̲HDB is called each time a read operation is performed.
The monitor tells the application whether the accessed data is legal or not.
1.2 A̲b̲b̲r̲e̲v̲i̲a̲t̲i̲o̲n̲s̲
Please refer to ref. I chapt. 1.2.
2 A̲P̲P̲L̲I̲C̲A̲B̲L̲E̲ ̲D̲O̲C̲U̲M̲E̲N̲T̲S̲
I :FIX/0100/MAN/0004 FIKS DATA INTERFACE REF.
II :FIX/1153/PSP/0097 SRS SUBSYSTEM PSP
III :FIX/1000/EWP/0080 FIKS S/W CONF. CTRL. LIB. DESCR. DOC.
3 M̲O̲D̲U̲L̲E̲ ̲S̲P̲E̲C̲I̲F̲I̲C̲A̲T̲I̲O̲N̲S̲
3.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
Input to the monitor is the DTG of the accessed message.
In critical region SRS ̲CR the DTG of the oldest message accessable on HDB is located. Each
time a detection is performed on the HDB files, the parameters in the critical region are
updated by SRS. (The parameters are always updated before overwriting takes place).
The input DTG and the DTG of the oldest message are compared.
If input DTG is less than oldest DTG the monitor returns in the error exit.
If the input DTG = 0 (retrieval time = 0 indicates that the message is not on HDB, which
means that overwriting cannot take place) or input DTG is bigger than oldest DTG, the monitor
exits in the OK-exit.
3.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲
SWELL call : MON (TEST ̲HDB, R0, R1, R7)
REGISTER INPUT OUTPUT
̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
R0 Ref. DTG Kept
R1 Ref. work area Kept
of 15 words
R7 Link Completion code
Return: LINK + 0: System error (at critical region access).
LINK + 1: Message cannot
be accessed (R7 = 0)
LINK + 2: Message can be
accessed (R7 = 0)
3.3 P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲
Fig. 3.3 shows the flow chart of TEST ̲HDB
Main events are:
The input DTG is fetched from applications process area (2).
If DTG is 0, the monitor is exited in Link + 2 (3,5)
If not, the DTG is examined:
The critical region SRS ̲CR is accessed and the DTG of oldest message on HDB is copied
(4,8).
The input DTG is converted from seconds to minutes (9) and compared with oldest DTG (10).
If DTG is less than oldest DTG, the link register is incremented by one, otherwise the
register is incremented by 2 (11,12).
The completion code is set and the monitor is exited (13,14).
FIG. 3.3
TEST ̲HDB, flow chart
3.4 D̲a̲t̲a̲ ̲O̲r̲g̲a̲n̲i̲z̲a̲t̲i̲o̲n̲
TEST ̲HDB uses the work area delivered by the application.
The work area is used to store registers and to build the name of the critical region SRS
̲CR.
Parameter offsets in SRS ̲CR.: please refer to ref. II chapt. 3.4.
3.5 S̲t̲o̲r̲a̲g̲e̲ ̲A̲l̲l̲o̲c̲a̲t̲i̲o̲n̲
Program space : 75 words
Process space : None
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̲
None
3.8 E̲r̲r̲o̲r̲ ̲C̲o̲d̲e̲s̲/̲E̲r̲r̲o̲r̲ ̲L̲o̲c̲a̲t̲i̲o̲n̲s̲
Error codes are returned to the application in register 7. Call of MON ERROR is done by the
application.
3.9 L̲i̲s̲t̲i̲n̲g̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲
Please refer to chapt. 5.
4 Q̲U̲A̲L̲I̲T̲Y̲ ̲A̲S̲S̲U̲R̲A̲N̲C̲E̲
N/A
5 P̲R̲E̲P̲A̲R̲A̲T̲I̲O̲N̲S̲ ̲F̲O̲R̲ ̲D̲E̲L̲I̲V̲E̲R̲Y̲
Command files used at generation of the object code (TEST ̲HDB.CR, TEST ̲HDB.CP, TEST ̲HDB.L0)
can be found in FIXLIB Source Directory (ref.III).
G̲e̲n̲e̲r̲a̲t̲i̲o̲n̲ ̲o̲f̲ ̲O̲b̲j̲e̲c̲t̲ ̲C̲o̲d̲e̲ ̲F̲i̲l̲e̲:̲
. Copy the source directory (ref. III) of the actual version into a work directory.
. Activate the command file TEST ̲HDB.CR
. Activate the command file TEST ̲HDB.CP
. Activate the command file TEST ̲HDB.L0
The code ready for installation is now found in TEST ̲HDB.C.
L̲i̲s̲t̲i̲n̲g̲s̲
Compiler and Linker printouts may be obtained by activating the command file TEST ̲HDB.PP
