top - download
⟦609515b5a⟧ Wang Wps File
Length: 20809 (0x5149)
Types: Wang Wps File
Notes: FIX/1364/PSP/0101
Names: »3366A «
Derivation
└─⟦0a6a0cf2a⟧ Bits:30006130 8" Wang WCS floppy, CR 0296A
└─ ⟦this⟧ »3366A «
WangText
…00……00……00…E…0a…E…0b……00……00…E…0c…E…0e……0d……00……0c……09……0c……0e……0c……00……0c… …0b……08……0b……0c……0b……0e……0b……00……86…1 …02… …02… …02… …02… …02…
3366A/296A…86…1 …02… …02… …02…
…02…FIX/1364/PSP/0101
…02…APE/890609…02……02…ii
FIKS TEPINT BACKGROUND IF SUBMODULE
…02…FMK/861217…02……02…FIKS
…06…1 …02… …02… …02… …02… …02…
FIKS TEPINT BACKGROUND IF SUBMODULE PSP
FIX/1364/PSP/0101
…0e…AK…0f…
…0f…FMK…0f…
…0e……0e…FMK (5), AK (4)
…0e… FIKS Prgrm.Mgr.
…0f…
…0e……0e…1.2…0f……0f…
…0e…890609…0f…
REVISION RECORD
REVISION RECORD
REVISION RECORD
REVISION RECORD
REVISION RECORD
̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…06…1 …02… …02… …02…
ISSUE DATE PAGES BRIEF
DESCRIPTION
OF
CHANGE
ISSUE DATE PAGES BRIEF
DESCRIPTION
OF
CHANGE
ISSUE DATE PAGES BRIEF
DESCRIPTION
OF
CHANGE
ISSUE DATE PAGES BRIEF
DESCRIPTION
OF
CHANGE
ISSUE DATE PAGES BRIEF
DESCRIPTION
OF
CHANGE
AFFECTED
AFFECTED
AFFECTED
AFFECTED
AFFECTED
̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ^ ^
^
1 ^830216 ^ All ^
First
issue
of
document.
^ ^ ^
1.1 ^861217 ^ DCN 1 ^
Changed
in
accordance
with
Order
no:
08/86
^ ^ ^
1.2 ^890609 ^ DCN 2 ^
Changed
in
accordance
with
Order
no:
29/88
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
TABLE OF CONTENTS
Page
1.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 SCCCMD Procedure .......................... 3
3.1.2 GET ̲SCCPAR ................................ 6
3.1.3 SCC ̲PAR ̲ ̲CK procedures .................... 7
3.1.4 VDUIO ̲EXEC procedures ..................... 8
3.2 Interface Description ....................... 10
3.2.1 SCCCMD procedure ........................... 10
3.2.2 GET ̲SCCPAR ................................ 11
3.2.3 SCC ̲PAR ̲CK procedures .................... 12
3.2.3.1 DEC ̲BIN procedure ....................... 12
3.2.3.2 CC ̲MID procedure ........................ 13
3.2.3.3 CC ̲NID procedure ........................ 14
3.2.3.4 CC ̲Y ̲N procedure ........................ 15
3.2.3.5 CK ̲ASCII procedure ...................... 16
3.2.4 VDUIO ̲EXEC procedures ..................... 17
3.2.4.1 VDUIO ̲SCC ............................... 17
3.2.4.2 WAIT ̲SCCLET ............................. 18
3.2.4.3 RETURN ̲SCCLET ........................... 19
3.3 Processing .................................. 20
3.3.1 SCCCMD procedure .......................... 21
3.3.2 GET ̲SCCPAR procedure ...................... 22
3.3.3 CK ̲SCC ̲PAR Procedures ..................... 25
3.3.3.1 DEC ̲BIN procedure ....................... 26
3.3.3.2 CC ̲MID procedure ........................ 27
3.3.3.3 CC ̲NID procedure ........................ 28
3.3.3.4 CC ̲Y ̲N procedure ........................ 29
3.3.3.5 CK ̲ASCII ................................ 30
3.3.4 VDUIO ̲EXEC procedures ..................... 31
3.3.4.1 VDUIO ̲SCC procedure ..................... 32
3.3.4.2 WAIT ̲SCCLET procedure ................... 33
3.3.4.3 RETURN ̲SCCLET procedure ................. 34
3.4 Data Organization\ ........................... 35
3.5 Storage Allocation .......................... 36
3.6 Performance Characteristic ................... 37
3.7 Limitations ................................. 38
3.8 Error Code/Error Locations ................... 39
3.9 Listing Reference ............................ 40
4. QUALITY ASSURANCE ............................ 41
4.1 Qualification Tests ......................... 41
4.2 Other Quality Assurance ..................... 41
5. PREPARATION FOR DELIVERY .................... 42
6. NOTES ....................................... 43
7. APPENDICES .................................. 44
1.1 S̲C̲O̲P̲E̲
This document describes the functions of the background interface procedures at the SCC.
1.1 I̲n̲t̲r̲o̲d̲u̲c̲t̲i̲o̲n̲
The background interface procedures support the interface between the terminal process (TEPINT)
and the background processes (SOP, DRP, DOI, DOT DSM, SGM, RIA, SPU).
1.2 A̲b̲b̲r̲e̲v̲i̲a̲t̲i̲o̲n̲s̲
Ref. 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 SYSTEM PSP FIX/1000/PSP/0038
FIKS DATA INTERFACE REFERENCE FIX/0100/MAN/0004
FIKS REQUIREMENTS SPECIFICATION FIX/0000/SPC/0002
FIKS S/W Configuration Control
Lib. Descr. Document FIX/1000/EWP/0080
FIKS S/W Configuration Control
Procedure FIX/1000/PRO/YYYY
Checkpoint Subsystem PSP FIX/1100/PSP/0041
DOI Subsystem PSP FIX/1161/PSP/0043
DOT Subsystem PSP FIX/1161/PSP/0044
DRP Subsystem PSP FIX/1161/PSP/0045
ESP SYSTEM PSP FIX/1105/PSP/0046
NES Subsystem PSP FIX/1162/PSP/0069
SCCM Subsystem PSP FIX/1266/PSP/0089
SOP Subsystem PSP FIX/1161/PSP/0094
SPU Subsystem PSP FIX/1161/PSP/0095
SYSCHP Procedure PSP FIX/1200/PSP/0093
System Test Report S050 FIX/0000/TRP/0081
TEPINT Subsystem PSP FIX/1164/PSP/0100
CR80 AMOS IO System PSP CSS/006/PSP/0006
UTA SUBSYSTEM PSP FIX/1167/PSP/0112
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̲
3.1.1 S̲C̲C̲C̲M̲D̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
The SCCCMD procedure supports the SCC operators in controlling and monitoring of the network.
The procedure is invoked when a command (except for LON, LOF and INT) is entered. According
to the command prompting will be performed. When the prompting has completed a background
process will be invoked by a message. The message will contain information to the background
process such as command identifications, prompt responses and a buffer address for later
use when reading and writing on the terminal from the background process. The communication
with the background process is shown in fig. 3.1.1-1.
terminal background
process process
receive
CMD
̲ ̲ ̲ ̲m̲e̲s̲s̲a̲g̲e̲ ̲ ̲ ̲1̲ ̲ ̲ ̲
d̲a̲t̲a̲ ̲t̲r̲a̲n̲s̲f̲e̲r̲ ̲2̲ ̲ ̲ ̲
̲ ̲ ̲ ̲m̲e̲s̲s̲a̲g̲e̲ ̲ ̲ ̲3̲ ̲ ̲ ̲
text
output 4
text
input 5
̲ ̲ ̲ ̲ ̲a̲n̲s̲w̲e̲r̲ ̲ ̲ ̲6̲ ̲ ̲ ̲
d̲a̲t̲a̲ ̲t̲r̲a̲n̲s̲f̲e̲r̲ ̲7̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲a̲n̲s̲w̲e̲r̲ ̲ ̲ ̲8̲ ̲ ̲ ̲
…01…Fig. 3.1.1-1
1. Background process invoked.
2. A text string has to be issued on the terminal, and it is written into the IO-buffer
in the terminal process.
3. A message is sent to the terminal process, indicating that the buffer is filled
with a text string for displaying, and a response from the operator is wanted.
4. The text string is displayed by the terminal process.
5. The operator reponse is read.
6. An answer is sent to the background process, indicating that the text string
is displayed, and the operator response is located in the IO-buffer in the terminal
process.
7. The background process reads the operator response.
8. The background process has finished the processing. This will result in an answer
sent to the terminal process, and the background process will wait for a new
message.
3.1.2 GET ̲SCCPAR
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
The function of the GET ̲SCCPAR procedure is to support prompting. A prompt will be issued
and the response is read. The operator input will be validated and converted into a binary
code.
3.1.3 SCC ̲PAR ̲CK procedures
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
The SCC ̲PAR ̲CK contains 5 procedures for converting and checking parameters.
The 5 functions are:
- DEC ̲BIN
Convert from ASCII decimal to binary
- CC ̲MID
Check and convert MEDE id
- CC-NID
Check and convert node id
- CC ̲Y ̲N
Check and convert Yes/No indicator
- CK-ASCII
Check for printable ASCII characters
3.1.4 VDUIO ̲EXEC procedures
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The VDUIO ̲EXEC contains 3 procedures for IO handling of an OCP process.
The 3 functions are:
- VDUIO ̲SCC
Controls actual IO on the operator terminal. The VDUIO ̲SCC procedure gets and delivers
data from/to the OCP procedure via a work area which address is given in a system message.
- WAIT ̲SCCLET
The procedure selects the background proces according to the command input. The background
process is invoked by a system message and the WAIT ̲SCCLET will wait for response from
the background process.
The WAIT ̲SCCLET procedure activates the following background processes:
- SOP ref. PSP/0094
- DRP ref. PSP/0045
- DOI ref. PSP/0043
- DOT ref. PSP/0044
- DSM ref. PSP/0069
- SGM ref. PSP/0069
- RIA ref. PSP/0086
- SPU ref. PSP/0095
- UTA ref. PSP/0112
- RETURN ̲SCCLET
The procedure returns an answer to the background process invoked by the WAIT ̲SCCLET
procedure.
The answer contains completion code and pointer to work area containing information according
to the selected IO routine.
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 S̲C̲C̲C̲M̲D̲ ̲p̲r̲o̲c̲e̲d̲u̲r̲e̲
The SCCCMD procedure is invoked by:
ITEP ̲MAIN ref. PSP/0100.
Input to SCCCMD procedure is:
…0e….…0f… Command identifications.
There is no output from SCCCMD procedure.
The SCCCMD procedure interfaces to the following procedures:
GET ̲SCCPAR ref. 3.1.2
Performs the prompting before the background process is invoked.
WAIT ̲SCCLET ref. 3.1.4.2
Communicates with the background process and supports input/output from/to the terminal.
3.2.2 GET ̲SCCPAR
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
The GET ̲SCCPAR procedure is invoked by:
SCCCMD ref. 3.1.1
WAIT-SCCLET ref. 3.1.4
Input to GET ̲SCCPAR procedure is:
- Register 4 ref. to parameter block
- Error line type (variable)
- Outstanding error (variable)
Output from GET ̲SCCPAR procedure is:
- Parameter block updated according to input
- Outstanding error updated.
The GET ̲SCCPAR procedure interfaces to the following
procedures:
ITRANSTER ref. PSP/0100
Input/Output from/to terminal
CK ̲ASCII ref. 3.1.3
Checks if input chars are of ASCII type
CC ̲MID ̲C ref. 3.1.3
Converts MEDE IS to binary
CC ̲NID ̲C ref. 3.1.3
Converts NODE ID to binary
DCE ̲BIN ref. 3.1.3
Converts an ASCII string of digits to an integer.
CC ̲Y ̲N ref.. 3.1.3
Converts input YES/NO to binary.
SCRAMBLE ̲PASSW PSP/0100
Scramble Passwords.
3.2.3 SCC ̲PAR ̲CK procedures
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
The procedures are invoked by the procedure
GET ̲SCCPAR ref. 3.1.2
3.2.3.1 DEC ̲BIN procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
Input data
R1: Ref. to ASCII decimal value
R2: No. of digits (max. 5)
R3: Ref. to work area (5 words)
Output data
R0: Binary value of the ASCII digits
The DEC ̲BIN procedure will not invoke any procedure.
3.2.3.2 CC ̲MID procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
Input data
R3: ASCII MEDE id
Output data
R0: Binary MEDE id
The CC ̲MID procedure interfaces to the following monitor procedure
MON SCCM GET ̲NM ̲IDB
Get binary value of NM id
3.2.3.3 CC ̲NID procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
Input data
R3: ASCII node id
Output data
R0: Binary node id
The CC ̲NID procedure interfaces to the following monitor procedure
MON SCCM GET ̲NM ̲IDB
Get binary value of NM id
3.2.3.4 CC ̲Y ̲N procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
Input data
R3: ASCII char (Y or N)
Output data
R0: Binary indicator (Yes = 1, No = 0)
The CC ̲Y ̲N procedure will not invoke any procedure.
3.2.3.5 CK ̲ASCII procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
Input data
R1: Ref. fo ASCII data
R2: No. of characters
Output data
None
The CK ̲ASCII procedure will not invoke any procedure.
3.2.4 VDUIO ̲EXEC procedures
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.4.1 VDUIO ̲SCC
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
The procedure is invoked by
WAIT ̲SCCLET ref. 3.1.4
Input to VDUIO ̲SCC
- Register 1 IO command
- Register 4 ref. to parameter block
- ERROR ̲LINE ̲TYPE (var)
Indicates error position on screen
Output from VDUIO ̲SCC
- Clear "old" error code on screen
- Updates answer for background process according to input
- IO buffer is updated if input-request.
The VDUIO ̲SCC interfaces to the following procedures
ITERR ref. PSP/0099
Display error code
ITRANSFER ref. PSP/0099
Write to terminal
Read from terminal
3.2.4.2 WAIT ̲SCCLET
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
The procedure is invoked by
SCCCMD ref. 3.1.1
Input to WAIT ̲SCCLET
- Register 4 a reference to parameter block
Output from WAIT ̲SCCLET
None
The WAIT ̲SCCLET interfaces to the following procedures
VDUIO ̲SCC ref. 3.1.4
Write and read to/from terminal
RETURN ̲SCCLET ref. 3.1.4
Send answer (completion code)
MON SENDMESSAGE
Send message to background process
MON WAITEVENT
Wait for response from background process
3.2.4.3 RETURN ̲SCCLET
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
The procedure is invoked by
WAIT ̲SCCLET ref. 3.1.4
Input to RETURN ̲SCCLET
- Register 4 a reference to parameter block
Output from RETURN ̲SCCLET
None
The RETURN ̲SCCLET interfaces to the following procedure
MON SENDANSWER
Send completion code
3.3 P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲
Please ref. overleaf pages for flow-charts.
3.3.3 CK ̲SCC ̲PAR procedures
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.3.4 VDUIO ̲EXEC procedures
…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 sec. 3.9.
3.5 S̲t̲o̲r̲a̲g̲e̲ ̲A̲l̲l̲o̲c̲a̲t̲i̲o̲n̲
Please refer to:
FIKS S/W Configuration
Control Lib. Descr. Doc. FIX/1000/EWP/0080
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̲
N/A
3.7 L̲i̲m̲i̲t̲a̲t̲i̲o̲n̲s̲
The procedures must not be part of the background processes.
3.8 E̲r̲r̲o̲r̲ ̲C̲o̲d̲e̲/̲E̲r̲r̲o̲r̲ ̲L̲o̲c̲a̲t̲i̲o̲n̲s̲
In case of an operator error, the background I/F procedures will issue an error notification
to the operator. The error codes are listed here:
? - 6:001 Syntax error
? - 6:004 Input has illegal value
? - 6:005 Chars not ASCII digits
Error locations: None.
3.9 L̲i̲s̲t̲i̲n̲g̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲
Please refer to:
FIKS S/W Configuration
Control Lib. Descr. Doc. FIX/1000/EWP/0080
The procedures:
o CC ̲NID
o CC ̲MID
o CK ̲ASCII
o CC ̲Y ̲N
o DEC ̲BIN
are all located in the source listing named:
CK ̲SCC ̲PAR.
The procedures:
o VDUIO ̲SCC
o WAIT ̲SCCLET
o RETURN ̲SCCLET
are all located in the source listing named:
VDUIO ̲EXEC.
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 S50 FIX/0000/TRP/0081
4.2 O̲t̲h̲e̲r̲ ̲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̲ ̲F̲O̲R̲ ̲D̲E̲L̲I̲V̲E̲R̲Y̲
Please refer to:
FIKS S/W Configuration
Control Lib. Descr. Doc. FIX/1000/EWP/0080…86…W …02… …02… …02… …02… …02… …02… …02… …02…
6. N̲O̲T̲E̲S̲
N/A
7. A̲P̲P̲E̲N̲D̲I̲C̲E̲S̲
N/A
