top - download
⟦66cf77405⟧ Wang Wps File
Length: 36108 (0x8d0c)
Types: Wang Wps File
Notes: CPS/SDS/007
Names: »1119A «
Derivation
└─⟦b3a67856d⟧ Bits:30006040 8" Wang WCS floppy, CR 0065A
└─ ⟦this⟧ »1119A «
WangText
…00……00……00……00……00…J…0a……00……00…J…0b…J…0e…J…0f…J…07…I…0d…I…02…I…06…I…07…H…0b…H…01…H…06…G…0b…G…00…G…01…F…08…F…0e…F…0f…F…05…F…86…1 …02… …02… …02…
…02…CPS/SDS/007
…02…RIM/810801…02……02…
STORAGE AND RETRIEVAL
…02……02…CAMPS
4.2.3 O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲s̲
Included in this section is the specification of the
off-line retrieval sub-package.
4.2.3.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲
The functions performed by the sub-package are listed
below. A number of functions are identical to those
mentioned in the on-line retrieval sub-package.
- Activate off-line retrieval
- Off-line volume determination
- Test of mounted volume
- Volume mount
- Off-Line catalogue consult
- Access check
- Retrieval of CIF
- Delivery of retrieval result
Overleaf on figure 4.2.3.1-1 an overview diagram depicting
the off-line retrieval functions is shown.
Figure 4.2.3.1-1
4.2.3.1.1 A̲c̲t̲i̲v̲a̲t̲e̲ ̲O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲
Activation of off-line retrieval is controlled by the
counter, off-line ̲count. If any off-line retrievals
have been detected by the on-line retrieval subpackage,
off-line ̲count is incremented. Off-line retrieval test
off-line ̲count. If counter is positive it is decremented
and off-line retrieval started. If counter is 0, the
off-line retrieval sub-package will be waiting until
it is incremented as described above. A second condition
shall be fulfilled before activation. The status off-line
̲retrieval ̲susp shall be in on condition.
Each time a new off-line retrieval is started the waiting
off-line requests in RRQ are scanned. If any requests
require use of the present mounted volume, these are
serviced first. In case none are for the present mounted
off-line volume, the oldest off-line retrieval request
is serviced.
4.2.3.1.2 O̲f̲f̲-̲L̲i̲n̲e̲ ̲V̲o̲l̲u̲m̲e̲ ̲D̲e̲t̲e̲r̲m̲i̲n̲a̲t̲i̲o̲n̲
Each off-line retrieval has attached a TOC or DTG as
one of the retrieval keys. This is used for the determination
of off-line volume containing the message or transaction.
Using TOC or DTG as input parameter volume table is
consulted. Corresponding time interval is found and
related volume-id. The volume-id is then used during
a later test of mounted volume and a possible mount
request.
4.2.3.1.3 T̲e̲s̲t̲ ̲o̲f̲ ̲M̲o̲u̲n̲t̲e̲d̲ ̲V̲o̲l̲u̲m̲e̲
Test of presently mounted volume is carried out by
requesting SFM of volume-id corresponding to the off-line
disk. This volume-id is compared with the volume-id
achieved during the previous off-line volume determination.
A correctly mounted volume results in continuation
with off-line catalogue consult. Wrong volume mounted
requires a volume mount prior to continuation of off-line
retrieval.
4.2.3.1.4 V̲o̲l̲u̲m̲e̲ ̲M̲o̲u̲n̲t̲
The volume mount function is initiated by sending a
mount request report to the supervisor's report printer
queue. Contents of report are volume-id of requested
volume and terminal designator corresponding to the
terminal requesting the off-line retrieval.
A CSF time-out is started. Time-out period is 10 minutes.
If time-out appears before mount acknowledge, mount
request is repeated.
Mount acknowledge can be either mount refused or mount
completed.
Mount refused results in returning a completion code
to requestor return queue acknowledging that off-line
retrieval is intermediately impossible. Mount completed
results in test of mounted volume as described in 4.2.3.1.3.
4.2.3.1.5 O̲f̲f̲-̲L̲i̲n̲e̲ ̲C̲a̲t̲a̲l̲o̲g̲u̲e̲ ̲C̲o̲n̲s̲u̲l̲t̲
This function is implemented in the same way as the
on-line retrieval sub-package performs the on-line
catalogue consult. The only difference occurring is
that the cataloque in question is the off-line catalogue.
For functional description refer to 4.2.2.1.3.
4.2.3.1.6 A̲c̲c̲e̲s̲s̲ ̲C̲h̲e̲c̲k̲
Function performed equal to the access check under
on-line retrieval. Refer to 4.2.2.1.4.
4.2.3.1.7 R̲e̲t̲r̲i̲e̲v̲e̲ ̲C̲I̲F̲
Function performed equal to the CIF retrieval under
on-line retrieval. Refer to 4.2.2.1.5.
4.2.3.1.8 D̲e̲l̲i̲v̲e̲r̲y̲ ̲o̲f̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲R̲e̲s̲u̲l̲t̲
A number of off-line retrieval events produces a result
to be returned to requestor. The events are:
- volume mount refusal
- access check failure
- CIF not found
- CIF found
4.2.3.1.8.1 V̲o̲l̲u̲m̲e̲ ̲M̲o̲u̲n̲t̲ ̲R̲e̲f̲u̲s̲a̲l̲
Completion code 3 is returned to requestor. All retrieval
keys are returned too. Parameters returned via a QEL.
QEL references a buffer element containing all parameters.
Completion code 3 indicates that "off-line retrieval
is intermediately impossible".
4.2.3.1.8.2 A̲c̲c̲e̲s̲s̲ ̲C̲h̲e̲c̲k̲ ̲F̲a̲i̲l̲u̲r̲e̲
Completion code 4 is returned to requestor. All retrieval
keys are returned too. Completion code is sent as specified
above in 4.2.3.1.8.1.
Completion code indicates that "no message found" caused
by no match between retrieval keys and catalogue entries.
If retrieval was of type DTG the following completion
code is returned. No message found, try catalogue display
or another set of retrieval keys.
4.2.3.1.8.3 C̲I̲F̲ ̲N̲o̲t̲ ̲F̲o̲u̲n̲d̲
Result of a MMS retrieve CIF function call.
Completion code 4 is returned to requestor. All retrieval
keys too.
Completion code is sent as specified above in 4.2.3.1.8.1.
4.2.3.1.8.4 C̲I̲F̲ ̲F̲o̲u̲n̲d̲
This case exists upon a successful MMS retrieval or
return of catalogue entries for display.
In both cases a QEL is sent to requestor's return queue.
QEL references the message, transaction, or catalogue
CIF by containing a view ref.
4.2.3.2 S̲o̲f̲t̲w̲a̲r̲e̲ ̲S̲t̲r̲u̲c̲t̲u̲r̲e̲
Figure 4.2.3.2-1 overleaf shows the software structure.
It consists of two main parts, a mount required and
a mount not required. The numbers in the small boxes
refer to the below boxes with text. Figure 4.2.3.3.2-1,
control logic, contains the equivalent numbers.
Number 6, 7, and 8 correspond to the completion steps,
signal semaphore off-line ̲disk ̲lock, signal semaphore
off-line ̲retrieval ̲susp. and remove QEL in RRQ.
Figure 4.2.3.2-1
4.2.3.3 D̲a̲t̲a̲ ̲F̲l̲o̲w̲ ̲a̲n̲d̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
This sub-section describes the data flow and control
logic during off-line retrieval. First the elements
participating in the control are presented. Second
the relationship between them are described.
4.2.3.3.1 C̲o̲n̲t̲r̲o̲l̲ ̲E̲l̲e̲m̲e̲n̲t̲s̲
The following control elements are included in the
sub-package control:
- off-line ̲retrieval ̲susp. controls the suspension
of off-line retrievals
- off-line ̲count indicates the off-line retrieval
requests pending in RRQ.
- off-line ̲disk ̲lock controls the single use of off-line
volume within SAR
- MAQ QELs control the mount procedures acknowledgements
- lock ̲table controls the single access to the volume
table
4.2.3.3.2 C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
Figure 4.2.3.3.2-1 overleaf depicts the control logic
during off-line retrievals.
Off-line retrieval loop:
Wait semaphore off-line ̲retrieval ̲susp
Decrement off-line ̲count
Receive ̲off-line retrieval request from RRQ
Wait semaphore lock ̲table
Determine volume containing CIF
Signal semaphore lock ̲table
Right volume mounted? …0e…Yes…0f… Wait
semaphore
No off-line
̲disk ̲lock
Right volume mount loop:
1
QEL = time-out loop:
2
Mount request to report printer
3
Start 10 min. time-out
4
Receive form MAQ EXIT, QEL =
time-out
5
End QEL = time-out loop
6
Right volume mounted? EXIT, right
volume mounted
7
or mount refused
8
End volume mount loop
QEL = mount refused? …0e…Yes…0f… return
code 3
No
Wait semaphore off-line ̲disk ̲lock signal
semaphore
off-line
̲retrieval ̲
susp.
1 Consult catalogue remove
QEL in RRQ
2 Access check failed? …0e…Yes…0f… return code 4
No
3 Retrieve CIF signal semaphore
off-line ̲retrieval
̲
lock
Signal semaphore
off-line ̲retrieval
̲
susp
remove QEL in RRQ
4 CIF found? …0e…No…0f… return code 4
Yes
5 Delivery of CIF signal semaphore
off-line ̲disk ̲lock
6 Signal semaphore
off-line ̲disk ̲lock signal semaphore
off-line ̲retrieval ̲
susp.
7 Signal semaphore
off-line ̲retrieval ̲
susp. remove QEL in RRQ
8 Remove QEL in RRQ
End of-line retrieval loop
FIGURE 4.2.3.3.2-1
OFF-LINE RETRIEVAL CONTROL LOGIC
4.2.3.4 S̲u̲b̲-̲P̲a̲c̲k̲a̲g̲e̲ ̲D̲a̲t̲a̲
Off-line retrieval data have previously been described
in 4.1.4, common internal data elements.
4.2.3.5 S̲u̲b̲-̲P̲a̲c̲k̲a̲g̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲
Interfaces to other sub-packages are via the elements
listed below:
- off-line ̲count
- off-line ̲disk ̲lock
- lock ̲table
- off-line ̲retrieval ̲susp.
4.2.3.5.1 O̲f̲f̲-̲L̲i̲n̲e̲-̲C̲o̲u̲n̲t̲
Interface to on-line retrieval in form of this counter.
On-line retrieval increments off-line ̲count each time
an off-line retrieval has been detected. Off-line ̲retrieval
decrements counter each time an off-line retrieval
has completed.
4.2.3.5.2 O̲f̲f̲-̲L̲i̲n̲e̲-̲D̲i̲s̲k̲-̲L̲o̲c̲k̲
Interface to dump sub-package. Semaphore is used to
achieve a single used of off-line disk. Off-line retrieval
waits semaphore off-line ̲disk ̲lock while it consults
off-line catalogue and until MMS has completed the
CIF retrieval.
4.2.3.5.3 L̲o̲c̲k̲-̲T̲a̲b̲l̲e̲
Interface to both dump and supervisor command sub-packages.
Semaphore control the single access to the volume table
while off-line retrieval to the determination of off-line
volume required in the off-line retrieval. Semaphore
is "waited" before access and "signalled" after access.
4.2.3.5.4 O̲f̲f̲-̲L̲i̲n̲e̲-̲R̲e̲t̲r̲i̲e̲v̲a̲l̲-̲S̲u̲s̲p̲.̲
Interface to supervisor command subpackage. Supervisor
command waits the semaphore in the case where off-line
retrievals shall be suspended. Semaphore is signalled
upon the completion of the suspend period. Off-line
retrieval "wait" the semaphore upon initiating an off-line
retrieval and "signal" it after the completion.
4.2.3.6 S̲u̲b̲-̲P̲a̲c̲k̲a̲g̲e̲ ̲I̲n̲i̲t̲i̲a̲l̲i̲z̲a̲t̲i̲o̲n̲
Initialization of off-line retrieval is performed by
cleaning up after an ongoing retrieval. The sub-package
will be ready to implement new off-line retrieval upon
restart signal.
4.2.4 D̲u̲m̲p̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲s̲
This section includes the specification for the dump
sub-package. Dump performs the transfer of the on-line
disk resident messages and transactions to the off-line
disk.
4.2.4.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲s̲
To perform the dump procedure the following functions
are assigned to this sub-package:
- receive dump request from TEP
- check mounted volume
- volume mount procedure
- dump procedure
Figure 4.2.4.1-1 presents these functions. Figure 2.2.1.2-1
presents the sequencing of the dump procedure.
Figure 4.2.4.1-1
4.2.4.1.1 R̲e̲c̲e̲i̲v̲e̲ ̲D̲u̲m̲p̲ ̲R̲e̲q̲u̲e̲s̲t̲s̲
Dump is initiated by either MMS or TEP. The MMS initiation
is carried out as a return of a Get Threshold Warning
command to MMS. TEP initiates the dump by sending a
QEL to DCQ. Contents of QEL specify kind of dump, namely:
- Perform dump on usual volume until time specified
- Perform dump on new volume "volume-id" until time
specified
By usual is meant volume used during previous dump.
If second kind is specified a new entry is supplied
to the volume table corresponding to the new volume
name.
4.2.4.1.2 C̲h̲e̲c̲k̲ ̲M̲o̲u̲n̲t̲e̲d̲ ̲V̲o̲l̲u̲m̲e̲
Before the actual transfer of messages and transactions
and catalogue information the present mounted volume
is checked. For MMS and TEP type 1 dump (usual volume)
the last used volume name is checked against present
mounted volume name. For TEP type 2 (new volume) the
input parameter volume name is validated against present
mounted volume name. Result of validation is either
right volume mounted or wrong volume mounted. For case
1 dump is continued normally, case 2 results in a mount
request sent to report printer queue.
4.2.4.1.3 V̲o̲l̲u̲m̲e̲ ̲M̲o̲u̲n̲t̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
A volume mount request report is sent to the supervisor's
report printer queue. Contents of report are volume-id
of requested volume and text explaining that the mount
request is related to an off-line dump. A CSF time-out
is started. Time-out period is 10 minutes. If time-out
appears before mount acknowledge, mount request is
repeated.
Mount acknowledge can be either mount refused or mount
completed.
Mount refused results in returning a completion code
to report printer telling that dump is completed until
time, DTG. The DTG will be the same as for the last
dump completion report.
Mount completed results in test of mounted volume as
described in 4.2.4.1.2.
4.2.4.1.4 D̲u̲m̲p̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
The dump procedure consists of a loop in which batch
of CIFs are dumped. Each batch is equal to the number
of PRI entries corresponding to one TOC ̲FILE entry,
i.e. message and transaction related to one 10 minutes
interval.
Exit of dump takes place in one of 2 ways. Total dump
process is completed until time specified in request.
Second the dump process is prematurely terminated caused
by exceeding the volume threshold. In both cases the
TOC equal to the time of copy until, is filled into
the dump completion report for the report printer.
Volume table is updated according to the new TOC and
DTG intervals contained in the volume.
4.2.4.2 S̲o̲f̲t̲w̲a̲r̲e̲ ̲S̲t̲r̲u̲c̲t̲u̲r̲e̲
Figure 4.2.4.2-1 presents the dump software structure.
The software structure of the dump function consists
of 3 coroutines. MMS INIT coroutine handles the activation
by MMS. MMS INIT starts the dump coroutine and waits
the semaphore init ̲dump.
TEP INIT coroutine handles the activation by TEP. TEP
INIT starts the dump coroutine and waits the semaphore
init dump.
Figure 4.2.4.2-1
4.2.4.3 D̲a̲t̲a̲ ̲F̲l̲o̲w̲ ̲a̲n̲d̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
Data flow and Control Logic are distributed into 3
parts. 2 main control parts which handle the activation
of the dump function and the actual dump function.
4.2.4.3.1 M̲M̲S̲ ̲M̲a̲i̲n̲ ̲C̲o̲n̲r̲o̲l̲
Activation by MMS is carried out when MMS INIT receives
a CC as an acknowledgement of a previos Get IS threshold
function call to MMS. MMS INIT waits the semaphore
init ̲dump to ensure that only one dump is started.
Upon completion of the dump function the semaphore
is signalled so a new start of the dump function can
be invoked by either MMS INIT or TEP INIT.
Refer HIPO 4.2.4.3.1-1 for MMS Control.
4.2.4.3.2 T̲E̲P̲ ̲M̲a̲i̲n̲ ̲C̲o̲n̲t̲r̲o̲l̲
Activation by TEP is controlled by the arrival of QELs
in DCQ. Upon this arival the semaphore init ̲dump is
waited as described in 4.2.4.3.1. After the dump function
the semaphore is signalled so a new start of the dump
function can be initiated by either MMS INIT or TEP
INIT.
Refer HIPO 4.2.4.3.2-1 for TEP control.
4.2.4.3.3 D̲u̲m̲p̲ ̲C̲o̲n̲t̲r̲o̲l̲
The dump coroutine is incarnated by either MMS INIT
or TEP INIT coroutines. Functions performed by dump
depend on the parameters deliver upon activation of
dump. Functions are:
- perform dump on usual volume until time specified.
- perform dump on new volume until time specified.
2 HIPOER
4.2.4.3.3.1 P̲e̲r̲f̲o̲r̲m̲ ̲D̲u̲m̲p̲ ̲o̲n̲ ̲U̲s̲u̲a̲l̲ ̲V̲o̲l̲u̲m̲e̲
Figure 4.2.4.3.3.1-1 presents the principal sequential
overview relationship during dump on usual volume.
Detailed control logic is depicted in figure 4.2.4.3.3.1-2.
Main control part, as described in 4.2.4.3.1 and 4.2.4.3.2
is responsible of incarnation of this sub-part. Note
that the two boxes made of dot and dash lines are identical.
Figure 4.2.4.3.3.1-1
Start
Wait semaphore off-line ̲disk ̲lock
Check mounted ̲volume
Right volume mounted? …0e…Yes…0f… TOC
dump loop
No
volume mount loop:
QEL = time-out loop
Mount request to report printer
Start 10 minutes time-out
Receive from MAQ EXIT, QEL = time out
End QEL = time-out loop
Right volume mounted? EXIT, right volume
mounted or mount
refused
End volume mount loop
QEL = mount refused? …0e…Yes…0f… return RC5
No
signal semaphore
off-line-disk-lock
FIGURE 4.2.4.3.3.1-2…01…PERFORM USUAL DUMP CONTROL LOGIC
TOC Dump loop:
Determine CIF batch to dump
Dump CIF command to MMS
Return code ok? …0e…Yes…0f… update off-line catalogue
No
wait semaphore lock
catalogue
update on-line catalogue
signal semaphore lock
̲cat
clear CIFs command to
MMS
update volume table
No operation EXIT, threshold warning or dump
totally completed or MMS
failure
End TOC dump loop
Case return code:
threshold warning? Return RC6
signal semaphore off-line
̲
disk ̲lock
dump totally completed? Return RC7
signal semaphore
off-line ̲disk ̲lock
End return code case
Return RC 8
Signal semaphore off-line ̲disk ̲lock
End
FIGURE 4.2.4.3.3.1-3…01…PERFORM USUAL DUMP CONTROL LOGIC
4.2.4.3.3.2 P̲e̲r̲f̲o̲r̲m̲ ̲D̲u̲m̲p̲ ̲o̲n̲ ̲N̲e̲w̲ ̲V̲o̲l̲u̲m̲e̲ ̲C̲o̲n̲t̲r̲o̲l̲
This sub-part is incarnated when main part has detected
a dump on new volume command. The perform dump on usual
volume sub-part, corresponds to the activity described
in 4.2.4.3.3.1.
Figure 4.2.4.3.3.2-1 depicts the control logic for
this sub-part.
Start
Wait semaphore lock ̲table
Add new entry to volume table
Signal semaphore lock ̲table
Perform dump on usual volume
End
FIGURE 4.2.4.3.3.2-1…01…PERFORM DUMP ON NEW VOLUME LOGIC CONTROL
4.2.4.4 S̲u̲b̲-̲P̲a̲c̲k̲a̲g̲e̲ ̲D̲a̲t̲a̲
Data elements handled by this sub-package have previously
been described in 4.1.4. Further a number of return
codes emanating from off-line retrieval shall be explained.
RC5 signifies that volume mount for dump has been refused.
The end copy time from last dump is a part of RC5.
RC6 signifies that the volume threshold of present
mounted volume has been exceeded and dump is completed
until time DTG.
RC7 signifies that dump has normally terminated until
time DTG.
RC8 signifies that dump has abnormally ended until
time DTG, caused by that off-line volume has been changed.
4.2.4.5 S̲u̲b̲-̲P̲a̲c̲k̲a̲g̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲
Dump interface is implemented via the below mentioned
interface elements:
- off-line ̲disk ̲lock, semaphore
- lock ̲table, semaphore
- lock ̲cat, semaphore
4.2.4.5.1 O̲f̲f̲-̲L̲i̲n̲e̲-̲D̲i̲s̲k̲-̲L̲o̲c̲k̲
Semaphore interface to the off-line retrieval sub-package.
Dump uses the semaphore when dump is incarnated by
the reception of a perform dump command. Released again
when dump is completed.
Semaphore ensures that dump is the only user of the
off-line disk during dump.
4.2.4.5.2 L̲o̲c̲k̲-̲T̲a̲b̲l̲e̲
Semaphore interfaces to the off-line retrieval sub-package
and supervisor command sub-package. Dump uses the semaphore
during update, and read contents of volume table. Update
takes place after dump of each batch, read before performing
a usual dump.
Semaphore ensures that dump is the only user of volume
table during dump.
4.2.4.5.3 L̲o̲c̲k̲-̲C̲a̲t̲.̲
Semaphore interface to the on-line retrieval sub-package.
Dump uses the semaphore during transfer of message,
transactions and catalogue information to the off-line
disk. Semaphore is released after each batch dump.
4.2.5 S̲u̲p̲e̲r̲v̲i̲s̲o̲r̲ ̲C̲o̲m̲m̲a̲n̲d̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲s̲
The supervisor command sub-package handles the implementation
of supervisor incarnated commands.
4.2.5.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲S̲p̲e̲c̲i̲f̲i̲c̲a̲t̲i̲o̲n̲
Functions included in this sub-package are as specified
below. They are:
- Receive and detect command
- Off-line retrieval off
- Off-line retrieval on
- Off-line retrieval suspended
- Request volume table entry
- Request volume table contents
- Delete volume table entry
- Start-up command
- Close-down command
Overleaf the functional specification is shown, presented
in figure 4.2.5.1-1.
Figure 4.2.5.1-1
4.2.5.1.1 R̲e̲c̲e̲i̲v̲e̲ ̲a̲n̲d̲ ̲D̲e̲t̲e̲c̲t̲ ̲C̲o̲m̲m̲a̲n̲d̲
Supervisor commands destined for SAR are sent to SCQ.
QEL sent to this queue are treated in a FIFO manner.
Upon reception of a QEL detection of type is performed.
According to type of QEL, corresponding function is
incarnated. Next QEL is received when the previous
incarnated function has terminated.
4.2.5.1.2 O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲O̲f̲f̲
Command has the effect that off-line retrieval is turned
off. Off-line retrieval waiting to be performed are
cancelled and requestors are responsed that off-line
retrieval is intermediately impossible. An ongoing
retrieval will terminate normally.
4.2.5.1.3 O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲O̲N̲
Incarnation of this command changes the status of off-line
retrieval to ongoing. Off-line retrievals are then
queued as normal and treated in FIFO manner.
4.2.5.1.4 O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲S̲u̲s̲p̲e̲n̲d̲e̲d̲
Off-line retrievals will be turned into the suspend
mode. Off-line retrievals are still being queued for
a possible later implementation. An ongoing off-line
retrieval will terminate normally, if off-line retrieval
is suspended during off-line retrieval in progress.
4.2.5.1.5 R̲e̲q̲u̲e̲s̲t̲ ̲V̲o̲l̲u̲m̲e̲ ̲T̲a̲b̲l̲e̲ ̲E̲n̲t̲r̲y̲
A volume-id is received as input parameter for this
command. The volume-table is consulted and entry to
corresponding volume-id is found. Volume-id, TOC interval
and DTG internal are returned to the supervisor's printer.
4.2.5.1.6 R̲e̲q̲u̲e̲s̲t̲ ̲V̲o̲l̲u̲m̲e̲ ̲T̲a̲b̲l̲e̲ ̲C̲o̲n̲t̲e̲n̲t̲s̲
The complete volume table is returned to the supervisor's
printer upon incarnation of this command.
4.2.5.1.7 D̲e̲l̲e̲t̲e̲ ̲V̲o̲l̲u̲m̲e̲ ̲T̲a̲b̲l̲e̲ ̲E̲n̲t̲r̲y̲
This function is performed when one of the off-line
volumes, used for storage of messages and transactions,
are deleted. Entry, corresponding to the input parameter
volume-id, in the volume table are deleted.
4.2.5.1.8 S̲t̲a̲r̲t̲-̲U̲p̲ ̲C̲o̲m̲m̲a̲n̲d̲
This start-up command is received from SSC. All necessary
start-up functions are performed.
4.2.5.1.9 C̲l̲o̲s̲e̲-̲D̲o̲w̲n̲ ̲C̲o̲m̲m̲a̲n̲d̲
Close-down function is carried out on all 5 sub-packages.
Storage sub-package will operate normally until no
storage requests are received any more.
On-line retrieval sub-package blocks the retrieval
request queue and completes all pending on-line retrievals.
Off-line retrieval completes the ongoing off-line retrieval
and cancels all outstandings.
Dump sub-package completes the ongoing batch dump.
Supervisor command sub-package turns into receive mode,
waiting for a start-up command.
4.2.5.2 S̲o̲f̲t̲w̲a̲r̲e̲ ̲S̲t̲r̲u̲c̲t̲u̲r̲e̲
The software is structured as shown overleaf. A receive
and detect module is always activated upon use of this
sub-package. One of below is then called depending
on the kind of supervisor command to be implemented.
Figure 4.2.5.2-1
4.2.5.3 D̲a̲t̲a̲ ̲F̲l̲o̲w̲ ̲a̲n̲d̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
Control logic for supervisor command sub-package is
performed by a main module and a number of modules
activated by the main module.
4.2.5.3.1 M̲a̲i̲n̲ ̲M̲o̲d̲u̲l̲e̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
Main module performs the reception of commands and
activation of corresponding modules. Reception of next
QEL from SCQ takes place after the previous function
has completed. The semaphore command ̲active handles
this funcion. Semaphore is "waited" by the main module
upon reception of next QEL.
Flowgram overleaf presents the logical control of the
main module.
Start
Reception loop:
Receive next QEL in SCQ
Wait semaphore command ̲active
Case QEL
Off-line retrieval off? perform off-line
retrieval
off
Off-line retrieval on? perform off-line
retrieval
on
Off-line retrieval susp.? perform off-line
retrieval
susp.
Request volume table entry? perform volume
table entry
Request volume table contents? perform volume
table contents
Delete volume table entry? perform delete
table entry
Start-up command? perform start
up
Close down command? perform close
down
End case QEL
Perform error QEL
End reception loop
Stop
FIGURE 4.2.5.3.1-1…01…MAIN MODULE (RECEPTION) LOGIC CONTROL
4.2.5.3.2 C̲o̲m̲m̲a̲n̲d̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
Control logic for each of the previous mentioned commands
(refer 4.2.5.1) is described next.
4.2.5.3.2.1 O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲O̲f̲f̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
Control logic is presented in flowgram 4.2.5.3.2.1-1.
4.2.5.3.2.2 O̲f̲f̲-̲l̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲O̲n̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
Control logic is presented in flowgram 4.2.5.3.2-1.
4.3.5.3.2.3 O̲f̲f̲-̲L̲i̲n̲e̲ ̲R̲e̲t̲r̲i̲e̲v̲a̲l̲ ̲S̲u̲s̲p̲.̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
Control logic is presented in flowgram 4.2.5.3.2.3-1.
4.2.5.3.2.4 V̲o̲l̲u̲m̲e̲ ̲T̲a̲b̲l̲e̲ ̲E̲n̲t̲r̲y̲ ̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
Control logic is presented in flowgram 4.2.5.3.2.4-1.
4.2.5.3.2.5 V̲o̲l̲u̲m̲e̲ ̲T̲a̲b̲l̲e̲ ̲C̲o̲n̲t̲e̲n̲t̲s̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
Control logic is presented in flowgram 4.2.5.3.2.5-1.
4.2.5.3.2.6 D̲e̲l̲e̲t̲e̲ ̲V̲o̲l̲u̲m̲e̲ ̲E̲n̲t̲r̲y̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
Control logic is presented in flowgram 4.2.5.3.2.6-1.
4.2.5.3.2.7 S̲t̲a̲r̲t̲-̲U̲p̲ ̲C̲o̲m̲m̲a̲n̲d̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
Control logic is presented in flowgram 4.2.5.3.2.7-1.
4.2.5.3.2.8 C̲l̲o̲s̲e̲ ̲D̲o̲w̲n̲ ̲C̲o̲m̲m̲a̲n̲d̲ ̲C̲o̲n̲t̲r̲o̲l̲ ̲L̲o̲g̲i̲c̲
Control logic is presented in flowgram 4.2.5.3.2.8-1.
Start
Off-line retrieval off? …0e…Yes…0f… signal semaphore command
̲active
No
Set off-line retrieval to off
Cancel pending requests in RRQ
Acknowledge requestors involved
Signal semaphore command ̲active
Stop
FIGURE 4.2.5.3.2.1-1…01…OFF-LINE RETRIEVAL OFF, CONTROL LOGIC
Start
Off-line retrieval on? …0e…Yes…0f… signal semaphore command
̲active
No
Set off-line retrieval to on
Signal semaphore command ̲active
Stop
FIGURE 4.2.5.3.2.2-1…01…OFF-LINE RETRIEVAL ON, CONTROL LOGIC
Start
Off-line retrieval susp.? …0e…Yes…0f… signal semaphore command
̲active
No
Set off-line ̲retrieval ̲susp.
Signal semaphore command ̲active
Stop
FIGURE 4.2.5.3.2.3-1…01…OFF-LINE RETRIEVAL SUSP., CONTROL LOGIC
Start
Wait semaphore lock ̲table
Find entry corresponding to input "vol-id"
Load buffer element with entry
Signal semaphore lock ̲table
Send buffer element to return queue
Signal semaphore command ̲active
Stop
FIGURE 4.2.5.3.2.4-1…01…VOLUME TABLE ENTRY CONTROL LOGIC
Start
Create item
Wait semaphore lock ̲table
Append volume table to item
Signal semaphore lock ̲table
Send item to return queue
Signal semaphore command active
Stop
FIGURE 4.2.5.3.2.5-1…01…VOLUME TABLE CONTENTS CONTROL LOGIC
Start
Wait semaphore lock ̲table
Delete entry corresponding to input "vol-id"
Possible update volume table pointers
Signal semaphore lock-table
Signal semaphore command ̲active
Stop
FIGURE 4.2.5.3.2.6-1
DELETE VOLUME ENTRY CONTROL LOGIC
Start
Perform start-up program
Signal semaphore command ̲active
Stop
FIGURE 4.2.5.3.2.7-1…01…START-UP COMMAND CONTROL LOGIC
Start
Perform close down program
Signal semaphore command ̲active
Stop
FIGURE 4.2.5.3.2.8-1…01…CLOSE DOWN COMMAND CONTROL LOGIC
4.2.5.4 S̲u̲b̲-̲P̲a̲c̲k̲a̲g̲e̲ ̲D̲a̲t̲a̲
Supervisor command data are presented according to
each of the previously mentioned (refer 4.2.5.1) functions.
- Receive and detect commands handle the reception
of input data. Input data are described during
respective commands
- Off-line retrieval off has no input or output data
- Off-line retrieval on has no input or output data
- Off-line retrieval susp. has no input or output
data
- Request volume table entry has as input parameter
a 16 character volume name. Output data are volume
name, two times TOCs and two times DTG. TOC and
DTG format is 11 characters each.
- Request volume table contents has no input parameter.
Output data are a CIF containing a number of volume
table entries. Table entries are described under
request volume table entry
- Delete volume table entry has as input data a 16
character volume name. No output data:
- Start up command has as input data a byte address,
addressing area where initial start-up information
is stored.
Start-up information refers to 2.2.2.1.
- Close down command has no input or output data.
4.2.2.5 S̲u̲b̲-̲P̲a̲c̲k̲a̲g̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲
Interface to other sub-packages is via the semaphores:
- lock ̲table
- offline ̲retrieval ̲susp
and the status information:
- off-line ̲retrieval ̲on/off
4.2.5.5.1 L̲o̲c̲k̲-̲T̲a̲b̲l̲e̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
Interface to dump sub-package. Controls the single
access to the volume table during request volume table
entry, request volume table contents and delete volume
table entry.
4.2.5.5.2 O̲f̲f̲-̲L̲i̲n̲e̲-̲R̲e̲t̲r̲i̲e̲v̲a̲l̲-̲S̲u̲s̲p̲.̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
Interface to off-line retrieval sub-package. Controls
the activity of the off-line retrievals. Interface
suspends the off-line retrieval activity.
4.2.5.5.3 O̲f̲f̲-̲L̲i̲n̲e̲-̲R̲e̲t̲r̲i̲e̲v̲a̲l̲-̲O̲n̲/̲O̲f̲f̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
Interface to off-line retrieval sub-package. Controls
the turn off and turn on of off-line retrievals.
4.3 M̲E̲M̲O̲R̲Y̲ ̲L̲A̲Y̲O̲U̲T̲
The memory areas pertinent in conjunction with the
performance of SAR activities are:
- program area
- main memory data area
- on-line disk data area
- off-line disk data area
4.3.1 P̲r̲o̲g̲r̲a̲m̲ ̲A̲r̲e̲a̲
The SAR process program area is fully main memory resident.
Size of program is 5k bytes. Figure 4.3-1 shows an
overview diagram of the main memory area.
4.3.2 M̲a̲i̲n̲ ̲M̲e̲m̲o̲r̲y̲ ̲D̲a̲t̲a̲ ̲A̲r̲e̲a̲
Main memory data area consists of a control area, a
TOC catalogue area (PRI ̲AREA) and a DTG catalogue area
(DTG ̲AREA). Size of each area is 12 bytes, 2048 bytes
and 512 bytes respectively.
4.3.3 O̲n̲-̲L̲i̲n̲e̲ ̲D̲i̲s̲k̲ ̲D̲a̲t̲a̲ ̲A̲r̲e̲a̲
Contained on the on-line disk is the on-line retrieval
catalogue. This consists of 3 files:
- TOC ̲FILE ̲ON
- DTC ̲FILE ̲ON
- PRI ̲FILE ̲ON
TOC ̲FILE ̲ON is a contiguos file of size 50.000 bytes.
DTB ̲FILE ̲ON is a contiguos file of size 160.000 bytes.
PRI ̲FILE ̲ON is a contiguos file of size 1 mega byte.
4.3.4 O̲f̲f̲-̲L̲i̲n̲e̲ ̲D̲i̲s̲k̲ ̲D̲a̲t̲a̲ ̲A̲r̲e̲a̲
Contained in each off-line volume used for storage
and retrieval of messages and transaction is the off-line
catalogue. This consists of 3 files:
- TOC ̲FILE ̲OFF
- DTG ̲FILE ̲OFF
- PRI ̲FILE ̲OFF
TOC ̲FILE ̲OFF is a contiguos file of size 0.4 mega bytes.
DTG ̲FILE ̲OFF is a contiguos file of size 1.3 mega bytes.
PRI ̲FILE ̲OFF is a contiguos file of size 8 mega bytes.
Overleaf overview diagrams of data areas are presented.
Main memory area figure 4.3-1.
On-line disk area figure 4.3-2.
Off-line disk area figure 4.3-3.
Figure 4.3-1
Figure 4.3-2
Figure 4.3-3
A̲P̲P̲E̲N̲D̲I̲X̲ ̲ ̲A̲
A.1 S̲P̲E̲C̲I̲F̲I̲C̲ ̲S̲T̲O̲R̲A̲G̲E̲ ̲A̲N̲D̲ ̲R̲E̲T̲R̲I̲E̲V̲A̲L̲ ̲K̲E̲Y̲S̲
This appendix contains the storage keys under which
the messages and transactions are stored. Below sections
include keys corresponding to message or transaction
type.
A.1.1 I̲n̲c̲o̲m̲i̲n̲g̲ ̲M̲e̲s̲s̲a̲g̲e̲ ̲A̲f̲t̲e̲r̲ ̲A̲n̲a̲l̲y̲s̲i̲s̲
- Type 1 identifier
- Item ref id
- Classification
- Channel id
- Channel serial no
- Station id
- Station serial no
- File-time
- DTG of release
- Orig. HQ PLA ref. #
- SIC1, SIC2, SIC3
- Exercise Indicator
- Special handling indicator
- TOC
A.1.2 I̲n̲c̲o̲m̲i̲n̲g̲ ̲M̲e̲s̲s̲a̲g̲e̲ ̲A̲f̲t̲e̲r̲ ̲S̲e̲l̲e̲c̲t̲i̲o̲n̲ ̲o̲f̲ ̲N̲o̲m̲i̲n̲a̲l̲ ̲D̲i̲s̲t̲r̲i̲b̲u̲t̲i̲o̲n̲
̲L̲i̲s̲t̲
- Type 2 identifier
- Item ref id
- Classification
- Special handling indicators
- Exercise indicator
- Station id
- DTG of release
- Orig. HQ PLA ref. #
- SIC1, SIC2, SIC3
- SCD1,...,SCD12
- TOC
A.1.3 F̲i̲r̲s̲t̲ ̲D̲r̲a̲f̲t̲
- Type 3 identifier
- Item ref id
- Classification
- Special handling indicators
- Exercise indicator
- Originating SCD
- SIC1, SIC2, SIC3
- Destination SCD1,...,SCD10
- TOC
A.1.4 C̲o̲m̲m̲e̲n̲t̲s̲
- Type 4 identifier
- Item ref id
- Classification
- Special handling indicators
- Exercise indicator
- Originating SCD
- Destination SCD1,...,SCD10
- TOC
A.1.5 R̲e̲l̲e̲a̲s̲e̲ ̲N̲o̲t̲i̲f̲i̲c̲a̲t̲i̲o̲n̲
- Type 5 identifier
- Item ref id
- Classification
- Exercise indicator
- Message originator SCD
- TOC
A.1.6 R̲e̲l̲e̲a̲s̲e̲d̲ ̲M̲e̲s̲s̲a̲g̲e̲s̲
- Type 6 identifier
- Item ref id
- Classification
- Special handling indicators
- Exercise indicator
- DTG of release
- Orig. HQ PLA ref. #
- SIC1, SIC2, SIC3
- Originator SCD
- Destination SCD1,...,SCD10
- TOC
A.1.7 R̲e̲l̲e̲a̲s̲e̲ ̲M̲e̲s̲s̲a̲g̲e̲s̲ ̲A̲f̲t̲e̲r̲ ̲A̲s̲s̲i̲g̲n̲m̲e̲n̲t̲ ̲o̲f̲ ̲T̲r̲a̲n̲s̲m̲i̲s̲s̲i̲o̲n̲ ̲K̲e̲y̲s̲
- Type 7 identifier
- Item ref id
- Classification
- Special handling indicators
- Exercise indicator
- Channel id
- Channel serial no.
- Station id
- Station serial no.
- File time
- DTG of release
- Orig. HQ PLA ref. #
- SIC1, SIC2, SIC3
- TOC
A.1.8 L̲o̲g̲ ̲I̲t̲e̲m̲s̲
- Type 8 identifier
- Classification
- TOC
