MDBS COMPACT BACKUP RESTORE UTILITY MANUAL

Volltext

(1)F .. MDBS COMPACT. BACKUP RESTORE UTILITY MANUAL. - The MDBS CBRU Manual Version. Micro Data. 3.0. Base. -. 8. Systems, Inc.. P.O. Box 248 Lafayette, Indiana 47 902 USA. September 1984 Revised December 1985. Copyright. Notice. This entire manual is provided for the use of the customer and the customer's employees. The entire contents have been copyrighted by Micro Data Base Systems, Inc., and reproduction by any means is prohibited except as permitted in a written agreement with Micro Data Base Systems, Inc.. ©COPYRIGHT. }984,1985. Micro. Data Base Systems,. Inc.. 3270362 C.

(2) NEW RELEASES,. VERSIONS,. AND. A WARNING. of the MDBS software will necessarily continue to programming Any endeavor of the magnitude its users with this, Micro Data Base Systems, Inc., vows to provide evolve over time. Realizing fee. updates to this version for a nominal handling New versions of MDBS software will previous versions are generally entitled. be. considered as separate products. to a preferential rate structure.. However,. bona fide owners of. each the licensee. There are several levels of to identify copy of our software is personalized personalization, of which involve encryption methods guaranteed to be combinatorially some difficult to decipher. Our products have been produced with a very substantial investment of capital and labor, to say nothing of the years of prior involvement in the data base management area by our principals. are Accordingly, seriously concerned about we any unauthorized copying of our products and will take any and all available legal action against illegal copying or distribution of our products.. Finally, this. DISCLAIMER. NOTICE. All. rights reserved. No part of this material shall be reproduced, stored in a retrieval system, or transmitted by any means, electronic, mechanical, photocopying, recording, without or otherwise, written permission from Micro Data Base Systems, Inc.. Although. has care been taken in the preparation of this material, Micro Data Base Systems, Inc. assumes neither responsibility for errors or omissions, resulting from the use of the nor for damages information contained herein. Micro Data Base Systems, Inc. does not warrant its accuracy nor guarantee the operation of the system in every instance described herein.. The reader/user assumes full liability and all risk information contained herein, and for determining suitable for user's intended purpose. Micro Data Base in its software documentat ion.. for any damages whether the. resulting information. from the contained. of the herein is. use. Systems, Inc. reserves the right to incorporate design improvements and new functions products and software systems. Recent improvements may not always be reflected in. ©COPYRIGHT. 1984.1985. Micro. Data Base Systems,. Inc..

(3) I. INTRODUCTION. The performs . . .. CBRU. floppy. Compact-BackupRestore three important activities:. (CBRU). Utility. is. an. interactive,. menu- driven. backup system.. It. produces compact backups of MDBS data bases produces compact backups of individual files restores compact data bases/files is media- independent. A CBRU user can diskette, a tape, a cartridge, or a hard disk. make singleor multias the backup medium,. file. volume backups for example.. using. a. Data Base Compaction: CBRU understands the structure of an MDBS data base. (An MDBS data base consists of one or more areas. Each area is divided into pages. The pages can be blank or can contain information.) During the backup process, CBRU recognizes the existence of areas. between blank and non-blank It also distinguishes pages. Blank pages are compacted they occupy no space in the backup, for all practical purposes. to the point at which Non- blank pages the data base are regarded as byte streams, which CBRU compresses. During compaction option, CBRU performs "housecleaning" tasks. As a result, any holes which existed in the data base prior to data base compaction are reinitialized to their original empty state. The resulting backup is a compacted file. File Byte Compaction: CBRU can back up individual files. A user can opt to back up an MDBS data base area-by-area, or any other files which contain data or programs. CBRU regards the contents of each file as a byte stream, which it compresses during the backup backup is a compacted file. process. The resulting Restoration: CBRU restores a compacted MDBS data base or an individual file to its has previous expanded state. A data base which been compacted by use of the data base compaction option and then restored is identical to the original with one exception: Any holes which existed in the data base prior to compaction have now been reinitialized to their original empty state. This change is reflected in the restored data base. CBRU does not perform these housekeeping tasks if you select the file byte compaction option. In this case, contents of a restored data base area or any other file are identical to those of the file before it was compacted. CBRU's usefulness is efficiently. On the other, non-users alike.. ©COPYRIGHT. 1984,1985. Micro. twofold: On it provides. Data Base Systems,. one hand, a versatile,. Inc.. enables users to transmit large MDBS convenient backup utility to MDBS. it. data users. bases. and. !.

