Release Notes 


Digital Matrix Services, Inc.	                        InFoCAD Pro, InFoCAD Desktop, InFoCAD Jr.


InFoCAD FOR WINDOWS NT - VERSION 1.0                                                       RELEASE NOTES / SYSTEM ADMINISTRATOR GUIDE


	
________________________________________________________________________________________
NOTE: This document is the InFoCAD for Windows NT Version 1.0 release notes. It is subject to final review and verification. Neither Digital Matrix Services, Inc. (DMS)  nor any person acting in its behalf makes any warranty, expressed or implied, with respect to the use of any information disclosed in this document. The information in this document is subject to change without notice.

Use of this software is subject to the terms of the software license agreement found in the license.txt file  located in the \infocad\license directory.

InFoCAD Pro, InFoCAD Desktop, and InFoCAD Jr. are trademarks of Digital Matrix Services, Inc. Windows and Windows NT are registered trademarks of the Microsoft Corporation. Other products and companies are trademarks of their respective owners.
________________________________________________________________________________________
		
The evaluation copies of InFoCAD Jr. were packaged for promotional distribution and will cease to function after July 9, 1994. If you have an evaluation copy, you may contact Digital Matrix Services for information on obtaining a non-evaluation copy of InFoCAD.

Please take a moment to to register your copy of InFoCAD by filling out your registration card and sending it to us. This will ensure that you are on  our mailing list and will receive any information on product updates or new DMS products. If, for any reason, you are unable to use the Registration Card provided, you can print out the Registration Card found in the on-line Help by picking the "Registration" icon and then selecting "File" and "Print Topic".  Fax or mail your Registraion to Digital Matrix Services.

		Digital Matrix Services, Inc.
		P.O. Box 520601
		Miami, FL 33152-0601

		Sales:		(305) 445-6100
		Fax:		(305) 442-1823
		Support:	(305) GIS-9940
		BBS:		(305) 529-9303
________________________________________________________________________________________		

This document contains important information on how to install and use your version of InFoCAD. The files README.WRI (WRITE version) and README.TXT (ascii version) are contained on the first setup floppy or CD Rom in a uncompressed format.  It is recommended that you read the following in its entirety prior to installing or using your version of InFoCAD. The word, "InFoCAD" will refer to InFoCAD Pro, InFoCAD Desktop, and InFoCAD Jr. throughout this document, unless otherwise stated.

The data used in the InFoCAD Demonstration files is for demonstrative purposes only, and is therefore not necessarily accurate.




Section 1 - Introduction

This guide is written for the person with overall responsibility for the installation and efficient operation of InFoCAD and its related modules, hereafter referred to as the system administrator. This guide contains the information necessary for the initialization and configuration of InFoCAD to your computer system, covers day-to-day administration of the InFoCAD system, and explains how to establish and maintain an InFoCAD security policy.

The system administrator must have a good understanding of the Windows NT operating system and its basic concepts and commands. This guide provides step-by-step instructions on how to install and initialize InFoCAD, however, it does not explain basic Windows NT concepts or Windows NT security. 

Before you attempt any of the procedures outlined herein, read and familiarize yourself with the entire guide.


Section 1 - Introduction 
Section 2 - System Requirements
Section 3 - InFoCAD Installation and Initialization
Section 4 - Authorization
Section 5 - Security and Administration
Section 6 - Digitizers/Plotters
Section 7 - Utilities
Section 8 - Using InFoCAD
Section 9 - Modification Notes
Appendix - Distribution Files



Section 2 - System Requirements

In addition to the system requirements for running Windows NT, InFoCAD requires the following:

Software: Windows NT for Intel-based 386 and above CPU's

Hard Drive Space Requirements:
		InFoCAD Only			35 MB
		InFoCAD and Demo Files	65 MB

Total Virtual Memory:
	      System RAM
		InFoCAD Pro			32 MB
		InFoCAD Desktop		32 MB
		InFoCAD Jr.			24 MB
	      Paging File - All Products		80 MB

Display: 1024 X 768 resolution with 256 colors

These are the absolute  MINIMUMS for the operation of InFoCAD. As a general rule, you will see an improvement in InFoCAD's performance in terms of both speed and efficiency if you increase the amount of System RAM.  Increasing the size of the Paging File will increase the amount of Virtual Memory, but it should not be considered a substitute for System RAM.

These parameters are the preliminary assessments for this version of InFoCAD. Later versions may have differing parameters as the system is optimized.



2.1 Virtual Memory: Paging File

Virtual Memory is the amount of system RAM and the size of your Paging File added together. InFoCAD Pro, InFoCAD Desktop, and InFoCAD Jr. will each need a minimum 100 MB of virtual memory. The following are examples of minimum paging file requirements.

24 MB RAM will need (100 MB Virtual Memory - 24 MB RAM = 76 MB page file)
32 MB RAM will need (100 MB Virtual Memory - 32 MB RAM = 68 MB page file)



Using Images with InFoCAD

If you plan to use InFoIMAGE, you will need to allocate more Virtual Memory. The amount of Virtual Memory needed depends on the amount and size of the images displayed. The following formula will estimate the amount of extra Virtual Memory needed.

		(Number of images) x (((width x height of image)(DPI x DPI)) / (1024 x 1024))

For example: Using 4 images @ 8.5 x 11 each, 256 color (8 bit),  scanned in at 300 dpi, the formula would work out  as follows. 

		4(((8.5 x 11)(300 x 300)) / (1024 x 1024))
		4(8.03) = 32 MB extra Virtual Memory needed for 4 images


Using Virtual Pan or Virtual List

When using the VPAN or VLIST command, InFoCAD will require considerably more Virtual Memory. When using one of these commands, you must select a size for your virtual screen. Size [9] is the smallest, and [25] is the largest. You must increase the memory by 10 MB for a size [9] screen. A size [25] screen will require 28 additional MB of memory. For example, if you have 100 MB of Virtual Memory, you must increase the amount of Virtual Memory to at least 128 MB to use a size [25] virtual screen.


Changing the Paging File Size

The size of the paging file can be easily changed in Windows NT using the following steps:

1. In the "Main" group window of the Program Manager, double-click on Control Panel.
2. In the Control Panel, double-click on System.
3. In the System group window, click on Virtual Memory.
4. In the Virtual Memory window, you can set the Initial and Maximum size of the paging file.  An initial size of 20 MB and maximum size of 100 MB will be adequate for most installations. Also note that the paging file can be split easily across drives on your computer.
5. For the modification of the Page File Size to take effect, you MUST Shutdown and reboot your system.




Section 3 - Installation and Initialization

3.1 Installation Procedure

For proper Installation of InFoCAD, we recommend that you have a minimum of 145 MB of free hard drive space.  The InFoCAD product will take 35 MB of hard drive space, its Demo files will take an additional 30 MB.  The amount of Virtual Memory will also need to be a minimum of 100 MB  (See Section 2.1 for more detailson Virtual Memory).

In order to install InFoCAD, you must execute the SETUP.EXE file found on the Installation Floppy Disk #1 or in the InFoCAD directory on the CD Rom. InFoCAD Pro and InFoCAD Desktop require a Hardware Key for product authorizations.  This Key must be installed before running SETUP.EXE.   InFoCAD will install itself on your PC, automatically creating the required directories for InFoCAD Pro, InFoCAD Desktop, or InFoCAD Jr.  You will then need to follow the restart options in Step 10 for the Installation changes to take effect.
	
The Installation Steps are as follows.
	
1. Insert Disk #1 into the floppy disk drive or have the CD Rom drive active.

2. Use one of the following methods to initiate the installation form inside Windows NT: 
	1) At the Command Prompt, type x:setup. (where x: is your floppy drive letter or CD drive letter)
		2) Using the File Manager, double-click on disk drive x: then double-click on SETUP.EXE 
3) From the Program Manager, select the File pull-down menu. Select Run.  In the Run Window, use the Browse option, or type x:setup in the Command Line.

3. Next a window will inform you that InFoCAD is Initializing the Setup...

4. The Welcome window appears, offering you the options of continuing the installation, exiting, or receiving help on how to use the installation routine.

5. Choosing [Continue] will continue the installation process by bringing up the Installation Option window.  Select the InFoCAD product you wish to install (InFoCAD Pro, InFoCAD Desktop, InFoCAD Jr.).

6. You can install only InFoCAD, or you may choose to install both InFoCAD and its Demo Files. 

7. Either option causes the Installation Path window to appear. You may select a drive and directory on which to install InFoCAD, or simply click on [Continue] to accept the default C:\INFOCAD.

8. Once you have chosen a path, InFoCAD begins to install. When InFoCAD finishes installing the first disk, a window prompts you to insert the second disk. Click on the OK button when you have inserted disk #2. Repeat this procedure until you have installed the last disk.  
   		Note: If you are installing from a CD, you will not be prompted for any disks.

9. When the Installation is complete you will receive a message stating that your setup succeeded.  

10. The next window that appears explains some very important information.  DO NOT IGNORE the information displayed in this last window.  The following is a more descriptive version of what shows up in the final Installation Window.

Virtual Memory: Paging File Size
For InFoCAD to run properly, it is very important that you have a minimum of 100 MB of Virtual Memory.  Please refer to Section 2.1 in this document for step by step instructions on how to modify your Paging File Size.  If you need to modify your paging file, please follow the steps in Section 2.1 now.  When you have finished, you must Shutdown and Reboot your computer.

AUTOEXEC.BAT 
The InFoCAD Installation has modified your systems AUTOEXEC.BAT file.  A copy of your original AUTOEXEC.BAT file has been copied to AUTOEXEC.OLD.  The modifications that have taken place are as follows:
		The PATH statement has been modified to include the new InFoCAD directory.
		The System Variable INFOCAD has been set to the new InFoCAD directory.
 If you do NOT need to change your Paging File Size and are only running InFoCAD Jr. then you MUST logoff of Windows NT and then log back in to Windows NT.  The preceding is described in more detail in Section 3.3.

InFoCAD Pro and InFoCAD Desktop
All installations of InFoCAD Pro and InFoCAD Desktop use a Hardware Key for  product authorizations.  You MUST reboot your computer to allow the Hardware Key to initialize.

11. Now that you have again Logged in to Windows NT, you will notice that there is a new InFoCAD(Common) group window.  In this window you will see an InFoCAD Icon and a Release Notes Icon.  The Release Notes Icon will bring up this file in the "WRITE" editor. The  InFoCAD Icon will initate InFoCAD.

12. Please double-click on the InFoCAD Icon.

13. After the InFoCAD Login Window has loaded, you will notice that the default Login name is "DEMO". You can click "OK" to enter InFoCAD (there is NO password for user DEMO)

The "DEMO" login name is intended for the user to run through the InFoCAD Tutorial or the InFoCAD Demo Script.  To execute the demo do the following:  In the upper right hand corner of the InFoCAD window click on "Help".  In this pull-down menu, click on "Contents", now click on the "Getting Started in InFoCAD" icon.  In the next screen click on the "InFoCAD Tutorial" icon or the "InFoCAD Demo Script" icon.

NOTE:  If you do NOT plan to follow  the "InFoCAD Demo Script" at this time then you should follow step 14 and add users to the profile.  If you have logged in as "DEMO" and want to work with different Libraries then you will need to turn off the backgound images.  From the "Utility" pull-down menu select "Image".  In the Image panel, click on the numbers 1,2, & 3 to the left of the image names to turn off their display mode.14. At this time the System Admistrator can also modify the User Profile.  Please see section 3.2 for information on the InFoCAD Profile.  Once you have added users in Profile you can log into InFoCAD with any of the new user names.

Note:
If the InFoCAD Installation did not install the software properly you will get a Warning Message window telling you to try the Installation again or to Call DMS Technical Support at (305) GIS-9940.



3.2 The InFoCAD Profile

