Welcome to With Class 2.1 Educational Version (10 Class Limit)

1. Installing With Class

The following are the minimum system requirements for With Class:
- 80386 processor or higher (80486 or higher recommended)
- MS-Windows 3.1 or higher
- Mouse that supports MS-Windows
- VGA monitor - 1024x768 or higher resolution recommended

To initially install and run With Class, follow these steps:

>> Copy all With Class files into a directory, e.g. wc2

>> Copy MFCOLEUI.DLL into C:\WINDOWS\SYSTEM

>> Copy DATADIC1.DOT to the WINWORD\TEMPLATE directory if
Microsoft Word 6.0 is present

>> Ensure CTL3D.DLL in your path, e.g. C:\WINDOWS\SYSTEM is in 
your autoexec.bat path statement

>> Ensure the following files are in the C:\WINDOWS\SYSTEM 
directory: COMPOBJ.DLL, STORAGE.DLL, OLE2.DLL, OLE2DISP.DLL, 
OLE2NLS.DLL, CTL3D.DLL, AND MFCOLEUI.DLL.  If not installed,
copy the provided dll's into C:\WINDOWS\SYSTEM. Note - do
not overwrite any installed dll's unless you have a problem.
A early wc2 release contained OLE2 dll's dated 11/16/94 which 
caused some problems with Microsoft Office applications.  
Specifically, you could not run Microsoft Chart from Microsoft 
Word 6.0. This release contains the OLE2 dll's dated 11/20/94 
which work well with Microsoft Office applications.

>> Ensure SHARE is either executed automatically or is in your
autoexec.bat.  Sample entries are C:\DOS\SHARE, 
C:\DOS\SHARE /L:500, OR C:\DOS\SHARE /F:5100 /L:500.  
Alternatively, a sample config.sys entry is INSTALL=SHARE /F:4096.

>> In Windows Program Manager, create the With Class icon by 
selecting "File New", "Program Icon", and entering WC2.EXE

>> In Windows, run With Class from Windows, e.g. "File Run 
WC2.EXE" or double click the With Class icon

To  install With Class from a disk provided from MicroGold:  
Type from windows program manager  FILE | RUN a:install.exe.
To print user instructions, print topics from the Help Menu.

With Class file creates wc2.ini in the windows directory.  If you 
have problems launching With Class, delete WC2.INI so that it is 
automatically regenerated.  If you have video problems, try using
standard VGA (640 x 480) or the most up-to-date video drivers 
available for your video card.  Ensure you are using the dll's
provided with the product.  Older version dll's may be on your
system in another directory and may be invoked.  If you have any 
installation problems, contact MicroGold Software at 
71543.1172@compuserve.com.

Known Limitations with this educational version : 
(1) Due to OLE constraints only 3 diagrams may be open at a time.  
When you try to save the 4th diagram, you may get an error, e.g. 
Illegal File Name.  If you get this error, close one or more 
diagrams and save the diagram.  
(2) Once an OLE object is inserted into a diagram using Insert Object, 
it cannot be deleted. 
(3) OLE Copy is experimental and may cause unpredictable results 
if you use Copy OLE menu command to copy, paste, and activate a 
diagram into MS Word 6.0. To copy a diagram into another Windows 
application, it is recommended that you use Copy for a bitmap copy. 
(4) Cut is not implemented.
(5) Put only 10 classes on a diagram.  Putting 11 or more classes 
on the educational version may cause unpredicable results.

2.  Primary Files in this release
- readme.txt    Installation Instructions
- wc2.exe       With Class Program
- wc2.hlp       With Class Help Program
- *.dll         DLL's used by With Class Program
- wc2tutor.wri  O-O Modeling Using With Class
- codegen.wri   Instructions on Generating Code Using Scripts
- *.sct         Text Script Files for custom reports and code
		generation
- *.omt         Class diagrams to test code generation scripts
- datadic1.dot  Microsoft Word 6.0 document template for 
		a data dictionary

3.  Using With Class Scripts

>> Launch With Class from Windows
>> Open a class diagram, e.g. cppcar.omt
>> Select "Generate - Generate Report"
>> Enter a report name, e.g. REPORT.TXT
>> Select RPTALL.SCT to generate the report
>> Select "File - Edit File" and open REPORT.TXT