(4) II. CBRU FEATURES A.. Getting Install. Started CBRU. by placing. its. file. on the appropriate. drive.. Invoke. it. by entering:. CBRU. (See CBRU then displays a menu which consists of available options. Figure II- I.) Make your selection by entering the letter which follows the desired option. If you select the Exit option, you guide you a series of to the operating system. Otherwise, return prompts appears. The prompts through the selected compaction or restoration activity. When compaction or restoration is completed, you return to this menu.. Error. Messages:. you may encounter diagnostics.. Refer to the MDBS-DMS processing. Section during. (CBRU Compact COPYRIGHT 1984, Lafayette, IN 47902. MOBS. (C). -. Backup. Micro. Manual for an explanation of any DMS error messages D of this manual contains an explanation of CBRU. Utility) - Restore Base Systems,. Data. Ver. 3.. XX. Inc.. OPTIONS: base compaction: File byte compaction: Restore: Exit:. Data. D F R E. Enter option:. Figure. II- I:. "free On some operating systems the option the free space available on a target disk drive.. 2. Space. The CBRU. Menu. on drive:. S". will. ©COPYRIGHT. also appear. This. 1984.1985. Micro. Data. option. shows. Base Systems,. Inc..

(5) B.. Menu. Data. Base. Options. Compaction. - Option. D. Data Base Compaction Option produces a backup of an MDBS data base. When you select this CBRU displays the prompts shown in Figure II- 2. Respond to them by entering the name of option, the file which holds the main data base area, and password, and the names of files your user name which hold secondary data base areas, if any. The. Notice the example in Figure and two secondary areas ( areal.dba The names of the secondary areas, ENTER to enter the default values,. Data base: User name: Password:. sample.. db. for for. area area. Figure. If. you enter a dash to be off-line.. ). user. Enter filename Enter filename. areas. 2. The data base consists of the main data base area ( sample.db and area2.dba ). CBRU recognizes the structure of your data base. in the DDL description, values. Press as defined are used as default Otherwise, enter a name as desired. as in this example.. II-. ("-"). This. AREA1 AREA2. II - 2:. [areal .dba] [area2. dba]. Prompts. in response to an be dangerous. can. area. for Data. prompt,. ? ?. Base. CBRU. Compaction. will. ignore. that. area.. This. allows. some. Restoration Note: When a data base which has been compacted using the data base compaction is restored, option it may not compare byte-for-byte with the original. This is due to housecleaning performed by CBRU during the data base compaction option.. ©COPYRIGHT. 1984,]985. Micro. Data Base Systems,. Inc.. 3.

(6) CBRU uses your responses to produce single- or multi-volume backups. You specify a file name root and the maximum volume size in response to CBRU prompts. Each volume of the backup consists of one compacted file. File Name Root: CBRU generates the name volume number (I, 2, 3, ...) to the specified the file name root is dbback.v : prompt,. File. name. root for. compacted. for. file. volumes?. each name. volume's compacted file by appending a root. In the following example of a CBRU. dbback.v. Size: CBRU next prompts for the maximum size of a compacted volume. Minimum Volume CBRU uses maximum size to determine when a change of volume is necessary. A typical response is the for instance). Your response must be an diskette, maximum size of the selected medium (a floppy integer which indicates number of bytes. A suffix of k or r can follow the integer, in which case the (Entries of 2048, 2k, and l6r are equivalent.) integer is multiplied by 1024 or 128, respectively. Maximum After. size of. you enter volume. size,. a. 200k. volumes?. compacted. responses is displayed,. of your. summary. as. shown. in Figure. II-. 3:. Summary:. file. Data base name Root name for compacted Maximum volume size. :. volumes. Figure. : :. II-. 3:. sample. dbback 204800. .. db v. bytes. (200. k). Summary of Responses. The default for maximum size is no limit. If you select the no limit Size Default: Volume The physical is written. volume default, limits of the chosen medium then determine the one only useful when using a hard disk as the volume size. The no limit default is particularly maximum medium. backup. ©COPYRIGHT 4. 1984,1985. Micro. Data. Base Systems.. Inc..

(7) Press ENTER to select the default the backup procedure follows. A request to continue example: Enter CBRU For below. the shown as to to return no menu. yes,. Continue [yes] If prompts. ?. insert. you continue with the backup, is shown in Figure IT-4:. volumes. Insert volume 1 and press return: Writing to : dbback.v1 Processing sample. db 1 and Remove volume insert volume .v2 dbback Writing to : .dba Processing areal Processing area2 .dba of. Number. files written: Figure. In. this. data. base. area2. .dba.. CBRU Upon. will. completion. ©COPYRIGHT. your. terminal. of the data. 1984,1985. Micro. Data. 2,. as. Changing. press return:. Volumes. During. backup consists of two main area named sample.db,. base a. to. base. An example of CBRU. requested by CBRU.. 2. II-4:. example, the data itself consists of. cause. value of. beep. (if. possible). compaction. Base Systems,. Inc.. option,. Compaction. volumes, dbback.vl and two secondary. when prompting you return. for. a. The and dbback.v2. areas, areal .dba and. new volume.. to the CBRU. menu.. 5.