The InFoCAD profile utility is used to add users to InFoCAD. This phase of the initialization process is outlined below. The profile is the highest level of InFoCAD security and accomplishes the following:

	-	Adds a user name and password.
 
	-	Assigns a UIC (User Identification Code) to a user name, that is, a Group Number 			            and User Number. Different user names may be assigned identical UICs since they 			            are distinguished by the user name. 

	-	Indicates whether a specific user is a Group Manager.
 
	-	Assigns user access to commands by type, that is, whether the user has access to 			            CAD, GIS, and/or DB commands. 

	-	Assigns Read/Write privileges to the user name for each of the 999 layers within 			            InFoCAD. 

For a discussion on InFoCAD security, please refer to the Section 5 of this guide.

To access the profile utility, you must select the Options button on the login screen. This pulls down the Options menu. Select the User Profile option to run the profile utility.

Only an InFoCAD manager may enter the profile utility. The User Profile - Manager Login window appears, allowing you to enter the user name and the password. Enter "system" in the user name area, and "manager" in the password area.  Only the SYSTEM manager can change the SYSTEM's password.

Note: You may type "demo" at the user name. This should only be used to access the "Demo" script. If you intend to work in InFoCAD, you should log in with your regular user name. You may add a new user name by following the steps discussed below. The UIC for "Demo" is [2,1], and you will be able to access all layers, all views, and all permissions (CAD, DB, and GIS).
 
After you enter the user name and password, the InFoCAD Profile main window appears listing all of the currently defined user names. This window also lists the group number, user number, and whether or not the user is a group manager.

The three buttons at the right of the main window allow you to add a user name, modify the permissions of an existing user name, or delete a user name. Selecting [Add] brings up the "Add a User" window. This window allows you to enter a new user name and assign a password to that user name. You may use this window to assign the UIC numbers as well. 

The Privileges section of this window allows you to assign user access to commands by type. You can choose to give the user access to CAD, DB, and/or GIS commands.

Also within the "Add a User" window, you can set the new user's read/write permissions for each layer. Choosing [Set] within the Privileges section makes this possible. Select one or more users and the Modify button from the main InFoCAD Profile window to modify the permissions for your chosen existing user(s). The "Modify a User" window appears, containing all the same components as the "Add a User" window. You can simply adjust the password, UIC numbers, or the privileges for the user(s).

To delete one or more user name(s), select the user(s) you wish to delete along with the Delete button at the main InFoCAD Profile window. Another window appears and asks you to confirm or cancel the deletion. Along the bottom of the main window, two more buttons are available. [Login] logs you in to InFoCAD, and [Exit] takes you back to the initial Login screen.



3.3 InFoCAD Environment


Profile: INFO_PRO.SAM

The profile utility stores its information in a file named INFO_PRO.SAM. The location of this file is controlled in three ways:

1) InFoCAD will first search the INFOCAD.INI file for the heading [User File Paths]. Under this heading the user can add the line USER_DATABASE=drive:\path  Where drive:\path points to the directory where INFO_PRO.SAM is to be stored.  The following is an example:
		[User File Paths]
		USER_DATABASE=c:\infocad

2) If the user has not entered the previous lines in the INFOCAD.INI file, then InFoCAD will look for the System Environment Variable "INFOCAD". This variable may be set to direct InFoCAD to the location of the INFO_PRO.SAM file. For information on setting this variable, please see the section below labeled "INFOCAD System Variable"

3) If neither of the two methods above have been followed, then InFoCAD will look in the current directory for the INFO_PRO.SAM file. If it does not exist, INFO_PRO.SAM will be created in the current directory.


INFOCAD.INI

The INFOCAD.INI file stores many different settings for InFoCAD. Two of the settings are the location of the INFO_PRO.SAM and the directory to store "username".INI files. The location of the INFOCAD.INI file is controlled by the INFOCAD System Variable. If the INFOCAD System Variable is not set, InFoCAD will search the current directory for the INFOCAD.INI file. If it does not exist, it will be created in the current directory. The preceding section, "Profile: INFO_PRO.SAM," explains how to add the path for INFO_PRO.SAM. The same technique is used to add the path for the different users of InFoCAD. The following section explains the "username".INI file.


"USERNAME".INI

Every user in InFoCAD will have a "username".INI file on the system. As you may already know, you must add names in the profile utility to allow someone to log in to InFoCAD. When a person named John logs in to InFoCAD for the first time, a file called JOHN.INI will be created. Where this file is created is controlled by the following:

	1) In the INFOCAD.INI file under the heading [User File Paths] you can specify a Path for the different users "username".INI file. The following is an example:
			[User File Paths]
			USER_DATABASE=c:\infocad   (Note: For INFO_PRO.SAM only,  See above)
			JOHN=c:\infocad\users\surveying
			MIKE=c:\infocad\users\drafting
		As you can see, different paths may be specified for the location of the "username".INI files. 
		
	2) It is also possible to store all the "username".INI files in one common location. This is done by setting the System Variable "INFOCAD". If you do not set the user paths in the INFOCAD.INI file, InFoCAD will search for the INFOCAD System Variable. If found, it will create and store the "username".INI files there. (See below for setting INFOCAD variable)

	3) If the INFOCAD System Variable is not set, InFoCAD will look only in the current directory for the "username".INI files. If one does not exist, it will be created in the current directory.  This however, may cause InFoCAD to appear to act inconsistently.  It is possible that every different working directory on your system could have a different "username".INI file.  It would be beneficial for you to set your INFOCAD System Variable to a common subdirectory.


INFOCAD System Variable

The INFOCAD System Variable is used to direct InFoCAD to the directory where INFO_PRO.SAM, INFOCAD.INI, and the "username".INI files exist.  The variable can be set in two different ways.

The first method is local to the Windows NT user.
	
	1) In the Program Manager, double-click on Control Panel found in the "Main" group window.
	2) In the Control Panel double-click on System.
	3) In the System group window, you can modify or add User Environment Variables.

Please note that setting variables in this manner only affects the currently logged in user's environment.  Also note that a Windows NT log in name is different than an InFoCAD log in and that they do not affect each other.

The second method is global to the Windows NT environment.
	
	1) Using any ASCII text editor you can edit the AUTOEXEC.BAT file located in C:\ on your PC.
	2)  Add or modify the following line:
		set INFOCAD={drive:\path}      (example: set INFOCAD=c:\infocad)

PATH Statement

