top - download
⟦9dbecea02⟧ Wang Wps File
Length: 17962 (0x462a)
Types: Wang Wps File
Notes: CPS/SDS/001 ISSUE 1
Names: »0690A «
Derivation
└─⟦2d517f7c3⟧ Bits:30006011 8" Wang WCS floppy, CR 0046A
└─ ⟦this⟧ »0690A «
WangText
…00……00……00……00……16……0a……00……00……16……0b……16…
…02…CPS/SDS/001
…02…RIM/810227…02……02…
CAMPS SYSTEM DESIGN SPECIFICATION
…02……02…CAMPS
T̲A̲B̲L̲E̲ ̲O̲F̲ ̲C̲O̲N̲T̲E̲N̲T̲S̲
5.15 SAR (STORAGE AND RETRIEVAL) ......... 661
5.15.1 Summary of Requirements ........... 663
5.15.1.1 Package Description ........... 663
5.15.1.1.1 General Concept ........... 663
5.15.1.1.2 On-Line Storage ........... 663
5.15.1.1.3 Off-Line Storage .......... 664
5.15.1.1.4 Subject to Storage ........ 664
5.15.1.1.5 Storage Retrieval Keys .... 664
5.15.1.1.6 Retrieval ................. 664
5.15.1.1.6.1 On-Line Retrieval ...... 664
5.15.1.1.6.2 Off-Line Retrieval ..... 665
5.15.1.1.7 Interface Summary ......... 665
5.15.1.1.7.1 Internal Interface ..... 665
5.15.1.1.7.2 External Interface ..... 668
5.15.1.2 Package Function ............ 668
5.15.1.2.1 On-Line Storage ......... 668
5.15.1.2.2 Off-Line Storage ........ 671
5.15.1.2.2.1 Ordinary Storage
Operation ............ 671
5.15.1.2.2.2 Approaching Off-line
Disk Threshold ....... 671
5.15.1.2.3 Retrieval ............... 673
5.15.1.2.3.1 On-Line Retrieval .... 673
5.15.1.2.3.2 Off-Line Retrieval ... 675
5.15.1.2.3.3 Retrieval
Restrictions ......... 676
5.15.1.2.4 Errors .................. 676
5.15.1.2.4.1 Error Detection ...... 676
5.15.1.2.4.2 Error Handling ....... 676
5.15.1.2.5 Recovery ................ 676
5.15.1.2.5.1 General Description .. 677
5.15.1.2.5.2 Storage On-Line
Recovery ............. 677
5.15.1.2.5.3 Storage Off-Line
Recovery ............. 677
5.15.1.2.5.4 Retrieval On-Line,
Off-Line Recovery .... 677
5.15.1.2.6 Initialization .......... 677
5.15.1.2.6.1 Package Initialization 678
5.15.1.2.6.2 Off-Line Volume
Initialization ....... 678
5.15.1.2.6.3 Setting Off-Line
Volume Threshold ..... 678
5.15.1.3 Package Control ........... 678
5.15.1.4 Characteristics ........... 679
5.15.1.4.1 Performance ............ 679
5.15.1.4.1.1 On-Line Disk Area .. 679
5.15.1.4.1.2 Off-Line Disk Area . 679
5.15.1.4.1.3 Storage Capacity ... 679
5.15.1.4.1.4 Retrieval Timing ... 679
5.15.1.5 Design and Construction ... 679
5.15.1.6 Documentation ............. 679
5.15 S̲A̲R̲ ̲(̲S̲T̲O̲R̲A̲G̲E̲ ̲A̲N̲D̲ ̲R̲E̲T̲R̲I̲E̲V̲A̲L̲)̲
5.15.1 S̲u̲m̲m̲a̲r̲y̲ ̲o̲f̲ ̲R̲e̲q̲u̲i̲r̲e̲m̲e̲n̲t̲s̲
5.15.1.1 P̲a̲c̲k̲a̲g̲e̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲
5.15.1.1.1 G̲e̲n̲e̲r̲a̲l̲ ̲C̲o̲n̲c̲e̲p̲t̲
SAR provides functional capabilities for on-line storage
of all incoming and outgoing messages in an intermediate
storage (up to a few days depending on traffic and
assigned disk space and allowed fill rate). After
that, the items are kept for a period of at least 30
days on off-line disk volumes (long term storage).
SAR supports retrieval of items from the intermediate
storage within a specified time limit.
Retrieving off-line is possible within a time limit
to be specified measured from when off-line volume
is mounted. The functions carried out by SAR are then
referenced according to their priority level:
retrieve on-line
store on-line
store off-line
retrieve off-line
5.15.1.1.2 O̲n̲-̲L̲i̲n̲e̲ ̲S̲t̲o̲r̲a̲g̲e̲
The on-line items handled by SAR are on-line resident
for at least 24 hours. On-line storage is characterized
by the fact that no mounting of physical media is required
to retrieve the item. Time span for on-line storage
is in the order of days.
5.15.1.1.3 O̲f̲f̲-̲L̲i̲n̲e̲ ̲S̲t̲o̲r̲a̲g̲e̲
An off-line storage process is carried out by dumping
items to an off-line volume, when they have been on-line
resident for at least 24 hours. Off-line storage may
require, that a media must be loaded prior to retrieval.
5.15.1.1.4 S̲u̲b̲j̲e̲c̲t̲ ̲t̲o̲ ̲S̲t̲o̲r̲a̲g̲e̲
Data for storage and retrieval are operational- and
service messages except for the categories CTS and
CTS/A. Further data messages are stored only for reruns.
The items for on-line storage are as follows:
First draft, Released messages, Incoming analysed +
possible corrected, messages, Release notifications
and Comment submitted.
5.15.1.1.5 S̲t̲o̲r̲a̲g̲e̲ ̲a̲n̲d̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲K̲e̲y̲s̲
The items for storage are catalogued under a combination
of the keys: TOC (time of occurrence), TOC window,
DTG (release), ORIG. HQ., ITEM REF ID, CHANNEL ID,
CHANNEL SERIAL NUMBER, STATION ID, STATION SERIRAL
NUMBER, FILE TIME, SICs. Retrieval of the items is
achieved by combining the search keys depending on
the category of item.
5.15.1.1.6 R̲e̲t̲r̲i̲e̲v̲a̲l̲
Retrieval of stored item using a combination of the
previous mentioned key can be achieved from both on-line
or off-line storage media.
5.15.1.1.6.1 O̲n̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲
The on-line disk contains the on-line items which can
be retrieved to a terminal position which has already
gained knowledge of the item by either having prepared
it or previously received.
5.15.1.1.6.2 O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲
The off-line items reside on a number of off-line volumes
which are mounted when an off-line retrieval process
is in progress.
5.15.1.1.7 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲S̲u̲m̲m̲a̲r̲y̲
5.15.1.1.7.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
Refer to interface chart figure 5.15.1.1.2.2.
L̲O̲G̲
Event: Storage and retrieval of log items. Commands
and retrieval keys are communicated.
T̲E̲P̲
Event: Storage and retrieval of items. Commands and
retrieval keys are communicated.
Off-line disk dump start up by supervisor to SAR.
T̲H̲P̲
Event: Storage of incoming and outgoing messages.
Store command and retrieval keys are communicated.
S̲F̲M̲
Event: Updating catalogue entries by storage of item.
Storage and retrieval commands for MMS. Retrieval
keys to SFM for catalogue updating.
S̲S̲C̲
Event: Start up and recovery action during system
generation and system failures respectively.
For a detailed description of interfaces, refer to
section 5.15.1.2 where each SAR application and respective
interface communication are described.
Fig. 5.15.1.1.2.1
INTERFACE BLOCK DIAGRAM
5.15.1.1.7.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲
None.
5.15.1.2 P̲a̲c̲k̲a̲g̲e̲ ̲F̲u̲n̲c̲t̲i̲o̲n̲
5.15.1.2.1 O̲n̲-̲L̲i̲n̲e̲ ̲S̲t̲o̲r̲a̲g̲e̲
Storage on-line means storage on intermediate storage
of items which have completed processing. The five
categories of items for storage are stored according
to the events listed below:
Incoming Messages.
Storage after succesful passing of analysis after a
possible correction by message service.
Released Messages
Storage when the positive release decision has been
given by the releasing officer.
First Draft
Storage after completion of new message preparation
format A.
Comments
Storage after completion of new comment preparation
format G1.
Release Notifications
Storage after completion of the release decision
The packages responsible for the above mentioned actions
initiate a storage process as described next.
During step 1a-c, the application modules request SAR
to initiate a storage process by queuing a request
in the incoming storage queue (ISQ). The on-line catalogue
is updated for each storage process with a new entry
(2) and upon this completion, SAR requests SFM to store
the respective item by issuing a STORE ITEM command
(3) with input parameters ICB, reference and field
list. The on-line storage process is depicted overleaf
in figure 5.15.1.2.1.
Fig. 5.15.1.2.1
STORAGE ON-LINE PROCESS
5.15.1.2.2 O̲f̲f̲-̲L̲i̲n̲e̲ ̲S̲t̲o̲r̲a̲g̲e̲
5.15.1.2.2.1 O̲r̲d̲i̲n̲a̲r̲y̲ ̲S̲t̲o̲r̲a̲g̲e̲ ̲O̲p̲e̲r̲a̲t̲i̲o̲n̲
The communication under an offline dump process is
carried out via report queues and synchronization elements
(SEL) as shown in figure 5.15.1.2.2. Incarnation of
the off-line dump process is done by SFM when an ITEM
THRESHOLD WARNING is sent to TEP (supervisor) (1).
The setting of this threshold is described under initialization
of SAR.
The supervisor under TEP decides whether the off-line
dump shall be initiated or not, depending on the present
use of the off-line disk drive. By invocation of off-line
dump, a dump request is sent to SAR (2). The online
catalogue is consulted to determine which items to
dump (3a) (3b) according to the TOC field in each item
entry. Dumping the items are carried out batchwise
through the following sequence of actions:
- Dump item command for SFM (3c)
- Dump item completion code for SAR (3d)
- Update off-line catalogue (3e)
- Update on-line catalogue (3f)
- Remove item online command for SFM (3g)
Total completion of the dump process is acknowledged
to TEP (supervisor) (3h).
5.15.1.2.2.2 A̲p̲p̲r̲o̲a̲c̲h̲i̲n̲g̲ ̲O̲f̲f̲-̲L̲i̲n̲e̲ ̲D̲i̲s̲k̲ ̲T̲h̲r̲e̲s̲h̲o̲l̲d̲
Upon approaching the filling limit of the off-line
disk, SAR request TEP (supervisor) to mount a new off-line
disk (4a). Completion of physical and logical disk
mount is reported to SAR (4b) which as well is told
if an old one is being reused. A new volume is initialized
by TEP (supervisor), while mount of used volume requires
deletion of table entry corresponding to the disk being
deleted. The dump process is reinitiated by TEP supervisor
where SAR continues the previous mentioned sequence
of actions.
Fig. 5.15.1.2.2
OFF-LINE DUMP
5.15.1.2.3 R̲e̲t̲r̲i̲e̲v̲a̲l̲
Refer figure 5.15.1.2.3.
Retrieval of the previously stored information takes
place from either on-line volume or off-line by placing
a retrieve command in the retrieve request queue (RRQ)
of SAR, which then returns one out of three things
to the requesting application.
a) An ICB referencing the retrieved item
b) Completion code telling the reason for improper
completion
c) Catalogue information for display
5.15.1.2.3.1 O̲n̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲
a) R̲e̲t̲u̲r̲n̲i̲n̲g̲ ̲a̲n̲ ̲I̲C̲B̲
After reception and detection of an on-line retrieval
command (1a), the on-line catalogue is consulted
to determine the item-id corresponding to the retrieval
key parameters (1b). A RETRIEVE ITEM command with
item-id as input parameter is delivered to SFM
(1c). SFM returns an ICB referencing the generated
temporary item (1d) which is handled further on
by SAR to requestor after security and access check
(1e).
b) R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲C̲o̲m̲p̲l̲e̲t̲i̲o̲n̲ ̲C̲o̲d̲e̲s̲
Improper completion of a retrieval procedure can
be caused by:
- Not found referenced item
- Retrieval intermediately impossible
Completion code is returned through step 1e.
c) C̲a̲t̲a̲l̲o̲g̲u̲e̲ ̲D̲i̲s̲p̲l̲a̲y̲
In case that a catalogue display is required the
on-line catalogue is consulted. The entries fulfilling
the retrieval key parameters are returned through
step 1e.
Fig. 5.15.1.2.3
RETRIEVAL OF ITEMS
5.15.1.2.3.2 O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲
According to the TOC retrieval parameter an off-line
retrieval process is initiated. This is serviced at
a lower priority level than on-line retrieval and will
result in three different actions.
a) O̲r̲d̲i̲n̲a̲r̲y̲ ̲O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲
Ordinary off-line retrieval is carried out by requesting
the supervisor to mount a specified volume (2a).
Determination of volume is done by consulting a
table containing information about time intervals
on off-line volumes. As for off-line storage a
completion code is returned (2b) telling whether
the volume is mounted or cannot intermediately
be mounted.
If mounted SFM is asked to open the off-line volumes
directory and item area by the command GET MMS
CATALOGUE (2c). SAR consults the directory for
determination of item-id of wanted item (2d).
A RETRIEVE ITEM command is handed by SAR to SFM
(2e), which returns the previously mentioned ICB
(2f). This again is passed to the calling application
via its delivery queue (2g) by SAR.
b) O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲C̲o̲m̲p̲l̲e̲t̲i̲o̲n̲ ̲C̲o̲d̲e̲s̲
If the off-line volume cannot intermediately be
mounted, the application is acknowledged by a completion
code in its delivery queue (2h).
This completion code can as well tell that referenced
item not found or off-line retrieval intermediately
impossible. The need for a reduction in time interval,
because interval covers 2 volumes, is also acknowledge
back via completion codes.
c) O̲f̲f̲-̲L̲i̲n̲e̲ ̲C̲a̲t̲a̲l̲o̲g̲u̲e̲ ̲D̲i̲s̲p̲l̲a̲y̲
As for on-line retrieval the catalogue entries
corresponding to the retrieval search keys are
returned (2g).
5.15.1.2.3.3 R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲R̲e̲s̲t̲r̲i̲c̲t̲i̲o̲n̲s̲
Missing DTG Field in Catalogue Entry:
- The action taken by SAR upon retrieving incoming
or released messages for a user position.
The entries with missing DTG field are considered
as non existent using any combination of retrieval
key parameters.
By catalogue display, the entries fulfilling TOC
or TOC window are displayed where the DTG field
is left open.
- Retrieval for Supervisor.
Same as user position except that TOC + Item Ref.
ID is a valid set of retrieval key parameters.
5.15.1.2.4 E̲r̲r̲o̲r̲s̲
5.15.1.2.4.1 E̲r̲r̲o̲r̲ ̲D̲e̲t̲e̲c̲t̲i̲o̲n̲
Syntax check of retrieval key parameter is carried
out by TEP upon execution format H (retrieval format).
Access rights check upon retrieving item are carried
out before the item is delivered to TEP. Error caused
by non-existing item during a retrieval process is
detected by SAR.
5.15.1.2.4.2 E̲r̲r̲o̲r̲ ̲H̲a̲n̲d̲l̲i̲n̲g̲
The errors detected by SAR are reported to TEP via
completion codes. All other errors are reported to
SSC which then are responsible of handling the error.
5.15.1.2.5 R̲e̲c̲o̲v̲e̲r̲y̲
5.15.1.2.5.1 G̲e̲n̲e̲r̲a̲l̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲
The partial recovery of SAR during upstart after system
failure is described next handling each process within
SAR separately.
5.15.1.2.5.2 S̲t̲o̲r̲a̲g̲e̲ ̲O̲n̲-̲L̲i̲n̲e̲ ̲R̲e̲c̲o̲v̲e̲r̲y̲
Each on-line storage command in the ISQ queue is combined
with a checkpoint so this queue is fully recovered
by SSC. Removal of queue elements takes place after
the on-line storage process has been completed.
Recovering this process by SAR is carried out by checking
the oldest queue element to see if it was already stored
completely. If not, SAR is responsible for completing
the storage.
5.15.1.2.5.3 S̲t̲o̲r̲a̲g̲e̲ ̲O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲c̲o̲v̲e̲r̲y̲
The events during an off-line dump process are sequenced
in the way, that a failure occurring anywhere is fully
recovered by SAR and SFM individually.
5.15.1.2.5.4 R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲O̲n̲-̲l̲i̲n̲e̲,̲ ̲O̲f̲f̲-̲l̲i̲n̲e̲ ̲R̲e̲c̲o̲v̲e̲r̲y̲
Failure upon retrieving from either on-line or off-line
will not cause any recovery actions except cleaning
up. The retrieval command shall therefore be retransmitted.
5.15.1.2.6 I̲n̲i̲t̲i̲a̲l̲i̲z̲a̲t̲i̲o̲n̲
5.15.1.2.6.1 P̲a̲c̲k̲a̲g̲e̲ ̲I̲n̲i̲t̲i̲a̲l̲i̲z̲a̲t̲i̲o̲n̲
SSC is responsible for delivering SAR start-up information.
Establishing of initial empty catalogues and signal
go are necessary tasks performed under this process.
During a recovery situation, a restart signal from
SSC requests SAR to initiate the previously described
recovery actions before signal go actually starts up
the package for ordinary operations.
5.15.1.2.6.2 O̲f̲f̲-̲L̲i̲n̲e̲ ̲V̲o̲l̲u̲m̲e̲ ̲I̲n̲i̲t̲i̲a̲l̲i̲z̲a̲t̲i̲o̲n̲
By mount of a new volume, upon exceeding threshold
of old one, either a completely fresh or previously
used disk can be taken into use.
For a complete new, the supervisor under TEP is responsible
of initializing i.e. formatting of volume while previously
used, requires following handling before use. Reading
of off-line catalogue prior to a deletion of corresponding
contents in a SAR table keeping track of items resident
on off-line volumes. The supervisor renames the volume
according to the number series used for the volumes.
5.15.1.2.6.3 S̲e̲t̲t̲i̲n̲g̲ ̲O̲f̲f̲-̲L̲i̲n̲e̲ ̲V̲o̲l̲u̲m̲e̲ ̲T̲h̲r̲e̲s̲h̲o̲l̲d̲
The initialization step carried out by SAR is to set
the filling rate of the off-line volume. A SET INTERMEDIATE
STORAGE THRESHOLD command with sector count as input
parameter is delivered to SFM under this process.
5.15.1.3 P̲a̲c̲k̲a̲g̲e̲ ̲C̲o̲n̲t̲r̲o̲l̲
The package control of SAR is carried out by the following
packages.
SSC controls start up during system generation, recovery
and ordered close down situations.
5.15.1.4 C̲h̲a̲r̲a̲c̲t̲e̲r̲i̲s̲t̲i̲c̲s̲
5.15.1.4.1 P̲e̲r̲f̲o̲r̲m̲a̲n̲c̲e̲
5.15.1.4.1.1 O̲n̲-̲L̲i̲n̲e̲ ̲D̲i̲s̲k̲ ̲A̲r̲e̲a̲
The on-line disk area controlled by SAR is the online
catalogue used for converting retrieval key parameters
into item-id. A table used for keeping track of all
off-line volumes in use and their corresponding time
interval under which they were used for storage, is
as well on-line and controlled by SAR.
5.15.1.4.1.2 O̲f̲f̲-̲L̲i̲n̲e̲ ̲D̲i̲s̲k̲ ̲A̲r̲e̲a̲
SAR controls the off-line catalogues on each off-line
volume in conjunction with the conversion of retrieval
key parameters into item-id's.
5.15.1.4.1.3 S̲t̲o̲r̲a̲g̲e̲ ̲C̲a̲p̲a̲c̲i̲t̲y̲
Refer SRS 3.4.1.3-5.
5.15.1.4.1.4 R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲T̲i̲m̲i̲n̲g̲
Refer SRS 3.4.1.6.4.
5.15.1.5 D̲e̲s̲i̲g̲n̲ ̲a̲n̲d̲ ̲C̲o̲n̲s̲t̲r̲u̲c̲t̲i̲o̲n̲
Refer section 2.5.
5.15.1.6 D̲o̲c̲u̲m̲e̲n̲t̲a̲t̲i̲o̲n̲
Refer section 2.6
