top - download
⟦d5f7a46b7⟧ Wang Wps File
Length: 14102 (0x3716)
Types: Wang Wps File
Notes: STAMON MONITOR PSP
Names: »3095A «
Derivation
└─⟦dfa2fde64⟧ Bits:30006137 8" Wang WCS floppy, CR 0266A
└─ ⟦this⟧ »3095A «
WangText
'…05…'…07…$…07…!…09…!…0b…!…0c…!…00…!…86…1
…02…
…02…
…02…
3095A…02…FIX/1266/PSP/0106
…02…MLA/840223…02……02…#
FIKS STAMON
Monitor
PSP
…02……02…FK 7809
…0e…
FIKS STAMON Monitor PSP
FIX/1266/PSP/0106
…0f…
Morten Lange
Ole Eskedal
AMC (6), APE, LOL, LU, REV, MLA
FIKS S/W Mgr 840223
FIKS Conf.Mgr 840223
1
840223
…86…1
…02…
…02… …02…
3095A …02… FIX/1266/PSP/0106
…02… MLA/840223…02……02…ii
FIKS STAMON Monitor PSP
…02……02… FK 7809
840223 All Issue 1 of Document
…02…FIX/1266/PSP/0106
…02…MLA/840223…02……02…iii
FIKS STAMON 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 ................................. 1
2 APPLICABLE DOCUMENTS .............................. 2
3 MODULE SPECIFICATION .............................. 3
3.1 Functional Capabilities ....................... 3
3.2 I/F Description ............................... 5
3.3 Processing .................................... 9
3.3.1 STAMON Calls .............................. 9
3.3.1.1 READ/WRITE/RESERVE/RELEASE STATUS ..... 9
3.3.1.1.1 Scope ............................. 9
3.3.1.1.2 Function .......................... 10
3.3.2 Flow Description .......................... 12
3.4 STAMON Data Organization ...................... 20
3.4.1 Status Table .............................. 20
3.4.2 Status Table Part Description ............. 23
3.4.2.1 INDEX ̲HD .............................. 23
3.4.2.2 REC ̲HD ................................ 23
3.4.2.3 ENT ̲PAR ............................... 24
3.5 Storage Allocation ............................ 24
3.6 Performance Characteristics ................... 25
3.7 Error Limitations ............................. 25
3.8 Error Codes/Error Locations ................... 25
3.8.1 Error Codes ............................... 25
3.8.2 Error Locations ........................... 26
3.9 Listing References ............................ 26
…02…FIX/1266/PSP/0106
…02…MLA/840223…02……02…iv
FIKS STAMON Monitor PSP
…02……02…FK 7809
4 QUALITY ASSURANCE ................................. 27
4.1 Qualifications Tests .......................... 27
5 PREPARATIONS FOR DELIVERY ......................... 28
1 S̲C̲O̲P̲E̲
1.1 I̲n̲t̲r̲o̲d̲u̲c̲t̲i̲o̲n̲
The purpose of this document is to describe the function of the Status Monitor (STAMON).
1.2 A̲b̲b̲r̲e̲v̲i̲a̲t̲i̲o̲n̲s̲
Please refer to FIKS DATA INTERFACE FIX/0100/MAN/0004.
2 A̲P̲P̲L̲I̲C̲A̲B̲L̲E̲ ̲D̲O̲C̲U̲M̲E̲N̲T̲S̲
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̲
The Status Monitor (STAMON) provides the caller with read-write access to the common status
tables within the SCC, with or without semaphore protection as specified by the caller.
A SCC status table resides in an AMOS critical region and consists of (see also Figure 3.1-1).
o Header describing the configuration and status of the status table (also referred to
as status file)
o One or more records each of individually length
o Each record consists of one or more entries each of the same length
o Each entry consists of one or more data areas of individually length. For further details,
please refer to Section 3.4.1
Any data area (or combinations of data areas) can be: reserved, released, read or written
conditioned or unconditioned of present status of the area reserve bit located within the
header (semaphore flag).
Figure 3.1-1…01…Structure of STAMON Status Table
3.2 I̲/̲F̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲
Call:
MON(STA, OPER, R4, R5, R7): ERR ̲SEM ̲OK;
where
OPER : := COND + DAT-AREA + SEM-PROC
IF-RES
COND : : =
IF-REL
SREAD FNC
DAT ̲OPER: := SWRITE FST
SRESERVE FRD
SRELEASE FRT
SWAIT
SEM ̲PROC: := SRETURN
Narrative:
The COND variable (if present) specifies that the operation (read or write) has
to be made only if the condition specified (IF ̲RES: do operation only if data area is
reserved, IF ̲REL: do operation only if data area is released.
The DAT ̲OPER variable specifies what STATUS-TABLE to access, and what operation is to
be done.
The SEM ̲PROC variable specifies the action to be taken if the COND specified condition
is not met. The SWAIT value will cause the STAMON to wait until the condition is met. The
SRETURN value will cause the STAMON to return to LINK+2 if the condition is not met.
Registers at:
Call Return
R4: Ref.STRAW unchanged
R5: Ref.FILH unchanged
R7: Link return loc/error code
Returns:
Link+1: Status access errors
Link+2: Semaphore condition not met
Link+3: OK
D̲a̲t̲a̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲
A: I̲n̲p̲u̲t̲ ̲D̲a̲t̲a̲:̲
o STAW.U.REC ̲D: specifies the records and areas to be accessed. The associated
SWELL RECORD TYPES are all defined in file SSCNAMES.D*NSC.N.
The REC ̲D values are as follows :
- ALLFNC: Access whole FNC table (FIKS ̲CONF)
- ENTFNC: Access FNC entry (TRUNK ̲CONN) defined by the ENT ̲D variable
- HEADFST: Access header of FST (FST ̲HD)
- ENFST ̲MEDE: Access MEDE status (M ̲ST) defined by the ENT ̲D variable
- ENFST ̲NODE: Access NODE status (N ̲ST) defined by the ENT ̲D variable
- ENTFST ̲TRUNK: Access TRUNK status (8xTR ̲ST) for NODE defined by the ENT ̲D variable
- ALLFDT0: Access delay table O (DEL ̲TAB)
- ALLFDT1: Access delay table 1 (DEL ̲TAB)
- ENTFDT0: Access entry within delay table 0 (DELAY ̲EN)
- ENTFDT1: Access entry within delay table 1 (DELAY ̲EN)
- ALLFRT0: Access routing table 0 (ROUT ̲TAB)
- ALLFRT1: Access routing table 1 (ROUT ̲TAB)
- ENTFRT0: Access entry within routing table 0 (ROUT ̲EN)
- ENTFRT1: Access entry within routing table 1 (ROUT ̲EN)
o STAW.U.ENT ̲D: Specifies one entry out of several entries (binary NODE/MEDE-ID)
o STRAW.U.BUFA ̲D: Word address of callers data buffer
o STRAW.U.BUFZ ̲D: Word size of callers data buffer
B: O̲u̲t̲p̲u̲t̲ ̲D̲a̲t̲a̲:̲
All STAW variables unchanged.
3.3 P̲r̲o̲c̲e̲s̲s̲i̲n̲g̲
3.3.1 S̲T̲A̲M̲O̲N̲ ̲c̲a̲l̲l̲s̲
3.3.1.1 R̲E̲A̲D̲/̲W̲R̲I̲T̲E̲/̲R̲E̲S̲E̲R̲V̲E̲/̲R̲E̲L̲E̲A̲S̲E̲ ̲S̲T̲A̲T̲U̲S̲
3.3.1.1.1 S̲c̲o̲p̲e̲
This section contains the design, data, and interface description for the monitor functions
SREAD and SWRITE status.
3.3.1.1.2 F̲u̲n̲c̲t̲i̲o̲n̲
The SREAD, SWRITE functions allow read/write access to the SCC status tables:
o FIKS Network Configuration (FNC)
o FIKS Status Table (FST)
o FIKS Routing Delay Table (FRD)
o FIKS Routing Table (FRT)
The caller specifies (A) a work area, FILH (see Figure 3.3.1.1.-1), whereto the HEADER from
the STATUS-TABLE is read (B). This header allows to find the location and size of the STATUS-TABLE
data to be accessed.
The caller specifies (using R4) a work area STAW (C),
which contains parameters for specification of the data area within the STATUS-TABLE and
the callers buffer where to/from the data is read/written.
The SRESERVE, SRELEASE functions do not involve any data transfer, but setting or clearing
of a semaphore bits in the STATUS-TABLE header. For each area (lowest level data item within
the STATUS-TABLE) there exists one semaphore bit which can be either set or cleared.
Figure 3.3.1.1-1…01… STAMON Call Data Structures
3.3.2 F̲l̲o̲w̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲
BEGIN
- Read header of STATUS-TABLE
- While records to be read do:
- While entries to be done do:
o Perform operation on data areas requested
- End while
- End while
END;
SEE THE DRAWINGS AT THE
BACK OF THE DOCUMENT.
Figure 3.3.2-1
STAMON Main Branch Flowchart
SEE THE DRAWINGS AT THE
BACK OF THE DOCUMENT.
Figure 3.3.2-2
STAMON Procedure Flowchart
SEE THE DRAWINGS AT THE
BACK OF THE DOCUMENT.
Figure 3.3.2-3
STAMON Procedure Flowchart
SEE THE DRAWINGS AT THE
BACK OF THE DOCUMENT.
Figure 3.3.2-4
STAMON Procedure Flowchart
SEE THE DRAWINGS AT THE
BACK OF THE DOCUMENT.
Figure 3.3.2-5
STAMON Procedure Flowchart
SEE THE DRAWINGS AT THE
BACK OF THE DOCUMENT.
Figure 3.3.2-6
STAMON Procedure Flowchart
SEE THE DRAWINGS AT THE BACK
OF THE DOCUMENT.
Figure 3.3.2-7
STAMON Procedure Flowchart
3.4 S̲T̲A̲M̲O̲N̲ ̲D̲a̲t̲a̲ ̲O̲r̲g̲a̲n̲i̲z̲a̲t̲i̲o̲n̲
3.4.1 S̲t̲a̲t̲u̲s̲ ̲T̲a̲b̲l̲e̲
The Status Table consists of a header and a body as seen on Figure 3.4.1-1.
The header gives information about count, size, and location of the data records located
in the bod`y.
The data items within the header are all shown on Figure 3.4.1-2.
The header is divided into three parts:
INDEX ̲HD: Specifies overall size and location of the three header parts.
REC ̲HD: Is a 8 word record repeated as many times a snumber of records residing in the
status table. The REC ̲HD record describes overall record constitution.
ENT ̲PAR: Consists of two arrays: one array specifies data area lengths and the other area
contains all the semaphore bits.
Figure 3.4.1-1
Status Table Format
Figure 3.4.1-2
Format of Status Table Header
3.4.2 S̲t̲a̲t̲u̲s̲ ̲T̲a̲b̲l̲e̲ ̲P̲a̲r̲t̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲
3.4.2.1 I̲N̲D̲E̲X̲ ̲H̲D̲
The data items within INDEX ̲HD are as follows:
REC ̲CNT defines the number of records within the status table
IX ̲ARRAY ̲OFF specifies the table off-set (words) to start of the ENT ̲PAR-array
FILE ̲OFF specifies the table off-set (words) to the first record in the table
3.4.2.2 R̲E̲C̲ ̲H̲D̲
The data items within the REC ̲HD record are as follows:
REC ̲AD specifies the table off-set to the start of the current (REC ̲HD record
No.) record within the body of the status
ENT ̲SZ specifies the No. of words in each entry in the current record
ENT ̲CNT specifies the No. of entries in current record
ENT ̲US ̲ X specifies the off-set (words) within the ENT ̲PAR area where the semaphore
bit words for current record starts
AREA ̲CNT specifies the number of areas within each data entry
AREA ̲SZ ̲IX off-set within the ENT ̲PAR array to the area length words applicable to
each entry in the current record
3.4.2.3 E̲N̲T̲ ̲P̲A̲R̲
The data items within the ENT ̲PAR record are as follows:
AREA ̲SZ(X) defines the size (in words) of data area X of each entry
ENT ̲US(X) contains one semaphore bit for each area (max. 16 areas within a data
entry) within data entry X.
3.5 S̲t̲o̲r̲a̲g̲e̲ ̲A̲l̲l̲o̲c̲a̲t̲i̲o̲n̲
N/A
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̲
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̲
3.8.1 E̲r̲r̲o̲r̲ ̲C̲o̲d̲e̲s̲
The Error codes from STAMON are constructed in the following mannner:
Upper byte in the Error Code is equal to #1F.
Lower byte is a serial no. as follows:
#01-#08; error codes from critical region access.
#09; unknown area no.
#0A; unknown entry no.
#0B; unknown record no.
#0C; user buffer too small
#0D; unknown region no.
00; semaphore error, only when return specified.
3.8.2 E̲r̲r̲o̲r̲ ̲L̲o̲c̲a̲t̲i̲o̲n̲s̲
N/A for Monitor
3.9 L̲i̲s̲t̲i̲n̲g̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲
Please refer to SCCLDD and s/w Library FIXLIB.
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̲
Refer to System test Report S050-S090.
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 SCCLDD.
