COMPILATION LISTING OF SEGMENT rmdb_free_db Compiled by: Multics PL/I Compiler, Release 28e, of February 14, 1985 Compiled at: Honeywell Multics Op. - System M Compiled on: 04/18/85 1106.2 mst Thu Options: optimize map 1 /* *********************************************************** 2* * * 3* * Copyright, (C) Honeywell Information Systems Inc., 1982 * 4* * * 5* *********************************************************** */ 6 rmdb_free_db: proc (absolute_db_path, saved_res_version_ptr, error_message, code); 7 8 /* 9* . BEGIN_DESCRIPTION 10* This procedure calls mu_quiesce to unquiesce the db and 11* create_copy_res to create an updated version of the saved 12* resultant. It is a separate routine instead of part of the 13* close_db_request so that there is a subroutine level interface 14* independent of the subsystem. 15* . END_DESCRIPTION 16* 17* Known Bugs: 18* 19* Other Problems: 20* 21* . HISTORY 22* 82-03-23 Davids: Written 23* 24* 82-05-26 Davids: changed to be compatable with the new 25* . mdbm_util_$quiesce_free calling sequence. 26* 27* 82-06-23 Davids: removed declared but unused builtins 28* 29* 82-07-01 Roger Lackey : Changed mu_quiesce$ to mdbm_util_$quisce_ for 30* binding. 31* 32* 83-05-24 Davids: Added the saved_res_version_ptr parameter. Also 33* it now checks the saved_res_version and if its not what it is 34* suppose to be it creates a new saved res. 35* 36*/* PARAMETERS */ 37 38 dcl absolute_db_path char (168); /* (input) data base path */ 39 dcl saved_res_version_ptr ptr; /* (input) pointer to the saved_res_version */ 40 dcl error_message char (500); /* (output) text of error message in case of problems */ 41 dcl code fixed bin (35); /* (output) standard error code */ 42 43 /* BASED */ 44 45 dcl based_char8 char (8) based; /* overlay for saved_res_version */ 46 47 /* ENTRIES */ 48 49 dcl dsl_$create_res_copy entry options (variable); 50 dcl ioa_$rs entry () options (variable); 51 dcl mdbm_util_$quiesce_free entry (char (168), fixed bin (35)); 52 53 /* EXTERNAL STATIC */ 54 55 dcl mrds_data_$saved_res_version char (8) external static; 56 57 /* BUILTINS */ 58 59 dcl length builtin; 60 61 /* 62* Initialize the output parameters 63**/ 64 65 code = 0; 66 error_message = ""; 67 68 69 70 71 /* 72* Create an upto date saved resultant and unquiesce the data base 73**/ 74 if saved_res_version_ptr -> based_char8 ^= mrds_data_$saved_res_version 75 then do; 76 call dsl_$create_res_copy (absolute_db_path, code); 77 if code ^= 0 78 then do; 79 call ioa_$rs ("Could not create a resultant copy for the database ^a, database not freed", 80 error_message, length (error_message), absolute_db_path); 81 goto exit_rmdb_free_db; 82 end; 83 end; 84 85 call mdbm_util_$quiesce_free (absolute_db_path, code); 86 if code ^= 0 87 then call ioa_$rs ("The database ^a cannot be unquiesced", error_message, length (error_message), absolute_db_path); 88 89 90 exit_rmdb_free_db: 91 return; 92 93 end rmdb_free_db; SOURCE FILES USED IN THIS COMPILATION. LINE NUMBER DATE MODIFIED NAME PATHNAME 0 04/18/85 0909.5 rmdb_free_db.pl1 >special_ldd>online>mrds.pbf-04/18/85>rmdb_free_db.pl1 NAMES DECLARED IN THIS COMPILATION. IDENTIFIER OFFSET LOC STORAGE CLASS DATA TYPE ATTRIBUTES AND REFERENCES (* indicates a set context) NAMES DECLARED BY DECLARE STATEMENT. absolute_db_path parameter char(168) unaligned dcl 38 set ref 6 76* 79* 85* 86* based_char8 based char(8) unaligned dcl 45 ref 74 code parameter fixed bin(35,0) dcl 41 set ref 6 65* 76* 77 85* 86 dsl_$create_res_copy 000010 constant entry external dcl 49 ref 76 error_message parameter char(500) unaligned dcl 40 set ref 6 66* 79* 79 79 86* 86 86 ioa_$rs 000012 constant entry external dcl 50 ref 79 86 length builtin function dcl 59 ref 79 79 86 86 mdbm_util_$quiesce_free 000014 constant entry external dcl 51 ref 85 mrds_data_$saved_res_version 000016 external static char(8) unaligned dcl 55 ref 74 saved_res_version_ptr parameter pointer dcl 39 ref 6 74 NAMES DECLARED BY EXPLICIT CONTEXT. exit_rmdb_free_db 000212 constant label dcl 90 ref 81 rmdb_free_db 000050 constant entry external dcl 6 THERE WERE NO NAMES DECLARED BY CONTEXT OR IMPLICATION. STORAGE REQUIREMENTS FOR THIS PROGRAM. Object Text Link Symbol Defs Static Start 0 0 304 324 213 314 Length 500 213 20 140 71 0 BLOCK NAME STACK SIZE TYPE WHY NONQUICK/WHO SHARES STACK FRAME rmdb_free_db 112 external procedure is an external procedure. THE FOLLOWING EXTERNAL OPERATORS ARE USED BY THIS PROGRAM. call_ext_out_desc call_ext_out return ext_entry THE FOLLOWING EXTERNAL ENTRIES ARE CALLED BY THIS PROGRAM. dsl_$create_res_copy ioa_$rs mdbm_util_$quiesce_free THE FOLLOWING EXTERNAL VARIABLES ARE USED BY THIS PROGRAM. mrds_data_$saved_res_version LINE LOC LINE LOC LINE LOC LINE LOC LINE LOC LINE LOC LINE LOC 6 000043 65 000055 66 000057 74 000063 76 000072 77 000106 79 000111 81 000143 85 000144 86 000155 90 000212 ----------------------------------------------------------- Historical Background This edition of the Multics software materials and documentation is provided and donated to Massachusetts Institute of Technology by Group BULL including BULL HN Information Systems Inc. as a contribution to computer science knowledge. This donation is made also to give evidence of the common contributions of Massachusetts Institute of Technology, Bell Laboratories, General Electric, Honeywell Information Systems Inc., Honeywell BULL Inc., Groupe BULL and BULL HN Information Systems Inc. to the development of this operating system. Multics development was initiated by Massachusetts Institute of Technology Project MAC (1963-1970), renamed the MIT Laboratory for Computer Science and Artificial Intelligence in the mid 1970s, under the leadership of Professor Fernando Jose Corbato. Users consider that Multics provided the best software architecture for managing computer hardware properly and for executing programs. Many subsequent operating systems incorporated Multics principles. Multics was distributed in 1975 to 2000 by Group Bull in Europe , and in the U.S. by Bull HN Information Systems Inc., as successor in interest by change in name only to Honeywell Bull Inc. and Honeywell Information Systems Inc. . ----------------------------------------------------------- Permission to use, copy, modify, and distribute these programs and their documentation for any purpose and without fee is hereby granted,provided that the below copyright notice and historical background appear in all copies and that both the copyright notice and historical background and this permission notice appear in supporting documentation, and that the names of MIT, HIS, BULL or BULL HN not be used in advertising or publicity pertaining to distribution of the programs without specific prior written permission. Copyright 1972 by Massachusetts Institute of Technology and Honeywell Information Systems Inc. Copyright 2006 by BULL HN Information Systems Inc. Copyright 2006 by Bull SAS All Rights Reserved