top - download
⟦61e728776⟧ Wang Wps File
Length: 18631 (0x48c7)
Types: Wang Wps File
Notes: FIX/1161/PSP/0043
Names: »3253A «
Derivation
└─⟦0a6a0cf2a⟧ Bits:30006130 8" Wang WCS floppy, CR 0296A
└─ ⟦this⟧ »3253A «
WangText
…02…FIX/1161/PSP/0043
…02…MLA/830114…02……02…
DOI SUBSYSTEM PSP
…0f……02……02…FK 7809
1 SCOPE ..........................................
1.1 Introduction ...............................
1.2 Abbreviations ..............................
2 Applicable Documents ...........................
3 Module Specification ...........................
3.1 Functional Capabilities ....................
3.1.1 DOI Main ...............................
3.1.2 ANO ̲DISP ...............................
3.1.3 AIG ̲DISP ...............................
3.1.4 INIT ̲LINE ..............................
3.1.5 MTCBMINIT ..............................
3.1.6 GETCMD .................................
3.1.7 VDUIO ..................................
3.1.8 ROPIO ..................................
3.1.9 INSERT ̲MTCB ............................
3.1.10 INSERT ̲QE ............................
3.1.11 INSERT ̲QE ̲RES ........................
3.2. Interface Description ....................
3.2.1 DOI Main .............................
3.2.1.1 Internal Interface .................
3.2.1.2 External Interface .................
3.2.2 ANO ̲DISP .............................
3.2.2.1 Internal Interface .................
3.2.2.2 External Interface .................
3.2.3 AIG ̲DISP .............................
3.2.3.1 Internal Interface .................
3.2.3.2 External Interface .................
3.2.4 INIT ̲LINE ............................
3.2.4.1 Internal Interface .................
3.2.4.2 External Interface .................
3.2.5 MTCBMINIT ............................
3.2.5.1 Internal Interface .................
3.2.5.2 External Interface .................
3.2.6 GETCMD ...............................
3.2.6.1 Internal Interface .................
3.2.6.2 External Interface .................
3.2.7 VDUIO ................................
3.2.7.1 Interface Description ..............
3.2.7.2 External Interface .................
3.2.8 ROPIO ................................
3.2.8.1 Internal Interface ................
3.2.8.2 External Interface .................
3.2.9 INSERT ̲MTCB ..........................
3.2.9.1 Internal Interface .................
3.2.9.2 External Interface .................
3.2.10 INSERT ̲QE ............................
3.2.10.1 Internal Interface ................
3.2.10.2 External Interface ................
3.2.11 INSERT ̲QE ̲RES ........................
3.2.11.1 Internal Interface ................
3.2.11.2 External Interface ................
3.3 Processing ...............................
3.3.1 DOI ̲MAIN .............................
3.3.2 ANO ̲DISP .............................
3.3.3 AIG ̲DISP .............................
3.3.4 INIT ̲LINE ............................
3.3.5 MTCBMINIT ............................
3.3.6 GETCMD ...............................
3.3.7 VDUIO ................................
3.3.8 ROPIO ................................
3.3.9 INSERT ̲MTCB ..........................
3.3.10 INSERT ̲QE ............................
3.3.11 INSERT ̲QE ̲RES ........................
3.4 Data Organization ..........................
3.5 Storage Allocation .........................
3.6 Performance Characteristics ................
3.7 Limitations ................................
3.8 Error Codes/Error Locations ................
3.9 Listing References .......................
4 QUALITY ASSURANCE ..............................
4.1 Qualification Tests ........................
4.2 Other Quality Assurance Provisions .........
5 PREPARATION FOR DELIVERY .......................
6 NOTES ..........................................
7 APPENDICES .....................................
1 S̲C̲O̲P̲E̲
This document describes the function of the DOI Subsystem.
1.1 I̲n̲t̲r̲o̲d̲u̲c̲t̲i̲o̲n̲
The purpose of the DOI is to display the existance of ANO's and AIG's to the SCC operator.
1.2 A̲b̲b̲r̲e̲v̲i̲a̲t̲i̲o̲n̲s̲
Please refer to:
FIKS Data I/F 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
MTCB Monitor PSP FIX/1256/PSP/0066
SCCM Subsystem PSP FIX/1266/PSP/0089
GET ̲DTG Monitor PSP FIX/1256/PSP/0050
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 D̲O̲I̲ ̲M̲a̲i̲n̲
The DOI Process will convert and display the contents of a existance map from the RDF File.
To define which existance map to display the operator is interrogated as follows:
Table Id: the answer can be ANO or AIG in case of ANO the next question will be Mede id:
where the answer must be one of the following letters: A, B,E,F,H,K,L,N,T,U,V,W,
or X.
The content of the existnce map will then be displayed on the VDU, and thereafter the operator
has the possibility to get the displayed table printed on the AUX printer ( i.e. the ROP
connected to the VDU 3).…86…W …02… …02… …02… …02… …02…
3.1.2 A̲N̲O̲-̲D̲I̲S̲P̲
The ANO ̲DISP procedure will read the requested ANO existance map from the RDF File. The
existance map is scanned and converted to 'X''s if ANO exists and '-''s if it does not.
The converted existance map is moved to a output-buffer. The output buffer will be appended
to a file for later print out and then it will be displayed.
3.1.3 A̲I̲G̲ ̲D̲I̲S̲P̲
The AIG ̲DISP procedure will read the AIG existance map from the RDF-file. The existance
map is scanned and converted to 'X''s if AIG exists and '-''s, if it does not. The coverted
existance map is moved to an output buffer. The output buffer will be appended to a file
for later print out and then it will be displayed.
3.1.4 I̲N̲I̲T̲ ̲L̲I̲N̲E̲
The INIT ̲LINE procedure is filling the output buffer with spare chars and a 'NL' char.
3.1.5 M̲T̲C̲B̲ ̲M̲I̲N̲I̲T̲
The MICBMINIT procedure gets the file descriptors for the system volumes (MOVHEAD and FIXHEAD)
and initiates the MTCB Monitor.
3.1.6 G̲E̲T̲C̲M̲D̲
In the GETCMD procedure the DOI process will wait for an operator command.
3.1.7 V̲D̲U̲I̲O̲
The VDUIO procedure is used to input and output data from and to the VDU.
3.1.8 R̲O̲P̲I̲O̲
The ROPIO procedure has two functions:
. It creates and updates a file for the converted existance map.
. It enqueues the file with the converted existance map to the printer process (HSPPO3)
if requested and releases the resources.
3.1.9 I̲N̲S̲E̲R̲T̲ ̲M̲T̲C̲B̲
The INSERT ̲MTCB procedure creates a MTCB and updates it with the content of a buffer.
3.1.10 I̲N̲S̲E̲R̲T̲ ̲Q̲E̲
The INSERT ̲QE procedure inserts a queue element into a specified queue.
Usecount of the MTCB referenced by the queue is unchanged.
3.1.11 I̲N̲S̲E̲R̲T̲ ̲Q̲E̲ ̲R̲E̲S̲
The INSERT ̲QE ̲RES procedure inserts a queue element into a specified queue. Use count of
the MTCB referenced by the queue is incremented by one.
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 D̲O̲I̲ ̲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 DOI Main procedure is invoked by:
ESP: Ref. PSP/0046
Output from DOI main procedure is:
. An existance map displayed and, if requested, printed.
The DOI main procedure interfaces to the following procedures:
MTCBMINIT Ref. 3.1.5.
Initiates the MTCB monitor.
GETCMD Ref. 3.1.6
Waits for an operator command.
VDUIO Ref. 3.1.7
Prompts for MEDE ̲ID and reads the responce.
ANO ̲DISP Ref: 3.1.2
Reads, converts, displays and prints the requested ANO existance map.
AIG ̲DISP Ref: 3.1.3
Reads, converts, displays and prints the AIG existance map.
INSERT ̲MICB Ref: 3.1.9
Creates and updates a MTCB.
ROPIO Ref: 3.1.8
Enqueues the existance map for printout if requested.
3.2.1.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The DOI main procedure interfaces to the following monitor procedures:
MON IO GETROOT
Gets file descriptor to FIXHEAD
MON IO LOOKUP
Get file descriptor to RDF
MON GETDTG
Reads system time
MON TERMINATE
Terminates the process in case of an error
3.2.2 ANO ̲DISP
…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 ANO ̲DISP procedure is invoked by DOI main Ref: 3.1.1
Input to the ANO ̲DISP procedure is
. Mede Id for the requested existance map.
Output from the ANO ̲DISP procedure is
. existance map displayed
. existance map copied to file for printout
. completion code.
The ANO ̲DISP procedure interfaces to the following procedure:
VDUIO Ref: 3.1.7
Outputs data to VDU.
INIT ̲LINE Ref: 3.1.4
fills output buffer with spare chars.
ROPIO Ref: 3.1.8
Appends data to file for printout.
3.2.2.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The ANO ̲DISP procedure interfaces to the following monitor procedure:
MON IO READBYTES
Reads from the RDF-file.
3.2.3 AIG ̲DISP
…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 AIG ̲DISP procedure is invoked by:
DOI MAIN Ref: 3.1.1
Output from the AIG ̲DISP procedure is:
. existance map displayed.
. existance map copied to file for printout.
. completion code.
The AIG ̲DISP procedure interfaces to the following procedures:
INIT ̲LINE Ref: 3.1.4
fill the output buffer with space chars.
VDUIO Ref: 3.1.7
Output data to VDU.
ROPIO Ref: 3.1.8
Appends data to file for printout.
3.2.3.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The AIG ̲DISP procedure interfaces to the following monitor procedure:
MON IO READ BYTES
Reads from the RDF-file
3.2.4 INIT ̲LINE
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.4.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The INIT ̲LINE procedure is invoked by:
ANO ̲DISP Ref: 3.1.2
AIG ̲DISP Ref: 3.1.3
Input to INIT ̲LINE procedure is:
. Output buffer to be initiated.
Output from INIT ̲LINE procedure is:
. Output buffer filled with space chars.
3.2.4.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
N/A…86…W …02… …02… …02… …02… …02…
3.2.5 M̲T̲C̲B̲I̲N̲I̲T̲
3.2.5.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The MTCBMINIT procedure is invoked by:
DOI main Ref: 3.1.1
Output from MTCBMINIT procedure is:
. file descriptor for MOVHEAD
. file descriptor for FIXHEAD
. MTCB work area initiated
. completion code
3.2.5.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The MTCBMINIT procedure interfaces to the following monitor procedures:
MON IO GET ROOT
Gets the file descriptors for MOVHEAD and FIXHEAD
MON MTCB INITE
Initiates the MTCB work area.
3.2.6 G̲E̲T̲C̲M̲D̲
3.2.6.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The GETCMD proceudre is invoked by:
DOI main Ref: 3.1.1
Input to GETCMD proceudre is:
. ref. to VDUCB
Output from GETCMD procedure is:
. VDUCB updated according to operator cmd.
. completion code
3.2.6.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The GETCMD procedure interfaces to the following monitor procedure:
MON SCCM GET ̲CMD
Gets the operator cmd.
3.2.7 V̲D̲U̲I̲O̲
3.2.7.1 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲
The VDUIO procedure is invoked by:
DOI main Ref: 3.1.1
Input to the VDUIO procedure is:
. ref to VDUCB
Output from the VDUIO procedure is:
. VDUCB updated
. completion code
3.2.7.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The VDUIO procedure interfaces to the following monitor procedure:
MON SCCM VDU ̲IO
Inputs/outputs data from/to the VDU
3.2.8 R̲O̲P̲I̲O̲
3.2.8.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The ROPIO procedure is invoked by:
DOI main Ref: 3.1.1
ANO ̲DISP Ref: 3.1.2
AIG ̲DISP Ref: 3.1.3
Input to ROPIO procedure is:
. Flag for update of file or print
. Ref to VDUCB
Output from ROPIO procedure is:
. If flag update of file
. file created if first update
. file updated
. if flag print
. an entry in printqueue
. resources released
. completion code
The ROPIO procedure interfaces to the following procedure:
VDUIO Ref: 3.1.7
Data input/output from/to the VDU
INSERT ̲QE ̲RES Ref: 3.1.11
Enqueuing to print
3.2.8.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The ROPIO procedure interfaces to the following monitor procedures:
MON MTCB CREATE
Creates a MICB
MON MICR CREATEFILE
Creates a file
MON MTCB RELEASE
Releases a MTCB
MON MTCB RELEASEFILE
Releases a file
MON IO APPENDBYTES
Appends the output buffer to file
MON ERROR
Terminals the process in case of an error
3.2.9 INSERT ̲MTCB
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.9.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The INSERT ̲MTCB procedure is invoked by:
DOI main Ref: 3.1.1
Input to INSERT ̲MTCB proceudre is:
. MTCB index
. MTCB buffer
Output from INSERT ̲MTCB procedure is:
. MTCB updated
. completion code
3.2.9.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The INSERT ̲MTCB procedure interfaces to the following monitor procedures:
MON SCCM WR ̲MTCB
Updates the MTCB.
3.2.10 INSERT ̲QE
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.10.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The INSERT ̲QE procedure is invoked by:
DOI main Ref: 3.1.1
Input to INSERT ̲QE procedure is:
. Terminal no
. Queue no
. MTCB index
Output from INSERT ̲QE procedure is:
. Completion code
3.2.10.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The INSERT ̲QE procedure is interfacing to the following monitor procedure:
MON SCCM INS ̲QE
Inserts an entry in a specified queue.
3.2.11 INSERT ̲QE ̲RES
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.11.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The INSERT ̲QE ̲RES procedure is invoked by:
ROPIO Ref: 3.8.1
Input to INSERT ̲QE ̲RES is:
. Terminal no
. Queue no
. MTCB index
Output from INSERT ̲QE ̲RES is:
. completion code
3.2.11.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The INSERT ̲QE ̲RES procedure is interfacing to the following monitor procedures:
MON MTCB RESERVE
Increments MTCB usecount
3.4 D̲a̲t̲a̲ ̲O̲r̲g̲a̲n̲i̲z̲a̲t̲i̲o̲n̲
Please refer to sourcelisting
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̲
N/A
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 returned by monitor procedures are reported at the consol together with an error
lable which points out the location in the procedures where the error occurred.
The error lables are listed below:
LOC ̲VDUPAR ̲A = 111
LOC ̲GETROOT = 12
LOC ̲LOOKUP = 13
LOC ̲RB ̲NMI = 14
LOC ̲RB ̲FINAL = 15
LOC ̲RB = 16
LOC ̲VDUIO ̲A = 81
LOC ̲VDUIO ̲B = 82
LOC ̲MTCB = 19
LOC ̲INMTCB = 24
LOC ̲INSQE
3.9 L̲i̲s̲t̲i̲n̲g̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲
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
System Test Report S050 FIX/0000/TPR/0086
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
5 P̲R̲E̲P̲A̲R̲A̲T̲I̲O̲N̲ ̲F̲O̲R̲ ̲D̲E̲L̲I̲V̲E̲R̲Y̲
Following procedures will not be in the DOI directory at the FIXLIB volume:
. MTCBMINIT
. GETCMD
. VDUIO
. INSERT ̲MTCB
. INSERT ̲QE
. INSERT ̲QE ̲RES
As they are common procedures shared with other operator interfacing processes.
The procedures will be located in:
FIXLIB SCCNAMES directory
The GETCMD and VDUIO procedures are part of the file VDUIO.
The INSERT ̲MTCB, INSERT ̲QE and INSERT ̲QE ̲RES procedures are part of the file IO.
6 N̲O̲T̲E̲S̲
N/A
7 A̲P̲P̲E̲N̲D̲I̲C̲E̲S̲
N/A
