top - download
⟦ba6406d8c⟧ Wang Wps File
Length: 19618 (0x4ca2)
Types: Wang Wps File
Notes: CPS/SDS/001
Names: »1383A «
Derivation
└─⟦b58ce20e9⟧ Bits:30006060 8" Wang WCS floppy, CR 0092A
└─ ⟦this⟧ »1383A «
WangText
…0d……0b……0d…
…02…CPS/SDS/001
…02…RIM/811020…02……02…
CAMPS SYSTEM DESIGN SPECIFICATION
…02…ISSUE 1.1…02…CAMPS
T̲A̲B̲L̲E̲ ̲O̲F̲ ̲C̲O̲N̲T̲E̲N̲T̲S̲
5.18 STATISTICS PACKAGE ......................
684
5.18.1 General .............................
684
5.18.1.1 Purpose and Scope ...............
684
5.18.1.2 Applicable Documents and Project
References Special for Section
5.18 ............................
684
5.18.1.3 Terms and Abbreviations Special
for Section 5.18 ................
684
5.18.1.3.1 Terms .......................
684
5.18.1.3.2 Abbreviations ...............
684
5.18.2 Summary of Requirements .............
685
5.18.2.1 Package Description .............
685
5.18.2.2 Package Function ................
687
5.18.2.2.1 Main Functions (Normal
Operations) .................
687
5.18.2.2.1.1 Statistics Collection ...
687
5.18.2.2.1.2 Statistics Dump .........
688
5.18.2.2.1.3 Statistics Generation ...
690
5.18.2.2.1.4 Statistics Delivery .....
690
5.18.2.2.2 Functional Responsibilities .
692
5.18.2.2.2.1 Initialization, Close
Down and Restart .......
692
5.18.2.2.2.1.1 Initialization ......
692
5.18.2.2.2.1.2 Close Down ..........
692
5.18.2.2.2.1.3 Restart .............
692
5.18.2.2.2.2 Check Pointing and
Recovery ................
693
5.18.2.2.2.3 Error Detection and Error
Handling ................
693
5.18.2.2.2.3.1 Error Detection .....
693
5.18.2.2.2.3.2 Error Handling ......
693
5.18.2.2.2.4 Integrity of Operation ..
693
5.18.2.2.2.5 Data Collection .........
694
5.18.2.2.2.6 Security ................
694
5.18.2.3 Characteristics .................
694
5.18.2.3.1 Timing ......................
694
5.18.2.3.1.1 Response Time ...........
694
5.18.2.3.2.2 Sequential Relationship .
694
5.18.2.3.1.3 Traffic Load ............
695
5.18.2.3.1.4 Interleaving STP ........
695
5.18.2.3.1.5 Sequencing STP ..........
696
5.18.2.3.2 Throughput ..................
698
5.18.2.3.3 Flexibility .................
698
5.18.2.3.4 Accuracy of Input Data ......
698
5.18.3 Environment .........................
699
5.18.3.1 Equipment Environment ...........
699
5.18.3.2 Software Environment ............
699
5.18.3.2.1 System Software .............
699
5.18.3.2.2 Development Software ........
699
5.18.3.3 Interfaces ......................
700
5.18.3.3.1 External Interfaces .........
700
5.18.3.3.2 Package Interfaces ..........
700
5.18.3.3.2.1 Collection Statistics
Interface ...............
700
5.18.3.3.2.1.1 THP Contribution ....
700
5.18.3.3.2.1.2 CSF Contribution ....
701
5.18.3.3.2.1.3 MDP Contribution ....
701
5.18.3.3.2.1.4 TEP Contribution ....
701
5.18.3.3.2.1.5 SSC Contribution ....
701
5.18.3.3.2.2 Dump Statistics Interface
701
5.18.3.3.2.3 Generating Statistics
Interface ...............
702
5.18.3.3.2.4 Delivery Statistics
Interface ...............
702
5.18.3.4 Functions Maintained by Other
Packages ........................
702
5.18 S̲T̲A̲T̲I̲S̲T̲I̲C̲S̲ ̲P̲A̲C̲K̲A̲G̲E̲
5.18.1 G̲e̲n̲e̲r̲a̲l̲
5.18.1.1 P̲u̲r̲p̲o̲s̲e̲ ̲a̲n̲d̲ ̲S̲c̲o̲p̲e̲
N/A.
5.18.1.2 A̲p̲p̲l̲i̲c̲a̲b̲l̲e̲ ̲D̲o̲c̲u̲m̲e̲n̲t̲s̲ ̲a̲n̲d̲ ̲P̲r̲o̲j̲e̲c̲t̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲s̲,̲ ̲S̲p̲e̲c̲i̲a̲l̲
̲f̲o̲r̲ ̲S̲e̲c̲t̲i̲o̲n̲ ̲5̲.̲1̲8̲
N/A.
5.18.1.3 T̲e̲r̲m̲s̲ ̲a̲n̲d̲ ̲A̲b̲b̲r̲e̲v̲i̲a̲t̲i̲o̲n̲s̲,̲ ̲S̲p̲e̲c̲i̲a̲l̲ ̲f̲o̲r̲ ̲S̲e̲c̲t̲i̲o̲n̲ ̲5̲.̲1̲8̲
5.18.1.3.1 T̲e̲r̲m̲s̲
Queue-id: Queue identification
Diag-id: Diagram identification
Remainder: The rest as a result of a division
Modulo N: Quotient as a result of a division by N
Statistics Parameter String, containing information
record: for STP during statistics collection.
5.18.1.3.2 A̲b̲b̲r̲e̲v̲i̲a̲t̲i̲o̲n̲s̲
HSG: Hourly Statistics Generator
DSG: Daily Statistics Generator
WSG: Weekly Statistics Generator
DESCR: Description
INFO: Information
5.18.2 S̲u̲m̲m̲a̲r̲y̲ ̲o̲f̲ ̲R̲e̲q̲u̲i̲r̲e̲m̲e̲n̲t̲s̲
This chapter and its sections specify the requirements
pertinent to the package level.
5.18.2.1 P̲a̲c̲k̲a̲g̲e̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲
The statistics package generates statistics based on
information collected by the statistics package collection
monitor procedure.
It interfaces with the Terminal Package for retrieval
of statistics.
Fig. 5.18.2.1-1 gives an overview.
The application requests CAMPS System Functions to
collect statistics (1).
The statistics package dumps statistics onto disk (2).
The statistics package generates statistics (3).
The terminal package requests statistics (4).
The letters a, b ... indicate the sequence in which
the above mentioned functions are performed.
FIGURE 5.18.2.1-1…01…STATISTICS
5.18.2.2 P̲a̲c̲k̲a̲g̲e̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲s̲
The next two sub-sections 5.18.2.2.1 and 5.18.2.2.2
contain a functional description under normal operation
and special circumstances respectively.
5.18.2.2.1 M̲a̲i̲n̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲s̲ ̲(̲N̲o̲r̲m̲a̲l̲ ̲O̲p̲e̲r̲a̲t̲i̲o̲n̲)̲
The Statistics Package supports the 4 functions outlined
in the package description
- Statistics collection
- Statistics dump
- Statistics generation
- Statistics request response
5.18.2.2.1.1 S̲t̲a̲t̲i̲s̲t̲i̲c̲s̲ ̲C̲o̲l̲l̲e̲c̲t̲i̲o̲n̲
The statistics collection is performed by STP collection
monitor procedure into the shared data area. They are:
- Count increment
- Add a number to a value
- Boundary (minimum + maximum)
- Cumulative time periods (i.e. how many percent
on, of a switch)
The collection of statistics is table driven.
The table is defined by the Statistics Package in such
a way that the processing by STP is defined by the
table in conjunction with the parameters specified
by the calling application.
The request of a statistics is by supplying:
- Statistics group number
- Statistics sub-group number
- Statistics record number
- Statistics parameter
The group and number are verified against the requestor.
The events in the processing are (refer to fig. 5.18.2.1-1
for event numbers).
Application calls Statistics Package (STP) with a request
to generate statistics (1a). The STP collector checks
the request parameters by access to the Table in the
shared data and updates the shared area at addresses
specified in the Table (1b). During update and access
of the shared data area exclusive acceses is granted
by requesting CSF. The STP collector returns to the
application (1c).
When the different applications request statistics
collection specific parameters are supplied as described
in appendix A.
5.18.2.2.1.2 S̲t̲a̲t̲i̲s̲t̲i̲c̲s̲ ̲D̲u̲m̲p̲
The statistics package is activated every 6 minutes
to perform dump of the collected data. The timing is
controlled by a request to the CAMPS System Function
timer. The dump processing is (Refer fig. 5.18.2.1-1
for event numbers).
Invocation of the Statistics Package by CAMPS System
Functions (2a). Request to CAMPS System Function for
exclusive access to the shared data area (2b). Dump
the data area (2e). Give up the exclusive access (2f).
If a system switch-over or restart has taken place
the shared data area will be marked as invalid and
the dump will generate a dummy dump.
The dummy dump is a version of the shared data area
which does not contribute any information during generation
of the statistics.
The dump area is shown in figure 5.18.2.2.1.2-1.
FIGURE 5.18.2.2.1.2-1…01…STATISTICS DUMP AREA
5.18.2.2.1.3 S̲t̲a̲t̲i̲s̲t̲i̲c̲s̲ ̲G̲e̲n̲e̲r̲a̲t̲i̲o̲n̲
The statistics package is once per hour generating
statistics for the last hour. The processing is (refer
to figure 5.18.2.1-1 for event numbers):
Invocation of generation part of statistics package
(3a). Request storage occupancy from SFM (3b). Calculate
from the statistics, dump statistics for the last hour
and output to statistics files (3c and 3f).
Statistics are kept on an hourly basis for 24 hours,
on a daily basis for 1 day and on a weekly basis for
1 week.
The statistics files are shown in figure 4.1.4.2.1-4.
The size is in the order of 700 kbytes.
5.18.2.2.1.4 S̲t̲a̲t̲i̲s̲t̲i̲c̲s̲ ̲R̲e̲q̲u̲e̲s̲t̲ ̲R̲e̲s̲p̲o̲n̲s̲e̲
Statistics print is output by the terminal package.
STP delivers the statistics information to TEP. The
processing is (for event numbers, refer to fig. 5.18.2.1-1).
Invocation of delivering statistics (4a).
Read the appropriate statistics information (4b) and
copy it to temporary storage (4c). Return reference
to return queue (4d). For the case no temporary storage
could be allocated or when the statistics is not available
for the period a return code is generated and returned
(4d).
FIGURE 5.18.2.2.1.3-1…01…STATISTICAL FILES
5.18.2.2.2 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲R̲e̲s̲p̲o̲n̲s̲i̲b̲i̲l̲i̲t̲i̲e̲s̲
Functions, for which the statistics package are responsible,
are specified in the next paragraphs.
5.18.2.2.2.1 I̲n̲i̲t̲i̲a̲l̲i̲z̲a̲t̲i̲o̲n̲,̲ ̲C̲l̲o̲s̲e̲ ̲D̲o̲w̲n̲,̲ ̲a̲n̲d̲ ̲R̲e̲s̲t̲a̲r̲t̲
5.18.2.2.2.1.1 I̲n̲i̲t̲i̲a̲l̲i̲z̲a̲t̲i̲o̲n̲
Initialization of STP, i.e. preparation of main memory
collection area and the disk resident collection area
and the disk resident statistics file, is signalled
by SSC in STP system queue. This causes STP to start
an initialization program. Initialization data address
is a part of the queue element sent by SSC. STP initialization
program transfers data from an SSC specified data address
to the previous mentioned table and shared data areas,
refer figure 5.18.2.1-1. Completion of initialization
is acknowledged back in SSC response queue.
5.18.2.2.2.1.2 C̲l̲o̲s̲e̲ ̲D̲o̲w̲n̲
Close down of STP is initiated by SSC when a close
down command is received. No more collection will be
performed so the shared data area will be dumped as
normally, to the section corresponding to the 6 minutes
interval to be used.
5.18.2.2.2.1.3 R̲e̲s̲t̲a̲r̲t̲
Restart of STP is signalled by SSC by delivering a
QEL in the STP's system queue. Contents of queue element
specify the kind of restart, parameters to use during
restart and acknowledge queue where STP shall return
answer when restart has finished. Restart operations
are depicted in the SDS figure 5.10.1.2.1.3-1 where
start-up type is shown versus restart parameter file.
5.18.2.2.2.2 C̲h̲e̲c̲k̲p̲o̲i̲n̲t̲i̲n̲g̲ ̲a̲n̲d̲ ̲R̲e̲c̲o̲v̲e̲r̲y̲
Checkpointing is not applicable to STP.
Recovery of STP is requested by SSC which places a
queue element in STP system queue. Contents of QEL
specify the kind of recovery, which shall be carried
out by STP. Different recovery actions are explained
in the SDS figure 5.10.1.2.1.3-1.
5.18.2.2.2.3 E̲r̲r̲o̲r̲ ̲D̲e̲t̲e̲c̲t̲i̲o̲n̲ ̲a̲n̲d̲ ̲E̲r̲r̲o̲r̲ ̲H̲a̲n̲d̲l̲i̲n̲g̲
5.18.2.2.2.3.1 E̲r̲r̲o̲r̲ ̲D̲e̲t̲e̲c̲t̲i̲o̲n̲
All errors detected by STP are reported to CSF's error
reporting function. Detection of errors in input parameters
in collection statistics are reported to requestor.
Errors directly detected by STP are boundary exceedings
in parameters delivered to STP under collecton of statistics
information.
5.18.2.2.2.3.2 E̲r̲r̲o̲r̲ ̲H̲a̲n̲d̲l̲i̲n̲g̲
The action to be taken upon detection of an error is
reported by SSC to STP system queue.
5.18.2.2.2.4 I̲n̲t̲e̲g̲r̲i̲t̲y̲ ̲o̲f̲ ̲O̲p̲e̲r̲a̲t̲i̲o̲n̲
To avoid STP collector to access other areas than the
shared data area (SDA) validation is performed on input
data. Both the header information and the corresponding
parameters in the delivered data record are checked.
All parameters are checked for upper and lower boundaries.
5.18.2.2.2.5 D̲a̲t̲a̲ ̲C̲o̲l̲l̲e̲c̲t̲i̲o̲n̲
Not applicable to STP
5.18.2.2.2.6 S̲e̲c̲u̲r̲i̲t̲y̲
Not performed by STP
5.18.2.3 C̲H̲A̲R̲A̲C̲T̲E̲R̲I̲S̲T̲I̲C̲S̲
5.18.2.3.1 T̲i̲m̲i̲n̲g̲
5.18.2.3.1.1 R̲e̲s̲p̲o̲n̲s̲e̲ ̲T̲i̲m̲e̲
Response time for applications, requesting statistics
collection until completion code is returned, is less
than 1 m sec, for normal operation.
Worst case response time may be up to 100 msec occurring
every 6 minutes when the shared data area is dumped.
5.18.2.3.1.2 S̲e̲q̲u̲e̲n̲t̲i̲a̲l̲ ̲R̲e̲l̲a̲t̲i̲o̲n̲s̲h̲i̲p̲
Function of STP is purely sequential. Statistics information
is being collected and used as basis for production
of hourly statistics. This again is used as basis for
current day statistics, which serve as input for accumulating
day statistics, which form week statistics after a
period of 7 days. Each of the produced statistics is,
as the last step in the sequential relationship, delivered
to the terminal package for print-out.
5.18.2.3.1.3 T̲r̲a̲f̲f̲i̲c̲ ̲L̲o̲a̲d̲
STP traffic load for the 4 sub-packages involved is:
- Collection sub-package:
- main memory data size: 8 kbytes
- CPU time, one collect: 1 m sec
- I/Os per collect: 0
- Dump sub-package:
- main memory data size: 0 bytes
- disk data size: 80 kbytes
- CPU time: 1 m sec
- I/Os: 2
- Generate sub-package:
- main memory data size: 0 bytes
- disk data size: 600 kbytes
- CPU time, max: 10 sec
- I/Os, max: 150
- Delivery sub-package:
- main memory data size: 0 bytes
- disk data size: 0 bytes
- CPU time: 1 sec
- I/Os: 50
5.18.2.3.1.4 I̲n̲t̲e̲r̲l̲e̲a̲v̲i̲n̲g̲ ̲S̲T̲P̲
Any kind of disturbance signalled by SSC in STP system
queue causes the current used collecting interval area
to be declared as invalid. The produced statistics
are then calculated on basis of the reduced amount
of input information. The least disturbance of the
STP input stream is for information covering a six
minutes interval.
When collection interval has been declared invalid
this is reported to SSC.
5.18.2.3.1.5 S̲e̲q̲u̲e̲n̲c̲i̲n̲g̲ ̲S̲T̲P̲
The way STP is sequenced is shown overleaf. Time-out
QELs are treated one by one in one of the cases detailed
below.
FIGURE 5.18.2.3.1.6-1
5.18.2.3.2 T̲h̲r̲o̲u̲g̲h̲p̲u̲t̲
The throughput of statistics data records collected
by STP is 4-5 data records per busy second traffic
load.
5.18.2.3.3 F̲l̲e̲x̲i̲b̲i̲l̲i̲t̲y̲
As STP is fully table driven, introduction of a new
kind of statistics, or removal of old ones are easily
implemented. This is achieved by changing the contents
of the main memory resident table area in the shared
data area, and the information area in the disk resident
statistics file. Introduction of new statistics resultd
in deletion of previously stored information.
5.18.2.3.4 A̲c̲c̲u̲r̲a̲c̲y̲ ̲o̲f̲ ̲I̲n̲p̲u̲t̲ ̲D̲a̲t̲a̲
Input data delivered under a collection of statistics
data records are validated. The validation performed
check each input data to see if boundaries are fulfilled.
Any exceeding of the limits is reports to SSC, which
acknowledge back in STP system queue the action to
be taken.
5.18.3 E̲n̲v̲i̲r̲o̲n̲m̲e̲n̲t̲s̲
5.18.3.1 E̲q̲u̲i̲p̲m̲e̲n̲t̲ ̲E̲n̲v̲i̲r̲o̲n̲m̲e̲n̲t̲
The STP software package is fully on-line resident
in CAMPS processing units.
Main memory program area size is 3k words. Main memory
data area consists of a table and a data area. Table
area size is 2k words. Data area size is 7.5k words.
Disk area consists of one file containing information
area and data area. Information area size is 400 words.
Data area size is 200k words. The disk file is an on-line
disk resident placed on the 2 mirrored disks.
5.18.3.2 S̲o̲f̲t̲w̲a̲r̲e̲ ̲E̲n̲v̲i̲r̲o̲n̲m̲e̲n̲t̲s̲
5.18.3.2.1 S̲y̲s̲t̲e̲m̲ ̲S̲o̲f̲t̲w̲a̲r̲e̲
STP's system software environments consist of the following
components:
- DAMOS
- CSF
- MMS
5.18.3.2.2 D̲e̲v̲e̲l̲o̲p̲m̲e̲n̲t̲ ̲S̲o̲f̲t̲w̲a̲r̲e̲
Development software is standard DAMOS and TOS (terminal
operating system) resident in a single CR80D configuration.
The SDA table and STP file information areas are generated
at system generation time.
5.18.3.3 I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲
5.18.3.3.1 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲
Not applicable.
5.18.3.3.2 P̲a̲c̲k̲a̲g̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲
Interfaces to other application packages are identified
below including a description of events. Paragraph
4 contains a detailed specification of all interfaces.
5.18.3.3.2.1 C̲o̲l̲l̲e̲c̲t̲i̲o̲n̲ ̲S̲t̲a̲t̲i̲s̲t̲i̲c̲s̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
Packages contributing with statistics information are:
- Traffic Handling, THP
- CAMPS System Function, CSF
- Message Distribution, MDP
- Terminal Package, TEP
- System Status and Control, SSC
Information delivered by the packages is listed below
according to contributor.
5.18.3.3.2.1.1 T̲H̲P̲ ̲C̲o̲n̲t̲r̲i̲b̲u̲t̲i̲o̲n̲
THP delivers a statistics record related to each of
the following events:
- incoming messages per channel
- outgoing messages per channel
- channel availability and occupancy
5.18.3.3.2.1.2 C̲S̲F̲ ̲C̲o̲n̲t̲r̲i̲b̲u̲t̲i̲o̲n̲
CSF delivers a statistics record related to the following
event:
- storage occupancy
5.18.3.3.2.1.3 M̲D̲P̲ ̲C̲o̲n̲t̲r̲i̲b̲u̲t̲i̲o̲n̲
MDP delivers a statistics record related to each of
the following events:
- incoming messages per distribution terminal
- outgoing messages per distribution terminal
5.18.3.3.2.1.4 T̲E̲P̲ ̲C̲o̲n̲t̲r̲i̲b̲u̲t̲i̲o̲n̲
TEP delivers a statistics record related to each of
the following events:
- use of message formats, type 1
- use of message formats, type 2
5.18.3.3.2.1.5 S̲S̲C̲ ̲C̲o̲n̲t̲r̲i̲b̲u̲t̲i̲o̲n̲
SSC delivers a statistics record related to each of
the following events:
- use of message formats, type 2 security interrogation
I1 and security warning I2.
5.18.3.3.2.2 D̲u̲m̲p̲ ̲S̲t̲a̲t̲i̲s̲t̲i̲c̲s̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
STP receives a time-out dump queue element from CSF
each time a dump process shall be incarnated.
5.18.3.3.2.3 G̲e̲n̲e̲r̲a̲t̲i̲n̲g̲ ̲S̲t̲a̲t̲i̲s̲t̲i̲c̲s̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
STP receives a time-out generating queue element from
CSF each time an hourly statistics shall be generated.
5.18.3.3.2.4 D̲e̲l̲i̲v̲e̲r̲y̲ ̲S̲t̲a̲t̲i̲s̲t̲i̲c̲s̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
STP receives a delivery time-out queue element from
CSF each time a delivery of statistics information
procedures is initiated.
The delivery procedure creates a temporary CIF for
each of the statistics:
- 24 one hour statistics
- 1 day statistics
- 1 week statistics
On completion of the CIF, a queue element is sent to
the queue, to which statistics shall be sent. The QEL
references the CIF by containing a view ref.
5.18.3.4 F̲u̲n̲c̲t̲i̲o̲n̲s̲ ̲M̲a̲i̲n̲t̲a̲i̲n̲e̲d̲ ̲b̲y̲ ̲O̲t̲h̲e̲r̲ ̲P̲a̲c̲k̲a̲g̲e̲s̲
Functions maintained by other packages are as follows:
- recovery functions
- error handling
- SDA synchronization