(8) File Byte Compaction. - Option. F. The File Byte Compaction Option backs up an MDBS data base area- by -area, or any other file which contains data or programs. This option is particularly useful if you want to back up only a portion of the data base, or if there is difficulty opening the data base. CBRU does not perform housecleaning tasks during file byte compaction. Therefore, restored files are identical to the. original.. The described. file byte compaction prompts in the preceding section.. Restoration. bases. - Option. and. process. are. similar. to. those of. To restore a data base or single the CBRU menu. A series of prompts. name. root of. file. that follows,. compacted. has. of. files. reacL. previously been compacted, shown in Figure II- 5:. as. volumes?. Insert volume 1 and press return: reading from: dbback .vI ] Output file name? [sample. db 1 and Remove volume insert volume Reading from: dbback.v2 ] Output file name? [areal .dba ] Output file name? [area2. dba Number. base. compaction. R. The Restore Option restores data bases compacted with the data base and individual files compacted with the file byte compaction option.. File. data. dbback. compaction. option. select the R. or data. option. from. .v. test. db press return:. 2,. tarea1 . dba tarea2. dba. 2. Figure. II-. S:. Restore Prompts. in Figure II-5 illustrates, CBRU first prompts you for the file name As the sample restoration root of the backup volumes to be restored. You are then prompteíi to insert the first backup volume and to specify the name of the file which will hold the restored data base or file. CBRU will cause terminal beep possible) when prompting for a new volume. to (if your Notice that the default values of the output file names, (sample.db, areal.dba and area2.dba, in ENTER of the original files. Press this case) are the names to select the default value. One way to avoid overwriting contents of the original file is to specify an output file name which differs from is placed on test.db. example in Figure ll-S, the restored output the original. In the restoration tareal .dba, and tarea2 .dba.. 6. ©COPYRIGHT. 1984,1985. Micro. Data Base Systems.. Inc..

(9) C.. Batch Mode. You can use CBRU on a batch basis. Simply include one or rnore of the following command line options when you invoke CBRU: -d, -i, -p, -u. Three of the options (- d, -u, and -p) are for use with the data base compaction option. The fourth option (- i) is for use with any CBRU compact or restore procedure. Data. base. option: Specify CBRU. Input. -dfilename filename, the not prompt. option:. of the for the name. name. will. file. If -d. which holds the main data base area. during the data base compaction option.. is in effect,. - icmdfilename. Specify cmdfilename, of a command file holding the name the information which you would in interactive mode. If -i is in effect, CBRU will not prompt enter in response to prompts data base or file byte compaction. The -i option can also be used you for commands during for data base or file byte restoration. When you use the option, one volume must be large enough to contain the entire backup.. -i. Password. option:. -ppassword. Specify password, a valid user password. If -p is in effect, password entry during the data base compaction option.. User name. option:. option:. will. you for. not prompt. a. - uusername. Specify username, a user's name. If -u is in effect, during the data base compaction option.. Verify. CBRU. CBRU. will. not prompt. you for. a. user. name. -v. This turns systems.. off. verification. during. CBRU. -uuser -uusér. -ppass -ppass. operation.. It. may not. be. available. on all operating. Examples:. cbru -dsample. cbru -dsample. cbru -icmdfile. ©COPYRIGHT. !984,1985. Micro. Data. db db. Base System's,. Iñc.. -icmdfil.e. 7.

(10) D.. CBRU. Diagnostics. This section and/or solutions. Can't. open input. describes the diagnostics also cited.. file. Explanation: Possible 1.. 2. 3.. Can't. Data. base. file. Data. base. :. corrupt!. I.. 2.. 8. of CBRU.. Possible. causes. the input. access. file.. could. not. Page. number. the output. access. be. read-only.. expecting. problem. file.. with. pape number the data. base. discovered.. :. Bad. option. (File Byte Compaction). record pointer. Pointer. rather than the D. option. (Data. Base. Compaction).. (Data. Base. Compaction).. on page pape number. error on the specified. page of the data. base. discovered.. Cause/Solution: Use the F. Explanation:. I.. not. page number,. option. error code number. Possible. execution. Cause/Solution:. Explanation:. Error. Bad. Use the F. Possible. during. filename. CBRU. Explanation:. 1.. could. Cause/Solution: File may already exist and. corrupt!. Possible. result. Cause/Solution: File name incorrect or misspelled. Drive not specified. Path not specified completely.. Explanation:. I.. can. filename. CBRU. open output. Possible. that. are. CBRU. in. (File Byte C·c}m?actiog: .) 'rather tZaii the D. reading. filename. did not recognize. Cause/Solution: The file to be restored was disk damaged. The floppy. hdr from compacted the. file. as. one that. OF". ion. file was. compacted using. CBRU.. not compacted by CBRU.. ©COPYRICET. !984.1985. Mic: "o Data. Base Systems,. Inc..