If you plan to execute InFoCAD from a Command Prompt from any subdirectory on your system, then you must have the InFoCAD directory in the PATH statement.  This can be accomplished by editing the AUTOEXEC.BAT file located in the root directory of the C:\ drive.  The following is an example of how a PATH statement might appear.
		
		PATH=c:\dos;c:\windows\system32;c:\infocad;

Please note:  For any of the preceeding modiifications to take affect, you must log off the system and then log back in to Windows NT.

3.4 INFOINIT.EXE 

If you are using a licensed copy of InFoCAD , you must run infoinit, which is used to initialize InFoCAD and to configure your pen plotter for use by our InFoPLOT utility. If you are running the InFoCAD Jr. Evaluation copy,  INFOINIT.EXE is only needed to change plotter configurations.  This utility should only be executed by the system administrator and is outlined below:

From a Command Prompt in the InFoCAD directory, type the following:

		infoinit

The infoinit utility prompts you for your customer number as follows:

		Please Enter Your Customer Number:

Note: If you are using an evaluation copy of InFoCAD, you will not be prompted for this number.
Enter your customer number which is found in your documentation.  You are then prompted as follows:

			INFOCAD Pen Plotter Configuration
				    Version 1.0

			Pen Plotter Type:

			0. No Pen Plotter (use for Ink Jet and Electrostatic plotters)<default>
			1. Hewlett-Packard 7580B, 7585B
			2. Hewlett-Packard 7475A
			3. Hewlett-Packard 7580A, 7585A
			4. Calcomp 906, 907, and 1000 Series
			5. Houston Instruments DMP 40, 29
			6. Houston Instruments DMP 50, 51, 52, 56, 161, 162

			Enter Number:

Select the appropriate pen plotter type by number and enter it at the above prompt. Selecting 0 terminates this routine, otherwise the prompt shown below appears, asking to which port the plotter is attached:

			Enter PORT for Plotter:

Please enter the appropriate port to which your plotter is connected. For example, use
COM1 or COM2

Once you have selected a plotter type, InFoINIT terminates and exits you to the Command Prompt.
 
Note:The above menu configures Digital Matrix Services' InFoPLOT routine, which is designed to send plot files to pen plotters only. If you are using a device other than a pen plotter, select option 0. 

You will be able to plot to non-pen plotters using Digital Matrix Services' HPGLCONV.EXE  routine. Information on InFoPLOT and HPGLCONV.EXE is located in the Utilities section (Section 7) of this guide.

The InFoINIT routine creates a file called CADFONTS.SAV in the directory in which you execute INFOINIT.EXE.  If you plan to use INFOPLOT.EXE in any directory other than the InFoCAD program directory, then you must first run INFOINIT.EXE in that working directory.



Section 4 - Authorization

4.1 InFoCAD Jr.

InFoCAD Jr. does not need to be authorized. Both InFoCAD and InFoIMAGE are authorized to run without any security features.


4.2 InFoCAD Pro and InFoCAD Desktop

InFoCAD Pro and InFoCAD Desktop are protected by a hardware lock. The hardware lock software is installed during the installation of InFoCAD (If the hardware lock has been installed properly, InFoCAD will run without the need for authorization codes). Authorization is required for InFoIMAGE. The first time you access the Image command, you will need to authorize it. You will be prompted to enter one authorization code.

Please fax or call DMS's Technical Support (305-GIS-9940) for your authorization code. DMS cannot provide user authorization codes to customers until the proper license agreements are signed and on file at our headquarters in Miami, Florida. User authorization codes may be given over the telephone, or you may have your code faxed to you within 24 hours after you request it.




Section 5 - Security and Administration

5.1 InFoCAD Security

InFoCAD's security system operates by assigning user names, passwords, User Identification Codes (UICs), and assigning layer and command access rights to each InFoCAD user. The system administrator assigns the user names, passwords, UICs, and access rights using the profile utility, which is the highest level of security. Two or more users may have the same UIC, but must have different user names. 

The UIC, or User Identification Code, consists of two numbers. The first number of the UIC indicates the GROUP to which the user belongs, and the second is the user or OWNER number. GROUP numbers can range from 2-999 and OWNER numbers range from 1-999. Only the system administrator can have GROUP number of 1, or the UIC of [1,1].

When InFoCAD is first installed, only the system administrator has a user name, password and access rights. The system administrator's UIC of [1,1], which cannot ever be changed, gives him or her permission to do everything within InFoCAD. That is, all security features are overridden when the system administrator logs in. Also, there are certain administrative commands that are discussed under Database Management found later in this section, that can be executed only by the system administrator. In any case, a user must have a user name in order to enter InFoCAD. 

Once the system administrator creates user names, InFoCAD recognizes users by their log in, which is made up of the user name, password (optional), and the UIC. Once inside InFoCAD, CAD, DB, or GIS command permissions and layer access (as set in the profile) have priority over any file-level permissions. 

The next level of permission is at the file level and it involves the concept of file ownership. Users are owners of the files they create, i.e. Libraries and databases. Ownership is determined by the UIC only. The owner of a Library and/or database must assign read and write access privileges for the WORLD, GROUP, and OWNER (him or herself) at the time a Library and/or database is created. Then, any user with the same UIC as the file creator is considered to be the owner of the file.

The files' read/write permissions determine the type of commands that other users may execute on them, and even whether a user can open a file. When a user without proper permission attempts to access a file, an error message appears at the top of the InFoCAD screen informing the user that he or she is unauthorized.  It also indicates what the current user's UIC is and what UIC a user would need in order to access the file. 

Remember that the profile also determines if a user has CAD, GIS, and/or DB command privileges, therefore, even if you have full file-level permission, you cannot view, modify, or even open a database if you do not have DB privileges. Again, an error message appears, informing you of the security violation. 

WARNING! The simultaneous user capability is NOT available in the current release of InFoCAD. No more than one user should access the same Library at the same time. Multiple users could corrupt the Library. 


5.2 The Data Dictionary

