#
G2 ReThink
Version 5.1 Rev. 1
Readme

##
(August 2007)

ReThink is a graphical simulation, analysis, and automation tool that enables decision-makers within complex organizations to visualize how their business process works, to analyze its performance, and to deploy it in real time.

Once the current process is understood, decision-makers can experiment with alternative work-flow models to redesign the business process in order to:

- Reduce costs.

- Reduce time to market.

- Improve quality.

- Enforce standards.

ReThink has numerous features including process modeling, workflow analysis, "what-if" analysis, simulation management, and online deployment.

This readme file describes:

- System Requirements

- Software Requirements

- Windows XP and 2000 Users

- Bug Fixes

- Known Problems

- Starting ReThink

- Exiting ReThink

- ReThink Directories

- ReThink File Descriptions

- Customer Support

## System Requirements

The recommended system requirements for hardware, operating systems, and networking capability for clients running ReThink are:

- Windows XP Pro, 2003, or 2000.

- Pentium processor (at least 1 GHz Pentium 4 processor recommended for development).

- 512 Mbytes memory.

- 1 GB disk space, including documentation.

- Display with resolution of 1024 x 768, 16-bit color, and 2 Mbytes of video RAM.

- Excel 2000 SR-1 or Microsoft Excel 97 SR-2, depending on your operating system.

- 14.1" TFT display for laptops or 17" monitor for desktops.

- TCP/IP protocol installed and configured.

Additionally, a 10 Mbps local network connection to the server; performance may vary based on network availability.

## Software Requirements

ReThink integrates with Excel to report results and chart trends; therefore, you need to install Excel 2000 SR-1.

ReThink requires that you install Acrobat Reader 4.0 or later, which you need to read online documentation. Acrobat Reader is freely available on the Internet. Gensym does not provide any support or warranty for this product. Please contact Adobe for any issues about Acrobat Reader.

## Windows XP and 2000 Users

To install ReThink on Windows XP or 2000, you must have administrator privileges.

After installation, a user without administrator privileges cannot run ReThink until the file permissions on the installed files have been changed. The recommended way to do this is to have the administrator follows these steps after installation:

1. Choose Properties on the folder that contains the ReThink software, `c:\Program Files\Gensym\g2-8.3r1`, by default.

2. Click the Security tab, then click the Advanced button.

3. Enable the "Reset permissions on all child objects and enable propagation of inheritable permissions" option.

Enabling this option allows the user to run ReThink without giving administrator privileges. The user can now run ReThink.

## Bug Fixes

For bug fixes in ReThink Version 5.1 Rev. 1, see Gensym's HelpLink.

## Known Problems

ReThink Version 5.1 Rev. 1 has the following known problems:

- We know of at least one product, namely Visio, which conflicts with creating reports in Excel, using ReThink. These products create hidden files with an Excel file extension (.xls) in the XLStart directory in Excel. The macros of these hidden files conflict with ReThink Excel macros. In the case of the Visio macros, ReThink opens the spreadsheets, but then opens a second spreadsheet in which it displays the results. To fix this problem, remove all files from the XLStart directory and ensure that only the ReThink workbook is loaded into Excel.

- If you are using Microsoft Office 2000, you have to change the security level within Excel from High to Medium or Low. Otherwise, Excel will never prompt you to Enable Macros. To do this, choose Tools Macro Security. The default ReThink report defines a macro that format the report in Excel; thus, you must enable macros when you first open the default report or any report that is based on this default.

- When using ReThink for database access with MS Access or SQL 2000, the prefix for bind variables is ? and not : as in Oracle. In addition, you must not add the variable name after the bind variable, whereas in Oracle you do. If you specify that the bind variable prefix as ? on a network connection pool:

  - You must write your SQL statement prefixing bind variables with ? and add the variable name, which is a G2 attribute. For example:

    `SELECT lastname, firstname from employees where employeeid = ?employeeid`

  - The internal code parses the SQL statement and reformats it by removing the variable name after the ? to what's expected by SQL2000 before sending it to the database. In the example above, it is reformatted to:

    `SELECT lastname, firstname from employees where employeeid = ?`

  - It uses the variable name after the ? (`employeeid` in the example) to fetch the value from an attribute of the work object named by this variable.

## Starting ReThink

ReThink is a client/server application. To start ReThink, first you must start the server, then you can connect the client. By default, the client connects to the server running on the local host computer at port 1111. The installation program creates shortcuts in the ReThink program group on the Start menu for starting both the server and the client.

By default, when you start ReThink, ReThink opens the default model, which is `rethink-online.kb`.

You can open a different model at startup by creating and modifying a shortcut to the batch file that starts the ReThink Server.

To open the default ReThink model:

1. Choose Start > Programs > Gensym G2 8.3r1 > G2 ReThink > Start ReThink Server.

Wait until you see the G2 icon in the system tray with a green arrow indicating G2 is started.

1. Choose Start > Programs > Gensym G2 8.3r1 > Telewindows Next Generation.

To start ReThink with a different model opened in the server:

1. Choose Start > Programs > Gensym G2 8.3r1 > G2 ReThink and mouse right on the Start ReThink Server menu choice and choose Create Shortcut.

A shortcut named Start ReThink Server (2) appears in the menu. You can rename the shortcut and drag it onto your desktop, as desired.