Here is a list of all the script variables that may be used to create
custom reports and code generation.

CLASS_NAME or CLASS
CLASS_CARDINALITY
CLASS_CONCURRENCY
CLASS_PERSISTENCE
CLASS_ACCESS
CLASS_FILENAME
CLASS_AUTHOR_INITIALS
CLASS_LIBRARY_BASE_CLASS
CLASS_INVARIANT
CLASS_DESCRIPTION
INCLUDE_FILE

ATTRIBUTE_NAME
ATTRIBUTE_TYPE
ATTRIBUTE_ACCESS
ATTRIBUTE_MAX_VALUE
ATTRIBUTE_MIN_VALUE
ATTRIBUTE_CONSTRAINT
ATTRIBUTE_INITIAL_VALUE
ATTRIBUTE_INFO

OPERATION_NAME
OPERATION_RETURN_TYPE
CPP_OPERATION_PARAMETERS
OPERATION_ACCESS
OPERATION_TRANSFORMATION
OPERATION_PRECONDITION
OPERATION_POSTCONDITION
OPERATION_EXCEPTION_TYPE
OPERATION_EXCEPTION_NAME
OPERATION_CLASSIFICATION
OPERATION_CONCURRENCY
OPERATION_CODE
OPERATION_COMMENT1
OPERATION_COMMENT2
OPERATION_COMMENT3

ASSOCIATION_CLASS
ASSOCIATION_NAME
AGGREGATION_CLASS
AGGREGATION_NAME

ASSOCIATION_ONE_CLASS
ASSOCIATION_ONE_NAME
AGGREGATION_ONE_CLASS
AGGREGATION_ONE_NAME
ASSOCIATION_MANY_CLASS
ASSOCIATION_MANY_NAME
AGGREGATION_MANY_CLASS
AGGREGATION_MANY_NAME
BASE_CLASS

CPP_OPERATIONS
CPP_OPERATION_VIRTUAL
CPP_OPERATION_PURE_VIRTUAL
CPP_OPERATION_CONSTANT
CPP_OPERATION_STATIC
CPP_ATTRIBUTES
CPP_BASE_CLASSES
CPP_AGGREGATIONS
CPP_ASSOCIATIONS

PASCAL_OPERATION_PARAMETERS
PASCAL_OPERATION_PARAMETERS_PAREN
PASCAL_OPERATION_PARAMETERS_WITH_VAR
PASCAL_OPERATION_RETURN_TYPE
PASCAL_OPERATION_VIRTUAL
ADA_OPERATION_PARAMETERS
SMALLTALK_OPERATION_PARAMETERS
ACTOR_OPERATION_PARAMETERS
CLASS_PERSISTENT - prints persistent

LITERAL_SYMBOL
NO_RETURN
NO_REPEAT
DELETE_LAST_SYMBOL
TRUNCATE_EIGHT

[ ]   // anything placed in between these will be repeated for every
     // attribute, operation, constant, etc. 

$  // use this to separate out keywords (above) from text that you
	wish to run in juxtaposition. 

4. Creating a Data Dictionary in Microsoft Word 6.0
You can create a text data dictionary by running the script rptdict.sct.
However, it is recommended that you create your data dictionary in
Microsoft Word 6.0 to be able to sort and set fonts.
To create a data dictionary in Microsoft Word 6.0 follow these steps:

>> Copy the Microsoft Word 6.0 template datadic1.dot into the 
   Winword\template directory

>> Launch With Class from Windows
>> Open a class diagram, e.g. cppcar.omt
>> Select "Generate - Generate Report"
>> Enter a report name, e.g. datadict.txt
>> Select worddic1.sct to generate the text version of the data dictionary

>> Launch Microsoft Word 6.0
>> Select "File - New" and Template datadic1 (datadic1.dot)
>> Select "Insert - Database"
>> Place cursor below the headings
>> Select "Get Data" and Text Files (*.txt) and datadict.txt (generated 
   data dictionary text file)
>> Select "Insert Data" and All to import the data dictionary entries.
>> Delete blank rows, set font sizes, sort as desired.

