Enterprise-Wide Computing, Inc. P. O. Box 931 Dayton, NJ 08810 Email: info@ewc-inc.com URL: http://ewcnet.com Telecommunications Glossary Version 1.1 The self-extracting archive, glossary.exe, contains a complete telecommunications glossary as well as the tools necessary to produce new or amended glossaries. The definitions have been gathered from a wide variety of sources, as with most dictionaries and glossaries. Any use of the definitions is the responsibility of the user, not of Enterprise-Wide Computing, Inc. Every effort has been made to provide valid definitions but no guarantee is made or asserted that the definitions contained in this glossary are correct or will not change. Overview The glossary (all the .htm files contained in this archive) constitutes a demonstration of one way in which database files can be translated to html format for presentation through a web server. The original glossary is maintained in an xBase database consisting of two fields: term and definition. In our glossary database term is a character field 75 characters long. The definition field is a memo field. At periodic intervals the database is exported to a comma-delimited file (telecom.txt). A program contained in this archive (db2htm.exe) is then run against the telecom.txt file to produce a new version of the glossary. All .htm files except related.htm are produced by db2htm. We ask that you retain all copyright notices. Archive Contents The files listed below are those contained in this archive. Additional documentation for these files will be found farther along in this document. Filename Description ============ ============================================== db2htm.exe Database to html translation program. db2htm.cfg db2htm.cfg configuration file (optional). run.bat Batch file to simplify running of db2htm.exe. less.exe A paging program ported from Unix for paging output to stdout. Provided to allow paging of the help information in db2htm.exe: db2htm ~h | less Use spacebar to scroll forward, "b" to scroll back, "q" to quit. ewc2.gif GIF graphics file required for the web displays. lanlogo4.gif GIF graphics file required for the web displays. glossary.tem Template file for the display of definitions. related.htm An html document containing links to other glossaries on the web. smpyr.gif GIF graphics file required for the distributed version of related.htm. *.htm Numerous .htm files produced by db2htm.exe. Operation Glossary Installation The archive is a self-extracting zip file. The default installation directory is c:\db2htm, although that can be changed. After downloading the file, simply execute glossary.exe. All files will be placed in the appropriate directory. If you do not wish to make any changes or add any definitions, simply move all .htm, .html, and .gif files to an appropriate directroy in your document root on your web server. In the file index1.htm you will find the following html code: Return Home
Return Home to
Enterprise-Wide
Computing, Inc.

You may wish to change the references to "ewcnet.com" and "Enterprise-Wide Comuting, Inc." to your own web server address and company name. You may also wish to provide your own company logo to replace lanlog4.gif. These items must be edited by hand. Updating the Glossary If you wish to start updating the glossary yourself, first import the file, telecom.txt, into an appropriate database (dBase, Access, etc.). Add terms and definitions. Be sure the database uses the "term" field as the index field and that the database is sorted in alphabetical order by "term". Export the database to a comma-delimited file, with both fields surrounded by double quotes. When quoting material within a definition, use single quotes rather than double quotes. It might be the better part of valor to backup telecom.txt before exporting your database in case something goes wrong with your export. At a DOS prompt, in the directory in which you installed the glossary (i.e., c:\db2htm), run db2htm. The program parameters (displayed by running db2htm ~h) are as follows: ===================== Syntax Help Message ====================== Enterprise-Wide Computing, Inc. Copyright (c) 1998 by Enterprise-Wide Computing, Inc. For more information write info@ewc-inc.com World-Wide Web: http://ewcnet.com Name: db2htm.exe Purpose: To translate a comma-delimited file, produced as output from a database system, to a set of html files for delivery by a web server. This version of the program is customized specifically for a glossary where each record contains two fields: a glossary "term" and a glossary "definition." Syntax: db2htm [options] Note: the delimiter used for the following options is a tilde (~), not the more common hyphen or slash. Options: ~?|h This help screen printed to stdout. ~f parameterfile If present, this must be the only command line parameter. ~d title Database name used for titling in the html document. ~i inputdbfilespec The filespec defining the location of the database file. The records from the database must be exported to an intermediate, quoted, comma delimited file. ~l linelength The line length to be used for text in the html document. This is unrelated to the way in which a browser outputs lines. This is for the purpose of making the html source document more readable. ~t templatefile The key to how a record looks lies in the html template used as the format for each record. The user must provide the template. ~p path Full path to target db directory. Must include a trailing / or \ depending on whether the target machine is unix or dos based. ============================= END ============================== Options can be placed either on the command line or in a configuration file named db2htm.cfg. If the options are placed in a configuration file, then the command line would consist of: db2htm ~f db2htm.cfg A typical configuration file might be the following: ~d EWC Telecom Dictionary #Title for .htm files ~i telecom.txt #Comma-delimited filename ~l 60 #Line length for text in .htm files ~t glossary.tem #Filename for glossary template ~g ewc2.gif #Filename for Gif in index1.htm The listing of help, above indicates the meaning of each option. Every option used must be preceded by a tilde (~) or an error will occur. The reason for the configuration file option is that the length of a command line is limited (128 characters). It is possible to have a command line longer than 128 characters. Any text following a pound (hash, number, whatever you wish to call it) sign (#) is treated as a comment. You may find it more convenient to use a small batch file, perhaps called "run.bat", to exeute db2htm. A simple batch file is the following which runs db2htm using a configuration file: @echo off rem Syntax: db2htm [options] db2htm ~f db2htm.cfg Also included is an html file that you may modify by hand: related.htm. This contains a list of links to other glossaries on the web. The related.htm file in this distribution was based on another such file found on the web and that is reflected on the page. You can create an entirely new related.htm file using whatever glossaries you might find useful. Conclusion If you have questions concerning this product, address them to info@ewc-inc.com. This archive is provided without cost or fee. Services provided by Enterprise-Wide Computing, Inc. may be reviewed at http://ewcnet.com. The latest version of this glossary may be downloaded from ewcnet.com by clicking on "Database to HTML Demo," then by scrolling down the menu frame to "Download Glossary."