1. Display the properties dialog for the shortcut, click the Shortcut tab, and edit the default KB file to open, for example:

       "C:\Program Files\Gensym\g2-8.3r1\g2\StartServer.bat"
       -kb "..\rethink\examples\aero.kb" -nowindow

2. Use this shortcut to start the server with your KB file loaded.

## Exiting ReThink

When you exit the client, ReThink disconnects the client from the server, leaving the server running.

In general, you should exit the server as well as the client. If you do not exit the server when you exit the client, logging out of your Windows session exits the server automatically.

Caution: Be sure to save your application before you exit ReThink.

To disconnect the ReThink client:

-> Choose File > Close.

To exit the ReThink server:

-> Mouse right on the G2 icon in the system tray and choose Shut Down G2 from the menu to exit the server.

## ReThink Directories

Directory | Description
--- | ---
    activexlink
| ActiveX control to integrate with Excel and other MS Office applications.
    corbalink
| CorbaLink bridge for custom integrations and development.
    doc
| Online documentation for ReThink, distributed as WinHelp, PDF, and HTML files.
    g2
| ReThink server software. This directory also includes G2 fonts and utility kbs.
    g2i
| Advanced G2 developers' tools for building Windows user interfaces, handling runtime events, creating custom message browsers, and other features.
    gsi
| G2 Gateway libraries to build custom integration bridges.
    gw
| WebLink Web server to build custom Web server applications.
    javalink
| JavaLink bridge to integrate with Java applications.
    jmail
| JavaMail bridge to integrate with Java mail applications. This directory is only available with ReThink Online.
    jms
| Java Message Server bridge to integrate with Java messaging applications.
    jre
| Java Runtime Environment (JRE) Version 1.4.2.
    odbc
| ODBC bridge to integrate with ODBC data providers such as databases.
    opclink
| OPCLink bridge for custom integration with OPC compliant servers.
    oracle
| Oracle bridge to integrate with Oracle databases.
    pi
| PI bridge to integrate with PI servers.
    protools
| G2 utility to enhance the productivity of customizations.
    rethink
| ReThink KBs required to run the server, as well as example KBs.
    sockman
| Java Socket Manager bridge to integrate with Java sockets.
    sybase
| Sybase bridge to integrate with Sybase databases.

## ReThink File Descriptions

This table describes user-level ReThink files in the relevant directories:

File | Description
--- | ---
    ReThink-readme.html
| This readme file.
    readme-g2.html
| A readme file for the G2 server.
    \g2\StartServer.bat
| A batch file that starts the ReThink server and loads the `rethink-online.kb`.
    \g2\twng.exe
| The executable that starts the ReThink client.
    \jmail\bin\StartJMailBridge.bat
| A batch file that starts the G2 JMail Bridge for use with the Email Send block.
    \rethink\kbs\rethink.kb
| This KB exists for backward compatibility.
    \rethink\kbs\rethink-online.kb
| The default model to load when running ReThink from the Start menu.
    \rethink\examples\aero.kb
| A ReThink demo model of a manufacturing and distribution process.
    \rethink\examples\orderful.kb
| A ReThink demo model of an order fulfillment process.
    \rethink\examples\chapter3.kb
| A ReThink demo model used in the Getting Started with ReThink tutorials.
    \rethink\examples\rethink-40-doc-examples.kb
| Examples of new functionality introduced in ReThink Version 4.0.
    \rethink\examples\rethink-40-online-examples.kb
| Examples that show how to use some of the online blocks available with ReThink.
    \rethink\data\orders.mdb
| Microsoft Access database for use with the online examples.
    \rethink\data\ReThink-Summary-Report.xls
| A pre-configured Excel spreadsheet in which to display reports. This is the default spreadsheet that ReThink uses when generating reports.
    \doc\rethink\ReThinkUsersGuide.pdf
| A complete user's guide for building and running ReThink models.
    \doc\rethink\ReThinkTutorials.pdf
| A step-by-step tutorial for learning how to build, run, and analyze ReThink models.
    \doc\rethink\Customizing-ReThinkUsersGuide.pdf
| A complete user's guide for customizing ReThink blocks, instruments, and resources.
    \doc\rethink\WinHelp\Master.chm
| WinHelp files used for launching online help from the Help menu.

Note: You can access the demo models and tutorial solutions from the Start menu under Programs > Gensym G2 8.3r1> G2 ReThink > Examples. You can also access the PDF files from the Start menu under the Documentation folder.

## Customer Support

You can obtain help with this or any Gensym product from Gensym Customer Support. Help is available online, by telephone, by fax, and by email.

To obtain customer support online:

-> Access G2 HelpLink at `www.gensym-support.com`.

You will be asked to log in to an existing account or create a new account if necessary. G2 HelpLink allows you to:

- Register your question with Customer Support by creating an Issue.

- Query, link to, and review existing issues.

- Share issues with other users in your group.

- Query for Bugs, Suggestions, and Resolutions.

To obtain customer support by telephone, fax, or email:

-> Use the following numbers and addresses:

| Americas | Europe, Middle-East, Africa (EMEA)
--- | --- | ---
Phone | (781) 265-7301 | +31-71-5682622
Fax | (781) 265-7255 | +31-71-5682621
Email | service@gensym.com | service-ema@gensym.com

#