5. This version supports entering and saving data types from various 
languages.  Data types are saved in the wc2.ini file.  WC2.ini is created
upon installation and if no wc2.ini exists.  The initial wc2.ini has C/C++ 
data types, e.g. int, float.  Whenever you enter a new data type for an 
attribute, the wc2.ini file is updated.  When you begin using With Class,
it is recommended that you create a diagram to enter the all the basic 
data types for attributes for the language and class library that you
are using.  The following are sample data types that may be used in various
languages:
- Microsoft Visual C++: CString    needs #includes "stdafx.h" or <afx.h>
- Borland C++ 3.X: String          needs #include <strng.h>
- Borland C++ 4.X: string          needs #include <string.h>
- Pascal and Delphi: Byte, Integer, LongInt, Word, Real, char, String, Double
- Ada: Boolean, Character, Integer, Float, Positive, Natural, Duration, String
- Eiffel: BOOLEAN, CHARACTER, INTEGER, REAL, DOUBLE, ARRAY, STRING
You may directly update the wc2.ini file to change a spelling or capitalization.
If you modify the wc2.ini file ensure that Number = the number of types.
Close With Class prior to making changes to wc2.ini
If your wc2.ini file becomes corrupted, delete or rename wc2.ini and a new
wc2.ini will be regenerated the next time you start With Class.   

6.To receive e-mail newsletters and announcements, please send your e-mail
address to Michael Gold, MicroGold Software at 
	Internet 71543.1172@compuserve.com or 
	CompuServe 71543,1172. 
We will periodically send out newsletters, announcements, and new scripts.  
Also, please send in the e-mail address of anyone who is interested in 
object-oriented CASE tools.
Also, for technical questions please e-mail questions to the above address.
Periodically, MicroGold uploads demo and shareware tools to the Internet.  
Currently the educational shareware version (10 class limit) of With Class 
2.0 is at the following FTP sites: 
oak.oakland.edu/SimTel/win3/pgmtools/wclass21.zip and cica.indiana.edu.  
On CompuServe wclass.zip is in MSMFC/DOC/VIEW/UI, 
CASE/CASE, and WINSHARE/PROGRAMMING.  On CompuServe type GO IBMFF and enter 
wclass.zip to find the latest version of the shareware With Class.

The demo version of StateMaker (no save) is at the following FTP site: 
oak.oakland.edu/SimTel/win3/pgmtools/state31.zip.

7. Training and Consulting Services using With Class
RCF Associates offers custom training and consulting services using
With Class with object-oriented design projects with object-
oriented languages.  The following services and products are
offered.

- Custom model development (drawings and specifications) for 
a system based upon your requirements statement and block diagram.

- Executable prototype for a system in C++, Eiffel, Ada,
and other languages based upon your model (diagrams and specifications).

- Custom With Class scripts for reports and code generation for your
specific language, class library, and coding standards.

- On-site training course "Object-Oriented Modeling with CASE and 
C++".  Course is one to five days customized to your requirements
including modeling your system during the course.

- "Object-Oriented Modeling with CASE and C++"  training manual
(200 pages) and training course viewgraph masters (400 pages)
both with 4 complete "charter to C++" case studies.

- VHS Training Videos on Object-Oriented Modeling and Using
With Class and StateMaker.

Customer satisfaction is guaranteed.  For information contact 
Richard Felsinger, RCF Associates, 960 Scottland Dr, Mt Pleasant,
SC 29464 803-881-3648 e-mail 71162.755@compuserve.com 

8. All users are encouraged to register this shareware for $59.00
at 1-908-722-6438 after 30 days.  Users may order the With Class 
Professional Version with unlimited number of classes and laser 
printed user documentation for $149.00 plus $10.00 shipping and 
handling ($20.00 shipping and handling for orders outside the US.) 
Each With Class Profession comes with the StateMaker CASE 
tool for creating state transition diagrams and generating C/C++ 
code from the diagrams.  StateMaker without With Class Professional
is $99.00 plus $5.00 shipping and handling.

Thank you for trying With Class.
Michael Gold, MicroGold Software,
696 Birch Hill Drive, Bridgewater, NJ 08807 
Telephone 1-908-722-6438 e-mail 71543,1172@compuserve.com


