top - download
⟦686030e20⟧ Wang Wps File
Length: 6092 (0x17cc)
Types: Wang Wps File
Notes: FIX/1100/PSP/0105
Names: »3343A «
Derivation
└─⟦0f96917ac⟧ Bits:30006134 8" Wang WCS floppy, CR 0287A
└─ ⟦this⟧ »3343A «
WangText
…02…FIX/1100/PSP/0105
…02… JL/830208…02……02…#
TIMER SUBSYSTEM PSP
…02……02…FK 7809
T̲A̲B̲L̲E̲ ̲O̲F̲ ̲C̲O̲N̲T̲E̲N̲T̲S̲
1 SCOPE .......................................... 0001
2 APPLICABLE DOCUMENTS ........................... 0002
3 SPECIFICATIONS ................................. 0003
3.1 Functional Capabilites ..................... 0003
3.2 Interface Description ...................... 0004
3.3 Processing ................................. 0006
3.4 Data Organization .......................... 0007
3.5 Storage Allocation ......................... 0009
3.6 Performance Characteristics ................ 0010
3.7 Limitations ................................ 0011
3.8 Error Codes/Error Locations ................ 0012
3.9 Listing References ......................... 0013
4 QUALITY ASSURANCE .............................. 0014
4.1 Qualification Tests ........................ 0014
4.2 Other Quality Assurance Provisions ......... 0014
5 PREPARATIONS FOR DELIVERY ...................... 0015
6 NOTES .......................................... 0016
1 S̲C̲O̲P̲E̲
This document describes t̲h̲e̲ ̲T̲i̲m̲e̲r̲, which is a utility program within the FIKS N/M - as well
as the SCC Software
2 A̲P̲P̲L̲I̲C̲A̲B̲L̲E̲ ̲D̲O̲C̲U̲M̲E̲N̲T̲S̲
1. TEST REPORT FOR THE TIMER
FIX/1105/TRP/0021
Issue 1, 810119
3 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̲e̲s̲
The Timer Process awakes a process by returning an answer to it when desired, containing
an identification as specified by the process when requesting the call.
The Timer Process may simultaneously take care of a large number of requests from several
processes.
The Timer Process uses the Real Time Clock (RTC) of AMOS.
3.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲
A process requests the Timer Process to be awaked by sending a message to it:
MON SENDMESSAGE; send message ( :TIMER: ,
message;
event-id)
Register use at:
CALL RETURN
0 ref TIMER unchanged
1 addr. of message unchanged
2 not used message buffer ident.
7 link destroyed
Message (0) : type
- (1) : time interval (number of seconds)
- (2) : identification
- (3) : -
- (4) : -
t̲y̲p̲e̲ : 0 : request to be called once: when the
time interval specified has elapsed
1 : not used
2 : request to be called once: on the hour
plus the time interval specified.
The t̲i̲m̲e̲ ̲i̲n̲t̲e̲r̲v̲a̲l̲ fulfils
0 ̲ time interval ̲ 32767 s = 09h 06m 07s
The i̲d̲e̲n̲t̲i̲f̲i̲c̲a̲t̲i̲o̲n̲ of the request may be any 16 bit pattern.
After the period of time has elapsed an answer is returned.
The i̲d̲e̲n̲t̲i̲f̲i̲c̲a̲t̲i̲o̲n̲ of the call request will be returned in the answer. The process is awoken
by wait event, wait answer or wait operations:
MON WAITEVENT ; wait event (answer, mask , delay; type, eventid)
Register use at:
CALL RETURN
0 0 eventtype = answer (BNANS)
1 addr. of answer unchanged
2 eventmask = answer (BNANS) answer buffer ident.
7 link destroyed
answer (0) : -
(1) : -
(2) : identification from original message
(3) : completion code
(4) : -
The completion code is described in chapter 3.8.
A process may forward several requests to the Timer before waiting for call.
3.3 P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲
3.4 D̲a̲t̲a̲ ̲O̲r̲g̲a̲n̲i̲z̲a̲t̲i̲o̲n̲
The Timer maintains a table of waiting processes containing the time for calling, the identification
of the call and of the message/answer, see fig. 3.4.-1.
FIG. 3.4-1:
THE CALL TABLE
3.5 S̲t̲o̲r̲a̲g̲e̲ ̲A̲l̲l̲o̲c̲a̲t̲i̲o̲n̲
The size of the code is 298 instructions.
The data occupies 641 words
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̲
The number of entries of the call table equals:
NSS 100 entries
PIP 30 -
PSM001 1 -
SAF 1 -
C̲P̲M̲ ̲ ̲1̲ ̲ ̲-̲ ̲
total 133 entries
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 answer from the Timer contains a completion code (ref. chapter 3.2):
Completion code: 0 : no error
1 : unknown process
2 : parameter error
3 : no free entry
3.9 L̲i̲s̲t̲i̲n̲g̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲
Ref. to SOURCE LIBRARY
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̲
The test is described in ref. (1).
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̲
None
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 a binary Timer starts with an editing of the source text.
Then the source text is merged together with the AMOS-G1 and a AMOS-G2 text file.
The merge file is assembled by the ASSEMBLER, and the listing is printed.
Finally the binary Timer so produced may be installed.
6 N̲O̲T̲E̲S̲
This page is intentionally left blank for your notes.
