top - download
⟦f322f89ff⟧ Wang Wps File
Length: 10770 (0x2a12)
Types: Wang Wps File
Notes: RECMES PROCEDURE PSP
Names: »3180A «
Derivation
└─⟦0f96917ac⟧ Bits:30006134 8" Wang WCS floppy, CR 0287A
└─ ⟦this⟧ »3180A «
WangText
…14……00……00……00……00……05……0a……00……00……05……0b……05…
…05……05……05……07… …09… …0b… …0d… …0e… …01……86…1 …02… …02… …02…
…02…FIX/1200/PSP/0083
…02…MLA/821220…02……02…
RECMES PROCEDURE PSP
…02……02…FK 7809
TABLE OF CONTENTS Page
1. SCOPE ................................................ 1
1.1 Introduction ................................... 1
1.2 Abbreviations .................................. 1
2. APPLICABLE DOCUMENTS ................................. 2
3. MODULE SPECIFICATIONS ................................. 3
3.1 Functional Capabilities ........................ 3
3.1.1 RECMES main ................................ 3
3.1.2 INS ̲LF ..................................... 4
3.1.3 COMPLETE ̲REC ............................... 5
3.2 Interface Description .......................... 6
3.2.1 RECMES main ................................ 6
3.2.1.1 Internal Interface .................... 6
3.2.1.2 External Interface .................... 7
3.2.2 INS ̲LF ..................................... 9
3.2.2.1 Internal Interface .................... 9
3.2.2.2 External Interface .................... 9
3.2.3 COMPLETE ̲REC ............................... 10
3.2.3.1 Internal Interface .................... 10
3.2.3.2 External Interface .................... 11
3.3 Processing ..................................... 13
3.3.1 RECMES main ................................ 13
3.3.2 INS ̲LF ..................................... 15
3.3.3 COMPLETE ̲REC ............................... 16
3.4 Data Organization .............................. 21
3.5 Storage Allocation ............................. 22
3.6 Performance Characteristics .................... 23
3.7 Limitations .................................... 24
3.8 Error Codes/Error Locations .................... 25
3.9 Listing Reference .............................. 27
4. QUALITY ASSURANCE .................................... 28
4.1 Qualification Tests ............................ 28
4.2 Other Quality Assurance Provisions ............. 28
5. PREPARATIONS FOR DELIVERY ............................ 29
6. NOTES ................................................ 30
7. APPENDICES ........................................... 31
1. S̲c̲o̲p̲e̲
This document describes the design of the Message Recovery Subsystem (RECMES)
1.1 I̲n̲t̲r̲o̲d̲u̲c̲t̲i̲o̲n̲
The purpose of the RECMES is to complete message, which were in preparation when a switchover
occured
1.2 A̲b̲b̲r̲e̲v̲i̲a̲t̲i̲o̲n̲s̲
Please refer to:
FIKS DATA INTERFACE REFERENCE:FIX/0100/MAN/0004
2 A̲p̲p̲l̲i̲c̲a̲b̲l̲e̲ ̲D̲o̲c̲u̲m̲e̲n̲t̲s̲
FIKS Data I/F Reference FIX/0100/MAN/0004
GET ̲DTG Monitor PSP FIX/12561PSP/0049
MES Submodule PSP FIX/1351/PSP/0060
MTCB Monitor PSP FIX/1256/PSP/0066
FIKS S/W Configuration Control Lib. Descr. Doc.
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̲
3.1.1 R̲E̲C̲M̲E̲S̲ ̲M̲a̲i̲n̲
The RECMES process will scan the PDB-File Tables for every terminal at the MEDE to find narrative
messages which are not complete. The brinary header and the MTCB…08…s are examined to find out
how much of the message is missing in being complete. When this is done the message will
be completed and check pointed. …86…W …02… …02… …02… …02… …02…
3.1.2 I̲N̲S̲-̲L̲F̲
The procedure locales the start of the last line in the message. A "LF" will be inserted
at the end of the line, and the byte count of the line will be adjusted. The last line will
be written to file again.
3.1.3 C̲o̲m̲p̲l̲e̲t̲e̲ ̲R̲e̲c̲
The procedure will complete a message, when the main precedure RECMES has discovered a message,
which is not complete.
3.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲
3.2.1 R̲E̲C̲M̲E̲S̲ ̲m̲a̲i̲n̲
3.2..1.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The RECMES Main Procedure is invoked by:
ESP Ref: PSP/0046
Input to RECMES Procedure is:
. Checkpointed data as
. PDB File Table
. PDB Files
. MTCB…08…s
Output from RECMES Procedure is:
. All messages referred in the PDB-File table are completed.
The RECMES Main Procedure Interfaces to the following procedure
COMPLETE ̲REC Ref: sec. 3.1.3.
3.2.1.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The RECMES Main Procedure interfaces to the following monitor procedures:
MON IO GETROOT
Gets file descriptor for volumes.
MON REGION RENTER
Enters a critical region (PDBTAB)
MON REGCON RGETN
Reads a critical region (PDBTAB)
MON REGION RCOPYN
Reads a critical region (CONFIG)
MON REGION RLEAVE
Leaves a critical region (PDBTAB)
MON MTCB INITE
Initializes the MTCB work area
MON MTCB READ
Reads MTCB…08…s
MON ERROR
Terminates process in case of an error
MON SEND MESSAGE
Sends message to checkpoint process
MON WAITEVENT
Waits answer from Checkpoint process
MON TERMINATE
Terminates the process when all messages completed
3.2.2 INS ̲LF
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.2.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The INS ̲LF Procedure is invoked by:
COMPLETE ̲REC Ref. sec 3.1.3
Input to INS ̲LF procedure is:
. Last part of message in a buffer
Output from INS ̲LF Procedure is:
. completion code
. the last line incl. byte count and "LF" written to file.
3.2.2.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The INS ̲LF Procedure interfaces to the follwing monitor procedures:
MON IO MODIFYBYTES
Writes line to file
MON ERROR
Terminates the process
3.2.3 COMPLETE ̲REC
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.3.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The COMPLETE ̲REC procedure is invoked by:
RECMES Main Procedure Ref. 3.1.1
Input to COMPLETE ̲REC procedure is:
. Message on file
. MICB for do
. MTCB for address list
. file for address list if any
Output from COMPLETE ̲REC procedure is:
. message completed
. PDBTAB updated
. alist resource released
. completion code
The COMPLETE ̲REC procedure interfaces to the following
procedure:
INS ̲LF Ref: sec 3.1.2…86…W
…02… …02… …02… …02…
…02…
3.2.3.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The COMPLETE ̲REC procedure interfaces to the following
monitor procedures:
MON MTCB GET FILE
Gets file descriptor for message- and address list
file
MON IO GET FILE INFORMATION
Gets size of message
MON IO READ BYTES
Reads bytes from file to buffer
MON IO MODIFY BYTES
Updates file with buffer contents
MON GETDTG
Reads system time
MONNMTCB WRITE
Updates the message MTCB
MON IO UPDATE
Updates System Volume
MON REGION RPUTN
Updates a critical region (PDBTAB)
MON SEND MESSAGE
Sends a message to checkpoint process
MON WRITEVENT
waits for an answer from checkpoint process.
MON MTCB RELEASE FILE
Decrements the file use count
MON MTCB RESERVE
Increments the MTCB use count
MON MTCB RELEASE
Decrements the MTCB use count
MON ERROR
Terminates the process in case of an error…86…W …02… …02… …02… …02…
…02…
3.3 P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲
3.3.1 R̲E̲C̲M̲E̲S̲ ̲m̲a̲i̲n̲
3.3.2 INS ̲LF
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.3.3 COMPLETE ̲REC
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
.
.
.
.
.
3.4 D̲a̲t̲a̲ ̲O̲r̲g̲a̲n̲i̲z̲a̲t̲i̲o̲n̲
Please refer to source listing
3.5 S̲t̲o̲r̲a̲g̲e̲ ̲A̲l̲l̲o̲c̲a̲t̲i̲o̲n̲
Please refer to the SCCLDD Document
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̲
N/A
3.7 L̲i̲m̲i̲t̲a̲t̲i̲o̲n̲s̲
The RECMES process has to be run before any terminal process in case of a switch over.
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̲
The RECMES Process will report error codes, received form monitor procedures on the consol
together with an error label which points out the location in the RECMES. The error labels
are listed below:
"ERROR LABELS FOR RECOVERY.MES
GETROOT ̲MOV =# 10;
GETROOT ̲FIX =# 20;
INIT ̲MTCB =# 30;
ENTER ̲PDB =# 40;
READ ̲CONFIG =# 50;
GET ̲PDB =# 60;
PDB ̲SCAN ̲ERROR =# 70;
CHECKPOINT ̲1 =# 80;
READ ̲MTCB ̲1 =# 90;
READ ̲MTCB ̲2 =#100;
LEAVE ̲PDB =#110;
"ERROR LABELS FOR COMPLETE ̲REC
GET ̲FILE ̲MSG =#200;
GET ̲FILE ̲INF =#210;
READ ̲BINHEAD =#220;
READ ̲LINE =#230;
WRITE ̲BT ̲1 =#240;
WRITE ̲BT ̲2 =#250;
WRITE ̲ALIST ̲MTCB =#260;
GET ̲FILE ̲ALIST =#270;
READ ̲ALIST ̲FILE =#280;
WRITE ̲ALIST ̲FILE =#290;
GET ̲DTG =#300;
WRITE ̲DTG ̲FILE =#310;
WRITE ̲BIN ̲HEAD =#320;
WRITE ̲MTCB =#330;
IO ̲UPDATE =#340;
PUT ̲PDB =#350;
CHECKPOINT ̲2 =#360;
REL ̲FILE ̲ALIST =#370;
RES ̲MTCB ̲MSG =#380;
REL ̲FILE ̲MSG =#390;
REL ̲MTCB =#400;
"ERROR LABELS FOR INS ̲LF
WRITE ̲LINE =#500;
3.9 L̲i̲s̲t̲i̲n̲g̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲
Please refer to the SCCLDD Document
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̲
Please refer to:
Syustem Test Report 5080 FIX/0000/TRP/089
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̲
N/A…86…1 …02… …02… …02… …02… …02…
5 P̲r̲e̲p̲a̲r̲a̲t̲i̲o̲n̲s̲ ̲f̲o̲r̲ ̲D̲e̲l̲i̲v̲e̲r̲y̲
Please refer to the SCCLDD Document
6 N̲o̲t̲e̲s̲
N/A
7 A̲p̲p̲e̲n̲d̲i̲c̲e̲s̲
N/A