(11) Invalid option. ERROR:. Explanation: Possible 1.. File. Self explanatory. Cause/Solution: An entry other. open error. in file file. Explanation: Possible I. 2.. File. Error. 2. 3.. a. valid. option. entered. was. a. as. menu option.. name. encountered. file file. Explanation:. 1.. than the letter of. trying. while. to open/create. Cause/Solution: File name specified incorrectly. The file is user-protected, and user did. open error on. Possible. selection. CBRU. not have. a. access. file.. to. it.. name. could. not read the specified. file.. Cause/Solution: File name misspelled or does not exist. Floppy disk not in drive. Wrong floppy disk in drive. ,. Garbled. data. Éxplanation:. CBRU. encountered. invalid. data. L. L. Possible. l. 2. 3.. No. Cause/Solution: You switched volumes when prompted Bad floppy disk. ' CBRU error - call customer support.. for. a. file. Reinsert. name. f. '. the original. volume.. '. file Explanation: Possible. l.. No. file. Cause/Solution: Enter a valid. name. file. was. name. entered in response to. as. required.. '. a. prompt. for one.. '. '. >L. ©COPYRIGHT. 19&4,1985. Micro. Data. Base Sygtems,. Inc.. 9.

(12) Not. a. CBRU. compacted. Explanation: Possible 1.. Not enough. 1.. Not enough. free. l. Not smaller. I. 2.. Output. file. I.. 10. that. was. not generated by CBRU.. drive. on disk. for Data. a. page. base. with oF. a. smaller. volume. space. on the. size.. size pappsize. page size too large for CBRU. exe: utic'n.. Cause/Solution: Increase memory.. than voj:. 'sme. sizí!. The maximum. size specified. for compacted. volumes. was. not. large enough.. Cause/Soluticm: Maximum size must be at least 256 bytes. Specify a larger volume size.. write. Explanation: Possible. file. a. This will not occur on some operating systen"s. There is not enough target drive to hold for the current backup volume size.. memory. Explanation: Possible. space. made to restore. Cause/Solution: Restart the backup. Explanation: Possible. Self explanatory.. Cause/Solution: An attempt was. Explanation:. Possible. file. error (error code numbu) Error. occurred whm. attempting. to write. to the. file.. Cause/SYQ!\jtion: Disk too full.. ©COPYRIGZIT. 193'(.298S. Micro. Data. Base Systems,. Inc..

(13) Read. error on input Explanation: Possible. file Error. when attempting. encountered. l. 2. 3.. Unexpected. EOF encountered. Explanation: Possible. file. End of. file. on. name. occurred. -7. 2.. '. ". '. '. ... ... .t. -. prematurely.. Cause/Solution: CBRU cannot interpret the input File data corrupted or destroyed.. I.. file.. to read. Cause/Solution: Bad sector on disk. ' Disk not present in correct disk drive. Hardware error.. '. file. '. .. Bad check sum on page papp number. Explanation: Possible. with. the data. Cause/Solution: An error encountered. I. Warning:. Problem. Data. base. 'i. code ];. page. " '. '. '. ". '. '. . '. ". discovered.. when check sum was being performed. [error. corrupt. base. -. restoration.. during. '. Warning:. ". '. ·'. on the data. 'base. pages.. "'. page number t. Explanation:. The data. damaged or destroyed... base. '. '. .. '.. · ( i, - ".. "-. Possible L.. Cause/Solution: Use the F option (File Byte Compaction). Wrong. volume:. wrong. Explanation: Possible. l.. ©COPYRIGHT. volume. Wrong. number. volume. Cause/Solution: Disks must be restored. 1984,1985. Micro. ·. inserted. in. the. Data Base Systems,. Inc.. in response to. same. f- '. rather than the D option , : ;V·. U". . a. prompt. order in which. " d. .. C". ' '. (Data. Base. Compaction).. e: ,'[ ' 1 .C;'- :. during. "". reStoration.. they were compacted.. 1. l.

(14) DOCUMENTATION MDBS. Document. COMMENT. FORM. Title:. welcome and appreciate all comments and suggestions Use this help us to improve our manuals and products. views manual. express concerning this your We. that can form to. Please do not use this form to report system problems or to request materials, etc. System problems should be reported to MDBS by phone or telex, or in a separate letter addressed to the Requests for support division. attention of the technical published materials should be addressed to the attention of the marketing division. Sender:. (position). (name) (company). (telephone). (address). (city, state, zip) COMMENTS:. Areas of comment are geneEal presentation, format, organization, completeness, a comment applies to etc. clarity, accuracy, specific page or pages, please cite the page number(s).. If. Continue. on. additional. pages,. as needed.. Thank. you. for your. response.. a.

(15)