|
|
1.1 ! root 1: .de HE 'Version six changes'INGRES'%' ! 2: .so nmacs ! 3: Users of INGRES version five should be aware of certain differences ! 4: between version five and version six. ! 5: Version six fixes all the known bugs that were in version five. ! 6: Some of these fixes and improvements might cause ! 7: some version five queries to not run correctly on version six. ! 8: For this reason, we have itemized the changes which ! 9: you should be aware of. ! 10: Refer to the new version six reference manual for additional details. ! 11: ! 12: .sh 1 ! 13: Storage Structures. ! 14: .dn ! 15: Incompatibilities. ! 16: .PS ! 17: Version six of INGRES will NOT run on a ! 18: version five data base. ! 19: All data bases must be recreated. ! 20: There is a utility program called ! 21: "copydb5" which aids in the ! 22: conversion process. ! 23: Refer to the INGRES reference manual ! 24: under copydb(UNIX) for documentation ! 25: on how to use copydb5. ! 26: .sh 1 ! 27: Monitor ! 28: .dn ! 29: Different working directory ! 30: .PS ! 31: The monitor now runs in the working ! 32: directory where the user was at the ! 33: time INGRES was invoked. ! 34: This means that when you escape to the ! 35: shell or the editor, you will ! 36: be in the same working directory as ! 37: when you invoked INGRES. ! 38: .sh ! 39: Auto-clear mode ! 40: .PS ! 41: The version five monitor required you to ! 42: reset the workspace after a query ("\\r"). ! 43: The version six monitor does approximately ! 44: the opposite. ! 45: ! 46: If the first line after a query does NOT ! 47: begin with the command "\\p", "\\g", "\\e", or "\\a", then ! 48: the monitor automatically resets the workspace ! 49: for you. ! 50: Otherwise, the command is interpreted and new lines are ! 51: appended to the workspace. ! 52: The autoclear feature can be suppressed by using ! 53: the "-a" flag when invoking INGRES. ! 54: Once you use the autoclear feature for a while, ! 55: however, you will really appreciate it. ! 56: .sh ! 57: Rubout works! (nearly always) ! 58: .PS ! 59: Typing a rubout or break causes INGRES to ! 60: stop what it is doing and return cleanly ! 61: to the monitor. ! 62: If a rubout is typed during a modify or defered ! 63: update, a message is issued and further rubouts ! 64: are ignored until the processing is complete. ! 65: ! 66: Many critical sections in the INGRES ! 67: code still exist ! 68: where typing a rubout can cause a ! 69: SYSERR message. ! 70: Those are being cleaned out on a gradual basis. ! 71: In general rubout processing works correctly and in ! 72: any case will never hurt the data base if all ! 73: you are doing is a retrieve ! 74: or a print. ! 75: .sh 1 ! 76: Parser ! 77: .dn ! 78: New keywords and features. ! 79: .PS ! 80: We have implemented two new commands: ! 81: CONCAT and ASCII. ! 82: Those words are now reserved words. ! 83: ASCII converts a numeric of any type to ! 84: a character string. ! 85: CONCAT takes two character strings and forms ! 86: a new one. ! 87: Trailing blanks of the first character string are ! 88: removed before concatenating the second string. ! 89: .sh ! 90: The shorthand notation x.all. ! 91: .PS ! 92: ALL can be used in retrieves and appends. ! 93: Its meaning expands to be all domains of ! 94: a relation. ! 95: The order of the domains is nearly always the ! 96: same as the order from the create statement; ! 97: however, this is not presently guaranteed. ! 98: .sh ! 99: Pattern matching ! 100: .PS ! 101: We have implemented the "shell syntax" pattern ! 102: matching characters "*", "?", "[]". ! 103: They can be used in a qualification but not ! 104: in a target list. ! 105: Their special meaning ! 106: can be turned off by preceding them with a ! 107: "\\". ! 108: .sh ! 109: Correct precedence. ! 110: .PS ! 111: The parser now gives the correct precedence ! 112: to numeric operators. ! 113: It previously gave equal precedence ! 114: to all numeric operators (+,*,**, etc.). ! 115: .sh 1 ! 116: Copy ! 117: .dn ! 118: File modes. ! 119: .PS ! 120: The previous version of copy created files ! 121: owned as INGRES in mode 666, and demanded ! 122: that any file to be read must be ! 123: readable by INGRES. ! 124: ! 125: The version six copy ! 126: runs as the user. ! 127: Thus on coping into a relation, the ! 128: UNIX file need be readable only by the ! 129: real users. ! 130: On a copy out of a relation, the file ! 131: is created in mode 600 and is owned by the ! 132: real user. ! 133: .sh ! 134: Copy "into" works correctly. ! 135: .PS ! 136: The version five "copy into" ignored the ! 137: order of the domains and demanded that ! 138: all domains be present and in the ! 139: identical format as the relation. ! 140: ! 141: The version six copy eliminates all those ! 142: restriction, both on copy into and copy from. ! 143: .sh 1 ! 144: Help ! 145: .dn ! 146: Help on a relation/manual is changed. ! 147: .PS ! 148: We have reversed the use of the help command. ! 149: Relations names should be given without ! 150: quotes ("") and manual sections should ! 151: include them. ! 152: This is consistent with the print command. ! 153: .sh ! 154: Documentation reorganized. ! 155: .PS ! 156: The INGRES documentation has been subdivided ! 157: into quel, unix, files and error sections. ! 158: The help command no longer looks in /usr/man/... ! 159: for documentation. ! 160: .sh 2 ! 161: Help "" changed. ! 162: .PS ! 163: "Help" alone ! 164: now lists relations ! 165: in the database ! 166: instead of the help page ! 167: of the reference manual. ! 168: Help "" ! 169: no longer exists. ! 170: .sh 1 ! 171: Purge ! 172: .dn ! 173: An easy way to clean up a data base ! 174: .PS ! 175: The purge command (formerly resetdb and relkiller) provides ! 176: an easy way to see what relations have expired ! 177: and also to remove any temporary files and ! 178: relations which were left over after a system error. ! 179: .sh 1 ! 180: The Users File. ! 181: .dn ! 182: The users file replaces the authority file ! 183: .PS ! 184: The users file specifies who can use INGRES, ! 185: what data bases the user can use, ! 186: special permissions the user has, ! 187: any default flags the user wants. ! 188: ! 189: The users file can provide some protection to ! 190: a data base but is obviously insufficient. ! 191: What protection it provides was implemented ! 192: only because it was easy to provide and ! 193: somewhat useful. ! 194: .sh 1 ! 195: EQUEL ! 196: .dn ! 197: Recompilation ! 198: .PS ! 199: A version five equel program must ! 200: be preprocessed again and then ! 201: recompiled in order to run on ! 202: a version six data base. ! 203: ! 204: If you run an equel program without ! 205: recompiling you will get ! 206: an error message from INGRES informing ! 207: you to redo your equel program. ! 208: ! 209: If you only recompile and don't first ! 210: run the equel preprocessor, ! 211: you will get an undefined reference ! 212: to "skiptup" at load time. ! 213: ! 214: Again, simply run equel on all ".q" ! 215: files and then recompile your programs. ! 216: .sh ! 217: Retrieving domains ! 218: .PS ! 219: The version five EQUEL allowed you to retrieve a numeric ! 220: domains into a character variable. ! 221: Version six does not allow this directly. ! 222: The ASCII command can be used to perform this ! 223: function. ! 224: .sh ! 225: The debug flag ! 226: .PS ! 227: Version five equel printed the file name and line ! 228: number on an error. ! 229: This required a lot of extra storage at run time. ! 230: Version six equel has a "-d" flag which ! 231: passes file and line information ! 232: on an error. ! 233: Otherwise, the information is not kept. ! 234: .sh 1 ! 235: Miscellaneous. ! 236: .dn ! 237: Relation Names. ! 238: .PS ! 239: Version five relation names appended the users ! 240: UNIX group and user id's to a relation name. ! 241: INGRES user id's are now kept ! 242: in the "users" file and are printing ! 243: characters starting with "aa", "ab", and up. ! 244: .sh ! 245: Running as someone else. ! 246: .PS ! 247: For data base administrators with alter-ego ! 248: problems, INGRES now lets you run as ! 249: someone other than yourself. ! 250: The "-u" flag can be used at the time ! 251: INGRES is invoked to let you run as ! 252: a different user. ! 253: The "-u" flag may also be used ! 254: by the "ingres" user. ! 255: ! 256: The "-u" flag is also available ! 257: in creatdb. ! 258: It may only be used by the "ingres" user ! 259: in this context. ! 260: .sh ! 261: The Blip is Gone. ! 262: .PS ! 263: Version five printed a space followed by a ! 264: backspace, at the start of every query and ! 265: dbu request. ! 266: The "blip" was there for historical reasons ! 267: only and has been removed.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.