In addition to the file and command security features discussed previously, InFoCAD is equipped with a Data Dictionary. The Data Dictionary stores all of the Special Definition File (SDFs) and cannot be accessed by anyone without InFoCAD permissions. In addition, the data file (SAM) may be encrypted at the time the file is created to guarantee data security. An encrypted file cannot be viewed using a text editor, so only users with permission can access it. The original SDF file may then be deleted from the directory without loss of functionality of the database.

The Data Dictionary is controlled by a utility accessed by the [DICT] command, which is located in the DB Module. The commands in this utility may only be executed by users with DB privileges, and the files are further restricted by the read/write access permissions. Therefore, only the owner(s) of the database or the system administrator may view an encrypted database, export the SDF file, delete the database, etc. and only those users granted read and/or write access permission may open and/or modify the database file and records. Some commands involve administration and are therefore available only to the system administrator. For example, only the system administrator may execute the [CREATE] command which creates a Data Dictionary.

In addition to the read/write access permissions, the owner of a database (or system administrator) may selectively mask any of the 16 views that can be defined in a database. Databases and views are discussed in the DB Module section of the on-line Help and in the InFoCAD overview section of the Getting Started with InFoCAD Module. When the owner is creating the database and indicating the read/write access permissions for the WORLD, GROUP, and OWNER, the view mask for each of the 16 views must also be indicated. This is done by selecting a 1 or a 0 for each view, where 1 specifies that the view can be seen and the 0 specifies that it cannot.

Note: The read/write permissions for the WORLD, GROUP and OWNER override the view mask, therefore, the view mask acts as a secondary protection for each of the 16 views. 
For example:

		WORLD 	[ - - ] 	1111111111111111
		GROUP 	[RW] 	0011111111111111
		OWNER 	[RW] 	1111111111111111

In the above example, the WORLD does not have permission to read the database, therefore, even though it technically has permission to see all the views, the WORLD cannot even open the database. All users in the GROUP may open and modify the database, however, the first two views are masked and cannot be seen by any users in the group except those that have the same UIC as the owner. 

As a final note, the system administrator may create as many Data Dictionaries as is desired; the Data Dictionary is automatically placed in the current directory where the Library resides, which is not necessarily the directory from which InFoCAD is running. 



5.3 Installing the Data Dictionary

WARNING! The system administrator must be very careful when creating more than one Data Dictionary. If a Data Dictionary is overwritten, all the SDF data is lost. The system administrator can, however, import all the SDF files back into the new dictionary assuming that they still exist.  Another consideration is that InFoCAD will access the first Data Dictionary encountered in the user's path when a dictionary command is selected. Therefore, if more than one Data Dictionary is present, the system administrator must be certain that all paths are set correctly in order to access the desired Data Dictionary.

Installing The Data Dictionary

To install the Data Dictionary follow the four steps outlined below:

1. Log in to InFoCAD as the system administrator. 
2. Open or create a new Library in the directory where you want the dictionary created. 
3. From the DB side menu or DB pull-down menu, select the [DICTionary] command. 
4. A bank of commands appears from which you may select the [CREATE] command. This command will create the Data Dictionary in your current directory.



5.4 Database Management

InFoCAD database management involves four subjects: Database Journals, Database File Encryption, Optimizing Files, and Recovering Files. 

Database Journals

InFoCAD has been equipped with a journal feature that keeps track of all database transactions. When used, this feature allows you to recover to previous InFoCAD sessions. The journal is a file that is updated whenever a database transaction occurs. Each open, close, modify, delete, and/or store procedure is automatically stamped with the date, time, and user name. Therefore, the database may be rolled back to any open procedure for any or all user names. The journal stamps every transaction, so you will most likely experience a cut in InFoCAD's performance. 

The journal feature is optional and is controlled by a flag in the [JOURNAL] line in the SDF file. The [BUILD DB] command allows you to turn the journal flag ON (the default is OFF), or may be modified directly in the SDF file using the [MODIFY] option of the [Dictionary] command.

When using a journal, it is important to keep track of the file size of the journal for performance and maintenance reasons. Journal files should be backed up and erased periodically. The steps for journal maintenance are described below:
	
		Make sure that no users are on the system. This may be accomplished by selecting 				the [USED] command inside of the UTIL Module. If there are users on the system, 				make sure that no users are working with the desired database.

		Backup the journal file, label the tape with the date, and store safely. The file will 				have the same name as the database with a JOU extension.

		Delete the journal file so that a new one is created. You will need to check the SDF 				file, making sure the [JOURNAL] line has the parameter ON so a new journal file is 				created. If you need to turn the [JOURNAL] parameter ON, you will need to use the 				[MODIFY] option of the [Dictionary] command.

The subject of recovering from a corrupted database is covered in the following discussion, and the subject of rolling back a database is covered in the on-line Help under the DB Module.


Database File Encryption

InFoCAD has the ability to encrypt the database SAM files. Database SAM files are binary files with ASCII data that, unless encrypted, may be read by any user who has read/write permission on your data set directory.

Encryption is optional and is controlled by whether or not the [ENCRYPT] line is included in the database's SDF file. If you include the [ENCRYPT] line in the SDF file as it is being created, the corresponding SAM file will be encoded using a special algorithm that will not allow it to be viewed using a text editor. 

You may encrypt your SAM file anytime after it is created by using the [MODIFY] option of the [Dictionary] command and adding the line [ENCRYPT]. Encryption slows down database transactions by approximately 10%. 


Optimizing Files

When the records of a database are deleted, InFoCAD leaves blank lines in the database file. After many transactions have taken place, a file may contain numerous blank lines, which causes overhead on the system whenever a search takes place. InFoCAD has two utilities that may be used to optimize database files. Both of these utilities perform the same function: eliminate holes in the file and reset the pointers. The results of optimization on an inverted tree structure allow InFoCAD to randomly access any record from a 1,000,000 record database in less than nine passes using the KEY field. This will drastically increase InFoCAD's performance for large files. The OPT option of the [DB UTIL] command and the external infopack command may be used to optimize a database file. Previously saved record collections from newly optimized databases are no longer valid.

You should also optimize the Data Dictionary from time to time. After numerous transactions, InFoCAD loses time traversing files whenever a command that relates to a database is executed. The [OPTIMIZE DICT] command may be used to eliminate holes and reset the pointers in the Data Dictionary.


