007654REV■REVELATION SYSTEM■■REVELATION DOS FILES■■ REV.EXE■ REV.EXE is the executable dos file which starts REVELATION DBMS.■ It is loaded at startup and not refered to again during a Revelation■ sesson. DO NOT CHANGE ANY PART OF THIS FILE, doing so will void your■ warranty and make REVELATION un-runnable!■ ■ ROS00000.000 - SYSOBJ file for REVELATION.■ This file contains the object code needed to run REVELATION. This file■ must be located on the default disk\directory, and must not be on any■ other attached drive\directory.■■ ■ ROS00000.010 - SYSTEM data file for SYSPROG account.■ This files contains information on all account names and passwords for■ system.■■ ROS00001.0x0 - System Verbs data files for REVELATION.■ These files contain compiled R/Basic object code subroutines called■ by REVELATION commands.■ ■ ROS00002.010 - System Help data file for REVELATION Help routine.■ This file contains REVELATION HELP messages.■ ■ ■ ROS10000.000 - VOCabulary dictionary for SYSPROG account.■ This file contains the general default dictionary items.■ ■ ROS10000.0x0 - VOCabulary data files for SYSPROG account.■ These files contain the definitions for the SYSPROG account■ vocabulary commands.■ ■ ROSERROR.000 - ERRORS■ Commands and messages to be shown when particular events happen.■ ■ ROSMEDIA.MAP■ System file which keeps track of which MS-DOS file is associated■ with each Revelation file.■ ■REVELATION FILES ■ An * indicatates that the dos file name is dependent on the application.■■ Account.................. Revelation Filename... Native Filename.....■ ■ GLOBAL ERRORS (Required) ROSERROR.000■ GLOBAL SYSOBJ (Required) ROS00000.000■ GLOBAL VERBS (Required) ROS00001.0x0 *■ GLOBAL HELP ROS00002.010 *■ GLOBAL CN ROSxxxxx.xxx *■■ SYSPROG VOC (a.k.a. MD) ROS10000.0x0 *■ SYSPROG SYSTEM ROS00000.010 *■ SYSPROG LISTS ROS10001.0x0 *■ ■ (Application Account) VOC (Required) *■ (Application Account) RDES (Required) *■ (Application Account) LISTS (Required) *■ (Application Account) SORT-FILE (Required) *■ (Application Account) QFILES *■ (Application Account) FORMS *■ (Application Account) SUBS *■ (Application Account) BP *■ (Application Account) $BP *■ (Application Account) (dictionary and data) *■ (Application Account) (cross references) *■ ■ACCOUNT DESCRIPTION:■■GLOBAL■ Files in this account are automatically attached and made availble to all■ other accounts.■■SYSPROG■ The SYSTEM Operators account. Passwords can only be changed via this■ account.■ ■(Application account)■ Although the SYSPROG account could be used separate accounts should be■ setup for each application. This allows for more complete control of■ the application vocabulary.■ ■FILE DESCRIPTION:■■SYSTEM■ Revelation file of accounts and passwords.■ Each record defines one account, the key is the account name and field 7■ contains the password. Fields 1 through 6 contain nulls.■■ERRORS■ Revelation file of error messages. These records are interpeted to display■ the message. The first character of every line (field) has a meaning.■■SYSOBJ■ The SYStem OBJect file. This file keeps the run time program (RTP) modules.■■VERBS■ This file stores all the R/DESIGN program, the R/BASIC complier and the■ R/LIST complier. This must be on the default drive\directory when you■ enter REV.■ ■HELP■ Stores all the help messages for R/DESIGN, TCL, ED, and the debugger. Can■ also be used to store help messages for screens.■ ■CN■ This file contains R/Basic source code fragments used by GEN to gernate■ R/Basic Source Programs for Screens and Reports. The record BP.ANALYST.NM■ can be changed to contain the programer's name. The record BP.COMPANY.NM■ can be changed to contain the name of the company.■■VOC■ This is the VOCabulary DICTionary and and data files. All commands are■ stored in this file. There must be VOC file on the default drive\directory■ when you enter REV.■■ The format for a VOC record is as follows:■ ■ FIELD 1 FIELD 2 FIELD 3 FIELD 4■ ------- ------- ------- -------■ PCPERFORM (The sentence type in will be executed in DOS)■ ■ RBASIC NULL Filename Program.name■ (The file must have a compiled version with '$Program.name' as ID)■ ■ TCL (Each field contains a TCL command)■ ■ VERBn NULL VERB Program.name■ ■LISTS■ This file is used to save lists of keys formed by SELECT commands.■ SAVE-LIST verb will save a select list under an assigned name.■ The record key is the assigned name, and the value for each field in the■ LISTS record is the key to records in a REV file.■ ■RDES■ This file contains R/DESIGN information. The records contain data for■ screens, menus, reports, updates and cross reference files.■ ■ See Appendix II in Technical Reference for record layouts for Entry Screens,■ Menus, Reports and Udates.■■ The layout for crossreference records is as follows:■ ■ FIELD EXPLANATION EXAMPLE■ ----- ------------- -------■ KEY XR*filename*fieldname XR*PERSONNEL*SSN■■ 01 File where inverts are maintained PERSONNEL.XREF■ 02 Field number where inverts are maintained 1■ ■ 03 Delimiter(s) used to saparate words being inverted SPACE■ 04 Smallest word to invert 4■ 05 Sorting order of inverted keys AL■ 06 Delete Empty invert Y■ ■ 07 File containing additional display information PERSONNEL■ 08 Dictionary names for additional display information NAME:@VM:DIVISION■ ■SORT-FILE■ The SORT-FILE is not used during the sort routine, but is used to determine■ the Disk\Directory on which to build the temporary sort file. For Networks■ a SORT-FILE should be established on the local hard disk to reduce network■ traffic.■ ■QFILES■ This file is used to speed up the logto or attach process. When you logto■ an account or attach a drive REV first reads the ROSMEDIA.MAP and attaches■ all GLOBAL files and files assigned to the active account. Next it attaches■ all the qfiles specified in the file QFILES. If there is no QFILES file REV■ looks in the VOC file for all qfiles to attach.■ ■ The QFILES record key is the new file name, field 1 contains the word 'QFILE'■ field 2 (optional) contains the account name and field 3 contains the■ old filename.■ ■SUBS■ To help to organize your system, I recommend that the source code for all ■ subroutines (R/Basic subroutines and functions) which you develop be stored■ in a file called SUBS.■ ■BP■ I recommend that the source code for all R/Basic programs which you■ develop be stored in a file called BP (basic programs).■ ■$BP■ To minimize the file size for basic routines I recommend that compiled■ R/Basic object code be placed in a file called $BP.■ 00949TEXTEASY.INSTRUCTIONS■TEXTEASY INSTRUCTIONS■■This program is a simple file manager for REVELATION files.■It was published in REVTECH and modified by W.R.WEBBER.■■To use it type TEXTEASY at the TCL prompt then follow the requests for data.■There is no online help so your on your own.■■To execute a command from TEXTEASY, type a '/' followed by the first letter■of the command e.g '/F' will allow you to change files. You can also type the■command parameters on the same line, e.g. '/F XBP' where XBP is the filename.■■The following commands are active:■/C - Create a file.■/E - TEXT edit a record/document.■/F - Change to new file.■/I - Initialize record list.■/P - Print a record/document.■/R - Run a compiled R/BASIC Program. The program name must be the DEFAULT.■/S - Display next screen or /S# - Display screen #.■/ - Use this to execute a TCL command, e.g. "/ LIST VOC".■/[ - Use to change TEXTEASY column width or to display full name.■******00053@DOCNAMES@■LETTER²README²REV²TEXTEASY.INSTRUCTIONS■7201535README■This disk contains the following REV files:■■XBP - R/Basic programs and subroutines.■XRDES - Dictionary fixed and symbolic fields of interest.■XVOC - Dictionary fields of interest.■DOCUMENTS - Documents of general interest.■■The contents of each file is as follows:■XBP - DICT XRDES - Field DICT XVOC - Field■ BIGLIST TYPE F1 ATTRIBUTES G■ COMBINE.LISTS TITLE F2 GROUPS G■ GLOBE MENU.TITLE F2 SYMBOLICS G■ INVERT.LST DESCRIPTION F7 RECORD S■ MENU.LST F12 F12 DATA S■ MODIFY F13 F13■ MSELECT MENU.PROCESS F13■ TEXTEASY F14 F14■ UPPER MENUS G■ XLATEN SCREENS G■ MENUS G■ MENU.FIX S■ ■To access these programs attach disk with REV and use R/TEXT or BUD to read.■■Then type 'RUN XBP TEXTEASY'■■COPY XBP to your favorite program file, eg. BP.■Catalog the programs in file XBP by typeing 'CATALOG XBP *', where XBP is the■file to which you copied these programs.■■Copy dictionary XVOC to VOC by typeing 'COPY DICT XVOC * TO: (DICT VOC'■■Copy DICT XRDES to DICT RDES to transfer dictionary items to resident RDES file■■If you want to save this documentation on your system copy the DOCUMENTS file■to your own documents file.■00213LETTER■You are now in the REVELATION TEXT editor.■■THIS IS THE LETTER RECORD IN THE DOCUMENTS FILE■■Press Ctrl Q to quit, then type the name of another record or■the number of another record to view its contents.■
