top - download
⟦3da6ef213⟧ Wang Wps File
Length: 18169 (0x46f9)
Types: Wang Wps File
Notes: CPS/SDS/025
Names: »1626A «
Derivation
└─⟦11f497f33⟧ Bits:30005812 8" Wang WCS floppy, CR 0119A
└─ ⟦this⟧ »1626A «
WangText
…07……00……86…1 …02… …02… …02…
…02…CPS/SDS/025
…02…850401…02……02…
MESSAGE MANAGEMENT
DETAILED DESIGN SPECIFICATON ISSUE 1 CAMPS
T̲A̲B̲L̲E̲ ̲O̲F̲ ̲C̲O̲N̲T̲E̲N̲T̲S̲
1 GENERAL .......................................
001
1.1 PURPOSE AND SCOPE ..........................
001
1.2 APPLICABLE DOCUMENTS AND PROJECT
REFERENCES .................................
001
1.2.1 Applicable Documents ...................
001
1.2.2 Project References .....................
002
1.3 TERMS AND ABBREVIATIONS ....................
002
1.3.1 Terms ..................................
002
1.3.2 Abbreviations ..........................
002
2 SUMMARY OF REQUIREMENTS .......................
004
2.1 PACKAGE DESCRIPTION ........................
004
2.1.1 Package Interrelations .................
004
2.1.1.1 Application Packages ...............
004
2.1.1.2 DMA Data Transfer ..................
005
2.2 PACKAGE FUNCTIONS ..........................
008
2.2.1 Main Functions .........................
008
2.2.1.1 Storage Structure ..................
008
2.2.1.2 CIF Directories ....................
012
2.2.1.3 CIF and View Structure .............
012
2.2.1.3.1 CIFs, Fields and Views .........
012
2.2.1.3.1.1 Field ......................
012
2.2.1.3.1.2 Field Group ................
012
2.2.1.3.1.3 CIF ........................
013
2.2.1.3.1.4 View .......................
015
2.2.1.3.2 Creation and Deletion ..........
018
2.2.1.3.2.1 CIF Creation and
Deletion ...................
018
2.2.1.3.2.2 View Creation and
Deletion ...................
018
2.2.1.3.2.3 Field Creation and
Deletion ...................
019
2.2.1.3.3 Field Access ...................
020
2.2.1.3.4 Disk Space Allocation ..........
021
2.2.1.4 CIF Attributes .....................
024
2.2.1.4.1 Permanent CIF ..................
024
2.2.1.4.2 Recoverable CIF ................
024
2.2.1.4.3 Security Profile ...............
025
2.2.1.4.4 Access Profile .................
025
2.2.1.4.5 CIF Versions ...................
025
2.2.1.5 CIF Storage and Retrieval ..........
026
2.2.1.5.1 Storage ........................
026
2.2.1.5.2 Retrieval ......................
027
2.2.1.6 CIF and View Referencing ...........
031
2.2.1.7 Active and Passive CIFs ............
031
2.2.1.7.1 Handles ........................
032
2.2.1.7.2 Commands Affecting Handles .....
032
2.2.1.7.3 CIF State Transitions ..........
033
2.2.1.7.4 Handles and Checkpoints ........
034
2.2.1.7.5 Relation to Dump ...............
034
2.2.1.7.6 Handles and Views ..............
034
2.2.1.8 File Management ....................
036
2.2.1.8.1 File References ................
036
2.2.2 Functional Responsibilities ............
037
2.2.2.1 Initialization, Close Down
and Restart ........................
037
2.2.2.2 Checkpointing and Recovery .........
038
2.2.2.2.1 Checkpoints ....................
038
2.2.2.2.1.1 SAVE Command ...............
040
2.2.2.2.1.2 Checkpoint Field ...........
040
2.2.2.2.2 Recovery Actions ...............
040
2.2.2.3 Error Detection and Error
Handling ...........................
043
2.2.2.4 Integrity of Operation .............
044
2.2.2.5 Data Collection ....................
045
2.2.2.6 Security ...........................
045
2.2.2.6.1 Security Profile .............
045
2.2.2.6.2 Purge of Disk and Memory .....
046
2.2.2.6.3 Storage Control ..............
046
2.2.2.7 Storage Accounting and
Monitoring .........................
046
2.2.2.7.1 Storage Occupancy ..............
046
2.2.2.7.2 Threshold Warning ..............
047
2.3 CHARACTERISTICS ............................
047
2.3.1 Timing .................................
047
2.3.1.1 CPU Usage ..........................
048
2.3.2 Throughput ............................
048
2.3.2.1 Storage Capacity ...................
048
2.3.2.1.1 Disk Consumption ...............
049
2.3.3.1 MMS Design Constraints .............
049
2.3.4 Accuracy ...............................
050
2.3.5 Memory Consumption .....................
050
3 ENVIRONMENT ...................................
051
3.1 EQUIPMENT ..................................
051
3.2 SOFTWARE ...................................
051
3.2.1 System Software ........................
051
3.2.2 Development Support Software ...........
051
3.3 INTERFACES .................................
051
3.3.1 External Interfaces ....................
051
3.3.2 Package Interfaces .....................
051
3.4 FUNCTIONS MAINTAINED BY OTHER PACKAGES .....
052
3.4.1 Kernel .................................
052
3.4.2 FMS ....................................
052
3.4.3 CSF ....................................
052
4 PACKAGE DESIGN ................................
053
4.1 PACKAGE OVERVIEW
4.1.1 Functional Specification ...............
053
4.1.1.1 Security Profiles ..................
053
4.1.2 Software Structure .....................
056
4.1.3 Data Flow and Control Logic ............
057
4.1.3.1 Main Flow ..........................
057
4.1.3.2 Reservation Mechanisms .............
057
4.1.3.2.1 CIF Reservation ................
058
4.1.3.2.2 OCD Reservation ................
058
4.1.3.2.3 Deadlock Prevention ............
058
4.1.3.3 Disk IO ............................
059
4.1.3.4 CIF Reference Logic ................
059
4.1.3.5 CIF State Transitions ..............
060
4.1.4 Common Package Data ....................
064
4.1.4.1 Constants ..........................
064
4.1.4.2 Primitive Types ....................
064
4.1.4.3 Memory Resident Data ...............
064
4.1.4.4 Disk Resident Data .................
074
4.1.5 Common Package Procedures ..............
076
4.1.5.1 Get CIF ............................
076
4.1.5.2 Open CIF ...........................
077
4.1.5.3 Close CIF ..........................
079
4.1.5.4 MMS Retire .........................
081
4.1.5.5 Check Security .....................
081
4.1.5.6 Computer Object Reference ..........
082
4.1.5.7 Convert Object Reference ...........
083
4.1.5.8 Create Segment .....................
084
4.1.5.9 Map in Free ........................
085
4.1.5.10 Ensure Segment ....................
085
4.1.5.11 General CMON and CTRL Interfaces ..
086
4.1.6 Global Data ............................
088
4.1.7 Interfaces .............................
089
4.1.7.1 External Interfaces ................
089
4.1.7.2 Package Interfaces .................
089
4.1.7.2.1 Interfaces to FMS ..............
089
4.1.7.2.1.1 Initialization .............
089
4.1.7.2.1.2 FMS Command Controller
to MMS .....................
090
4.1.7.2.1.3 MMS to Command Controller ..
090
4.1.7.2.1.4 MMS to Disk Cache Manager ..
090
4.1.7.2.1.5 Disk Cache Manager to
MMS ........................
090
4.1.7.2.2 Interfaces to Message Monitor ..
090
4.1.7.3 Subpackage Interfaces ..............
090
4.2 SUBPACKAGE SPECIFICATIONS ..................
091
4.2.1 Command Handling Subpackage ............
091
4.2.1.1 Functional Specification ...........
091
4.2.1.2 Software Structure .................
091
4.2.1.3 Data Flow and Control Logic ........
092
4.2.1.3.1 Running State ..................
092
4.2.1.3.2 Command Execution ..............
092
4.2.1.4 Module Specifications ..............
093
4.2.1.4.1 Command Handler Module .........
093
4.2.1.4.2 Storage Monitoring and
Statistics Module ..............
102
4.2.1.4.3 Initialization Module ..........
108
4.2.1.5 Common Subpackage Data .............
109
4.2.1.6 Common Subpackage Procedures .......
109
4.2.1.7 Subpackage Interface ...............
110
4.2.2 CIF Handling Subpackage ................
110
4.2.2.1 Functional Specification ...........
110
4.2.2.1.1 CIF Creation ...................
110
4.2.2.1.2 View Creation ..................
110
4.2.2.1.3 CIF and View Deletion ..........
110
4.2.2.1.4 Lookup and Lock ................
111
4.2.2.1.5 View Attributes ................
111
4.2.2.1.6 Field Handling .................
111
4.2.2.1.7 Storage Management .............
111
4.2.2.1.7.1 Short Term Storage
Allocation .................
112
4.2.2.1.7.2 CIF Storage Allocation .....
114
4.2.2.1.8 Disk Block Purge ...............
115
4.2.2.1.9 Initialization and Recovery ....
116
4.2.2.1.10 Error Handling ................
116
4.2.2.2 Software Structure .................
116
4.2.2.3 Data Flow and Control Logic ........
116
4.2.2.4.1 CIF Creation Module ............
116
4.2.2.4.2 View Creation Module ...........
125
4.2.2.4.3 CIF and View Deletion Module ...
131
4.2.2.4.4 Lookup and Lock Module .........
140
4.2.2.4.5 View Attributes Module .........
148
4.2.2.4.6 Field Handling Module .........
157
4.2.2.4.7 Storage Management .............
167
4.2.2.4.8 Purge Module ...................
174
4.2.2.4.9 Control Block Allocation Module
177
4.2.2.5 Common Subpackage Data .............
181
4.2.2.6 Common Subpackage Procedures .......
181
4.2.2.7 Subpackage Interfaces ..............
181
4.2.2.7.1 Create CIF .....................
181
4.2.2.7.2 Create New CIF Version .........
181
4.2.2.7.3 Create View ....................
182
4.2.2.7.4 Remove View ....................
182
4.2.2.7.5 Lock View ......................
183
4.2.2.7.6 Unlock View ....................
183
4.2.2.7.7 Stop CIF .......................
183
4.2.2.7.8 Lookup .........................
184
4.2.2.7.9 Get View Attributes ............
184
4.2.2.7.10 Change Attributes .............
185
4.2.2.7.11 Create Fields .................
185
4.2.2.7.12 Generate CIFCB ................
185
4.2.2.7.13 Check Passivation .............
186
4.2.2.7.14 Delete View ...................
186
4.2.2.7.15 Extend Field ..................
186
4.2.2.7.16 Purge Block ...................
187
4.2.2.7.17 Put Attributes ................
187
4.2.2.7.18 Check Deletion ................
187
4.2.2.7.19 Make CIF Permanent ............
188
4.2.3 CIF Storage and Retrieval Subpackage ...
189
4.2.3.1 Functional Specification ...........
189
4.2.3.1.1 Storage Management .............
193
4.2.3.1.1.1 Packed CIF Representation ..
193
4.2.3.1.1.2 Intermediate Storage
Organization ...............
194
4.2.3.1.1.3 Long Term Storage
Organization ...............
195
4.2.3.1.1.4 Initialization and
Recovery ...................
205
4.2.3.1.2 Directory Management ...........
205
4.2.3.1.3 Error Handling .................
208
4.2.3.2 Software Structure .................
208
4.2.3.3 Data Flow and Control Logic ........
208
4.2.3.3.1 CIF and OCD Reservation ........
208
4.2.3.3.2 Dump Control ...................
208
4.2.3.3.3 Active and Passive CIFs ........
210
4.2.3.4 Module Specification ...............
210
4.2.3.4.1 Store Module ...................
210
4.2.3.4.2 Unload Module ..................
214
4.2.3.4.3 Dump Module ....................
225
4.2.3.4.4 Clear Module ...................
241
4.2.3.4.5 Retrieve Module ................
245
4.2.3.5 Common Subpackage Data .............
262
4.2.3.6 Common Subpackage Procedures .......
262
4.2.3.7 Subpackage Interface ...............
262
4.2.3.7.1 Store ..........................
262
4.2.3.7.2 Init Dump ......................
262
4.2.3.7.3 Dump CIF Sequence ..............
263
4.2.3.7.4 Terminate Dump .................
263
4.2.3.7.5 Clear ..........................
264
4.2.3.7.6 Retrieve .......................
264
4.2.3.7.7 Unload .........................
265
4.2.3.7.8 Copy Fields ....................
265
4.2.4 Checkpoint and Recovery Subpackage .....
266
4.2.4.1 Functional Specification ...........
266
4.2.4.1.1 OCD Management .................
268
4.2.4.1.1.1 OCD Organisation ...........
268
4.2.4.1.1.2 Entry Types ................
268
4.2.4.1.1.3 Access Algorithm ...........
269
4.2.4.1.1.4 Creation of Entries ........
269
4.2.4.1.1.5 Search of Entries ..........
270
4.2.4.1.1.6 OCD Recovery ...............
273
4.2.4.1.1.7 OCD Initialization .........
273
4.2.4.1.2 Recovery Function ..............
273
4.2.4.1.2.1 Restore ....................
273
4.2.4.1.2.2 Start ......................
273
4.2.4.1.3 Checkpointing Function .........
274
4.2.4.1.3.1 Save .......................
274
4.2.4.1.3.2 Checkpoint Update ..........
274
4.2.4.1.3.3 Checkpoint Contents ........
274
4.2.4.1.3.4 Handle Counts in
Checkpoint .................
279
4.2.4.1.3.5 Recovery Block .............
279
4.2.4.2 Software Structure .................
280
4.2.4.3 Data Flow and Control Logic ........
280
4.2.4.4 Module Specification ...............
280
4.2.4.4.1 OCD Search Module ..............
280
4.2.4.4.2 OCD Update Module ..............
291
4.2.4.4.3 Restore Module .................
299
4.2.4.4.4 Save Module ....................
307
4.2.4.4.5 Checkpoint Update Module .......
317
4.2.4.4.6 Start Module ...................
320
4.2.4.5 Common Subpackage Data .............
322
4.2.4.6 Common Subpackage Procedures .......
322
4.2.4.7 Subpackage Interface ...............
322
4.2.4.7.1 Restore ........................
322
4.2.4.7.2 Save ...........................
323
4.2.4.7.3 Start ..........................
323
4.2.4.7.4 Search OCD .....................
323
4.2.4.7.5 Delete OCD .....................
324
4.2.4.7.6 Enter OCD ......................
324
4.2.4.7.7 OCD Unload Update ..............
324
4.2.4.7.8 Activate CIF ...................
325
4.2.4.7.9 Add Passive Handle .............
325
4.2.4.7.10 Remove Passive Handle .........
325
4.2.4.7.11 Passivate .....................
326
4.2.4.7.12 Set Stopped Status ............
326
4.2.4.7.13 Read Checkpoint ...............
326
4.2.4.7.14 Check View in Checkpoint ......
327
4.2.4.7.15 Check CIF Status ..............
327
4.2.4.7.16 OCD Long Checkpoint Update ....
327
4.2.5 Disk I/O Subpackage ....................
328
4.2.5.1 Functional Specification ...........
328
4.2.5.1.1 Disk Buffer ....................
328
4.2.5.1.2 Use of Procedures ..............
328
4.2.5.1.3 Modules ........................
330
4.2.5.1.4 Error Handling .................
330
4.2.5.2 Software Structure ................
333
4.2.5.3 Data Flow and Control Logic .......
333
4.2.5.3.1 Disk Manipulation .............
333
4.2.5.3.2 Data Transfers ................
333
4.2.5.4 Module Specification ..............
337
4.2.5.4.1 Disk Manipulation Module ......
337
4.2.5.4.2 Data Transfer Module ..........
343
4.2.5.4.3 I/O Functions Module ..........
354
4.2.5.5 Common Subpackage Data ............
365
4.2.5.6 Common Subpackage Procedures ......
365
4.2.5.7 Subpackage Interface ..............
365
4.2.5.7.1 Read Block ....................
365
4.2.5.7.2 Init Write Block ..............
366
4.2.5.7.3 Init Update Block .............
366
4.2.5.7.4 Write Buffer ..................
367
4.2.5.7.5 Release Buffer ................
367
4.2.5.7.6 Write and Release Buffer ......
368
4.2.5.7.7 Get Sequential ................
369
4.2.5.7.8 Get Random ....................
369
4.2.5.7.9 Put Sequential ................
369
4.2.5.7.10 Put Random ....................
370
4.2.5.7.11 Put Integer ...................
370
4.2.5.7.12 Put Words .....................
370
4.2.5.7.13 Move Buffer ...................
371
4.2.5.7.14 Read View .....................
371
4.2.5.7.15 Write View ....................
371
4.2.5.7.16 Init Put Sequential ...........
372
4.2.5.7.17 Flash Put .....................
372