Recovering Files

Library files that have been damaged may sometimes be fixed by exporting the Library files using the [DAF OUT] command and then importing the files back in to a new Library using the [DAF IN] command. The DAF translators are accessed using the TRANSLATE Menu. Translators are discussed in detail in the on-line Help  under Translators.  Another method is to make a [GROUP] of all the segments in the problem Library, and then [BLOCK] them into a new Libraray.

Database files that have been damaged may sometimes be fixed by resetting the pointers. This can be accomplished by using the optimize or recover features of the [Utilities] command, as described above. Another method is to export the database to an ASCII file, [REMOVE] and [ADD] the database SAM file, and then import the records back into the new database.  Previously saved collections from optimized or recovered databases are no longer valid.




5.5 Backup Procedures

Digital Matrix Services, Inc. recommends that you use a systematic backup procedure that will allow you to recover from any data loss that could cost your company time and money. 

Backup procedures range from a full daily backup of your machine to the standard ten tape procedure that allows you to retrieve data from three months back. The ten tape procedure uses 4 tapes labelled "Monday" through "Thursday", 3 tapes labeled "Friday X" where X equals 1 to 3, and 3 tapes labeled "Month X" where X equals 1 to 3. 

On Fridays, the whole system is backed up. On Monday through Thursday, only data with transactions are backed up. Every fourth Friday, a tape labelled "Month" is used and the entire system is backed up. 

This standard ten tape procedure is optimal because it is less intensive than backing up the entire system everyday, and allows you to go back three months in time. 

In addition to the procedure described above, archive tapes should be made monthly and stored in a safe place away from the location of the computers. Three or four of these archive tapes should be rotated as necessary and will allow recovery in case of damage. 

At the very least, the following files should be backed up on a regular basis:

-		InFoCAD profiles should be backed up every time a user is added to the system.

-		The Data Dictionary file INFO_DICT.SAM should be backed up weekly at a minimum.

Any files that are used frequently should be backed up regularly.




Section 6 - Digitizers/Plotters

This section covers the installation and configuration of devices such as digitizers and plotters. There is one important rule to follow:

InFoCAD requires that devices be connected to serial or parallel ports on the local machine.



6.1 Digitizer Installation

The digitizer, regardless of brand or style, must be connected to a serial port on the host machine via the RS232 cable that was supplied from the vendor. The port must be then be set up according to the parameters of the digitizer (i.e. parity, baud rate, format, etc...). 

After the digitizer has been configured, you may initialize InFoCAD to use the digitizer. This is done from inside InFoCAD using the [CONFIGURE] option of the [DIG SET] command. The Digitizing portion of the on-line Help provides detailed information on how to set up and calibrate the digitizer, and digitize in the InFoCAD environment.


6.2 Digitizer Configurations

The digitizer must first be connected to the computer. If the cable provided with your digitizer does not work, refer to the chart in Section 6.3.  Once the digitizer is properly connected, the digitizer itself must be configured. After the digitizer is configured, it can be tested before actually configuring it inside of InFoCAD.  Refer to Section 7 in this document.

Below are the values to which your digitizer must be configured. Set the switch blocks on your digitizer according to the information given below (refer to your digitizer's operating manual if there are any questions regarding a particular setting). 


Calcomp Digitizer Settings
Digitizer: 	Calcomp 2300 Series			Calcomp 9100 Series

Mode = Run					Mode = Run
Data Bits  = 8					Data Bits = 8
Parity = None					Parity = None
Baud Rate = 9600				Baud Rate = 9600
Format = Calcomp 2000 Ascii			Format = Calcomp 9100 Ascii (Format 1)
Line Feed = Off			           		Line Feed = Off
Data Rate = 20 pps				Data Rate = 20 pps
Resolution = 1000 lpi				Resolution = 1000 lpi
Frequency = On				Frequency = On


Calcomp Switch Settings
Calcomp Drawing Board (2300 series)

		
		Mode
		Point = Off      Run = On      Track = Off      Mouse = Off      Prompt = Off

		Parity
		7/8 = On      1 = On      2 = Off      3 = Off

		Baud Rate
		1 = Off      2 = Off      3 = On

		Format
		1 = Off      2 = Off      3 = On      4 = Off      LF = Off

		Data Rate
		1 = Off      2 = On     3 = On

		Resolution
		1 = On      2 = On      3 = Off

		Frequency
		1 = On


Calcomp Drawing Board (9100 series) 

Same as above (2300 Series), except change Format as shown below
		Format
		1 = On       2 = On       3 = Off      4 = Off      LF = Off




Calcomp 9100 48x36 Lighted Table
Configure the Switches as follows:

SW1
1 = On   2 = Off   3 = Off   4 = Off   5 = On   6 = On   7 = On   8 = Off

SW2
1 = On   2 = Off   3 = On   4 = Off   5 = On   6 = Off   7 = Off   8 = Off

SB2
1 = Off   2 = Off   3 = On   4 = On   5 = On   6 = On   7 = Off   8 = On




6.3 Digitizer Cable Configurations

You should use the standard cable that was provided with your digitizer. If you want to extend the provided cable, then you should use a standard RS232 cable. InFoCAD, on ALL platforms, requires the following pin configuration:

Computer	Digitizer

2_______________ 2
3_______________ 3
7_______________ 7




6.4 Plotter Installation

The procedure for installing a plotter is similar to the procedure for installing a digitizer. The plotter, regardless of the brand or style, must be connected to a serial or parallel port on the host machine via an RS232 cable for serial connections or parallel cable for printer port connections. The port must then be set up according to the parameters of the plotter (i.e. parity, baud rate, etc.). 




6.5 Plotter Configurations

Once the port has been set up, you must configure InFoCAD to the desired pen plotter. This is accomplished from outside InFoCAD using the InFoINIT program. Refer to the discussion on InFoINIT in section 3.4 of this document for information on initializing InFoCAD to use pen plotters.

IMPORTANT: Electrostatics, Ink Jets, and Thermal Plotters
InFoINIT is used to configure a pen plotter, and InFoPLOT is used to send the plot file to the plotter. If you do not have a pen plotter, you do not need to run InFoINIT. Plot files may be converted using HPGLCONV.EXE and then sent to the plotting device using a simple Copy command.

Plot files can be created using the PLOT command or the Thematic Mapping utility from inside InFoCAD.   They must, however, be sent to your plotting device either through InFoPLOT, HPGLCONV.EXE, or other third party Plotting Utilities.   Refer to the on-line Help for information on creating plot files. 




6.6 Plotter Cable Configurations

Serial Connections using InFoPLOT

		Computer	Plotter

		2 ______________ 3
		3 ______________ 2
		7 ______________ 7

NOTE: You can customize a wire or use a regular RS232 cable and put a null modem in-line. 


Parallel Connections using HPGLCONV.EXE
	
    Use a standard Parallel Cable






Section 7 - Utilities

Along with the numerous commands and options contained in InFoCAD, the distribution includes several utilities that can be executed in the Windows NT environment. These utilities perform a variety of functions ranging from optimizing portions of InFoCAD Libraries to checking the current configuration status. For additional information, refer to the appropriate section of the on-line Help. 


CALTEST.EXE

The caltest utility is used to the check communications between a Calcomp digitizer and InFoCAD. Executing this utility causes the following series of prompts to appear:

InFoCAD Calcomp Digitizer Test 8.0
Digitizer: (1) Calcomp 9100 (2) Calcomp 2300
Enter tty port: (i.e. com1):

If the communications are functioning, you will begin to get the input from the digitizer. If the communications are not functioning, you will get an error.


FONTDUMP

The fontdump utility allows you to import or export InFoCAD custom fonts created using the [FONTGEN] command in the UTIL Module. This utility takes fonts in the custom InFoCAD format and converts them into a standard ASCII file and vice versa. When importing font files, you must execute this utility in the directory where the font files are located. Typing fontdump at the Command Prompt causes the following prompts to appear:

Font Import/Export Utility Version 8.0
Fontdump: 1=Import   2=Export   3=Exit>

You may enter the number corresponding to the desired operation. Selecting either the Import or Export option causes the utility to prompt you for the font file name, as shown below:

Enter Font file name:

Entering a file name (with extension .FNT) causes the utility to perform the desired operation. You are now in a command loop and the utility returns to the initial Fontdump: command extension. You can cancel out of the utility by entering 3 or Exit at the Fontdump: command extension prompt or at any point with Ctrl-C (Control C) or the equivalent command on your system.

IMPORTANT: The fontdump utility stores the exported fonts in a file named FONT.DUMP. If you execute the utility again, the utility will overwrite the original FONT.DUMP file. Therefore, when exporting more than one font, you must copy each exported font into a new file with a different file name prior to exporting the next font.


HPGLCONV

The hpglconv utility is used to convert an InFoCAD plot file to HPGL or HPGL II format. This utility is discussed in detail under the PLOT command in the on-line Help.  Please note that once the Plot file has been converted, you can send it to your plotter by copying the file to your port. 
(in a Command Prompt: copy OUTPUT.HPG lpt1)


InFoPLOT

The InFoPLOT utility is used to send InFoCAD plot files to the initialized plotter. By using an external program to send files to a plotter, users may work in InFoCAD while files are being plotted. The subject of plotting is discussed under the PLOT command in the on-line Help.





Section 8 - Using InFoCAD 


8.1 Opening and Exiting Libraries

In InFoCAD, Libraries are accessed through the menu bar, the bar that runs across the top of your InFoCAD window. In order to open a Library, simply click the cursor on the menu item FILES. A pull-down menu will then appear, offering you a range of choices. Click your cursor on OPEN . A window will then appear, showing the Libraries available in the current working directory. You may then either type in the Library name and press <return>, or place the cursor over the name of the Library you wish to open  and double-click.  You can also change to another directory, drive, or even access the network to open a Library file.

You may switch from one Library to the other using the same procedure.

To exit a Library gracefully, you must click on the same FILES menu item, and then on the EXIT option. You will then be asked to confirm your exit from InFoCAD. If you confirm, you will exit back to Windows NT.

WARNING! The simultaneous user capability is NOT available in the current release of InFoCAD. No more than one user should access the same Library at the same time. Multiple users could corrupt the Library.


8.2 The Menuing System

InFoCAD's menuing system differs from that of the UNIX-based InFoCAD in several important ways. At the top of the InFoCAD window is a pull-down menu bar which allows you to access all of InFoCAD's commands. The InFoCAD commands are grouped by modules (CAD, GIS, DB, etc.). You may display any module by clicking on the "Side_Menu" option from the pull-down menus. A Side_Menu containing the command icons in that module will then appear.  You can also change modules by clicking the right mouse button. Using this option will bring up a panel that will allow you to choose the module you wish to display as a Side_Menu.  

Commands can be accessed through keyboard entry.  Pressing the space bar will bring up a "Command" entry window.  Pressing <cr> after entering all or just part of the command name will activate the command.




8.3 The BUG/WISH Command

The BUG/WISH command is a utility provided with InFoCAD that allows users to report program anomalies and to suggest improvements to InFoCAD. This command is accessed through the UTILITIES module. Upon executing this command, you will be asked to edit either "username".LOG file or INFOCAD.LOG.  This allows your company to have individual log files for each user and/or one central INFOCAD.LOG file. When first used, you will be asked to input your full name, company name, address, and telephone number. These values will be stored as default values and used for subsequent entries. Toggles on the middle of the BUG/WISH panel will allow you to choose the platform, product, module, and command about which you wish to comment. A BUG/WISH toggle allows you to let us know whether it's a complaint or a comment. The ascii files created within the BUG/WISH command can then be sent to DMS, either on floppy disk or via the DMS bulletin board system.  BBS: (305) 529-9303	





Section 9 - Modification Notes

1. Both the SQL and ZOOM commands have been added to the Poly Module.

2. The DIG SET command in the COGO Module has a configuration option that allows you to select the appropriate digitizer configuration for your digitizer. If your digitizer is not supported, call DMS Technical Support at (305) GIS-9940.

3. The [RECOVER] and [OPTIMIZE] options are now located in the FIGURE command in the GIS Module.

The [RECOVER] option is used to restore to normal a database that has been corrupted due to power failures, operating system errors, or for whatever reason. The Recover database: prompt appears.

	            You must select [YES] to begin the recover process. You are returned to the DB Module 				command bank once the recover process is complete. You must select [NO] to abandon the 			command without recovering the open database. You are returned immediately to the DB 			Module command bank.

	[OPT] allows you to compress, or optimize, the open database. Using this option saves space 			and is used, for example, in preparation for large file transfers. Optimizing the database will also 			reduce the time it takes InFoCAD to perform a query on the database. A prompt appears, 			allowing you to confirm that you want to perform the optimize. 

	If you choose [YES], InFoCAD will compress and optimize the open database. [NO] exits you 	from this option and returns you to the initial command extension. NOTE: Performing this 		operation changes any saved record collections because the collections save only the 			location of the records within the database, and this option usually involves changing the 		location of the records within the database. 

4. The F9 button can be used to regenerate the screen from the main InFoCAD screen. If the screen appears slightly abnormal in any way, pushing the F9 button will restabilize the view. This does not function from within a command.

5. The Merge Image Set command, located in the Utilities pull-down menu, allows you to combine image sets and store them as one new set. 

Upon selecting the Merge Image Set Command, you are asked to enter or select the image set merge file, or the file into which you want to merge. Once this file is chosen, you must choose a source set file, or file from which you want to merge. You will be merging the source set file into the image set merge file. 

You are then prompted to enter a range to copy. The selected range will be copied into the image set merge file. You may select the entire set.

You must then choose a destination start index, or location for the new set.

The final step is to select [Save Merge] at the Source set file: prompt. This completes the merging process.

6. The Options section of the GROUP command includes a Box in any direction function that can be turned on or off. When this function is On, it will apply anytime you draw a box (Not only within the GROUP command).

7. The Macrogen command accesses InFoCAD's Macro Generator. Currently, this command is only accessible by typing "macrogen" at the main InFoCAD window. 

8. It is necessary to exit the current Library before it is possible to delete that Library.






Appendix - Distribution Files

A full listing of the files that make up the InFoCAD distribution appears below and on the following pages. Make sure that all the files listed have been properly loaded into the machine. 

Before deleting any files, Digital Matrix Services strongly suggests that you make a back-up of the entire distribution to ensure that you have two complete copies of all the files. 


InFoCAD Projections Files

File Name	
NAD83SP
LATLONG.IDX
UTM.ZON
CONUS.LAS
CONUS.LOS
PRVI.LOS
PRVI.LAS
INFO_TIG.LAY
INFO_FIP.SAM
INFO_FIP.SDF
INFO_TIG.SDF
INFO_FIP.TXT
STANDARD.GCD
ALIAS.SDF
CITY.SDF
FIGDUP.SDF
ZIP.SDF
ADDRESS.SDF
TIGER.BAT
DEMOG.BAT
NAD2727.SP


Bitmap Patterns

File Name
INFOCAD.ICO
LATLONG.BMP
78.BMP
79.BMP
71.BMP	
72.BMP	
73.BMP
74.BMP
75.BMP
76.BMP
77.BMP
SHADOW.CUR


Executables

File Name
PROFILE.EXE
INFOINIT.EXE
HPGLCONV.EXE
FONTDUMP.EXE
LOGINBMP.DLL
INFORES.DLL
INFOCADP.EXE     } Only One of the three executables
INFOCADD.EXE     } listed are contained on the 
INFOCADJ.EXE      } 3 1/2" Floppy Distribution Set.


InFoCAD Data Files

File Name
DIGIFONT.DAT
INFO_INS.SAM
CADFONTS.SAV
INFO_PRO.SAM
INFO_ICO.DAT
INFO_MEN.DAT
INFO_MES.DAT
INFO_PAT.DAT
INFO_SHP.DAT
INFOPOLY.DAT


Font Files

File Name
NEWFONT1.FNT
NEWFONT2.FNT
DMSFNTN0.FNT
DMSFONT0.FNT
DMSFONT1.FNT
DMSFTN02.FNT
DMSFTN03.FNT
DMSFTN04.FNT
DMSFTN05.FNT
DMSFTN01.FNT
DMSFNT01.FNT
DMSFNT02.FNT
DMSFNT03.FNT
DMSFNT04.FNT
DMSFNT05.FNT
DMSFNT24.FNT
DMSFNT70.FNT
DMSFNT21.FNT
DMSFNT22.FNT
DMSFNT23.FNT
DMSFNT25.FNT
DMSFNT06.FNT
DMSFNT07.FNT
DMSFNT08.FNT
DMSFNT09.FNT
DMSFNT10.FNT
DMSFNT11.FNT
DMSFNT12.FNT
DMSFNT13.FNT
DMSFNT14.FNT
DMSFNT15.FNT
DMSFNT16.FNT
DMSFNT17.FNT
DMSFNT18.FNT
DMSFNT19.FNT
DMSFNT20.FNT
DMSFNT26.FNT
DMSFNT27.FNT
DMSFNT28.FNT
DMSFNT81.FNT
DMSFNT97.FNT
DMSFNT30.FNT
DMSFNT99.FNT
DMSFNT98.FNT




InFoCAD Help Files

File Name	
INFOCAD.HLP
SCRIPT.HLP
DEMO.INI
LICENSE.TXT




Panel Generator Files

File Name
PANELGEN.F
APPGEN.F
PANELSRC.F
TRANINFO.INC
APPSRC.F


Configuration Files

File Name
INFOCAD.INI



In InFoCAD Pro and InFoCAD Desktop, the following files are found in the "Key" directory. InFoCAD Jr. does not include these files.


File Name
SPROMEPS.H
SPROEVAL.C
SPROMEPS.C
MAKEFILE
SPROEVAL.EXE
REGINI.EXE
SENTLOAD.BAT
SENTUNLD.BAT
INSTALL.BAT
REGISTER.BAT
SENTINEL.INI
README.DOC
SUPERPRO.H
SENTINEL.SYS
