Prolifics Panter 2Tier User manual

2–Tier Installation
April 1999

This software manual is documentation for Panthert. It is as accurate as possible at this time; however,
both this manual and Panther itself are subject to revision.
Prolifics and JAM are registered trademarks and JAM/TPiand Panther are trademarks of JYACC, Inc.
BEA TUXEDO is a registered trademark and BEA WebLogic Enterprise is a trademark of BEA Systems,
Inc.
DynaText is a registered trademark of Inso Corporation.
FLEXlm is a registered trademark of GLOBEtrotter Software, Inc.
HP is a trademark of Hewlett-Packard Company.
INFORMIX and C-ISAM are registered trademarks of Informix Software, Inc.
IBM, DB2, and RISC System/6000 are registered trademarks and CICS is a trademark of International
Business Machines Corporation.
Microsoft, MS-DOS, Windows, Windows NT, SQL Server, ActiveX, and Visual C++ are registered trade-
marks and Microsoft Windows 95, Authenticode, Microsoft Transaction Server, Microsoft Access, Micro-
soft Internet Explorer, Microsoft Internet Information Server, Microsoft Management Console, and Micro-
soft Open Database Connectivity are trademarks of Microsoft Corporation.
Motif is a trademark of the Open Software Foundation, Inc.
Oracle and SQL*Net are registered trademarks and Oracle7, Oracle8, PL/SQL, Pro*C, Rdb7, and Rdb8 are
trademarks of Oracle Corporation.
Netscape and Netscape Navigator, and Netscape Fast Track Server are registered trademarks of Netscape
Communications Corporation.
Sun, SunOS, Solaris, JavaScript, JDK, and Java are trademarks and Sun Workstation is a registered trade-
mark of Sun Microsystems, Inc.
SYBASE is a registered trademark and Client-Library and DB-Library are trademarks of Sybase, Inc.
UNIX is a registered trademark in the United States and other countries, licensed exclusively through
X/Open Company Limited.
The X Window System is a trademark of the Massachusetts Institute of Technology.
Other product names mentioned in this manual may be trademarks or registered trademarks of their respec-
tive owners, and are used for identification purposes only.
Send suggestions and comments regarding this document to:
Technical Publications Manager
Prolifics http://www.prolifics.com
116 John Street [email protected]
New York, NY 10038 (212) 267–7722
1997, 1998, 1999 JYACC, Inc.
All rights reserved.
Printed in USA.

iii
Table of Contents
About this Guide vii. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Organization of this Guide vii. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Conventions viii. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Text Conventions viii. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Keyboard Conventions viii. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Panther Documentation ix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Online Documentation xi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation Checklist 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 1 General Information 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents of the Installation Package 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Application Architecture 4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Which Panther Components to Install? 4. . . . . . . . . . . . . . . . . . . . . . . . . . .
For More Information 5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 2 Client: Windows Installation 7. . . . . . . . . . . . . . . . . . . . . . .
Client: Pre-Installation for Windows 7. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Hardware and Software Requirements 7. . . . . . . . . . . . . . . . . . . . . . . .
Upgrading 8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Client: Installation for Windows 9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

iv 2-Tier Installation
Installation Procedure 9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing a Database Driver 10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Client: Post-Installation for Windows 13. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Post-Installation Overview 13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Create New Prolifics Executables 13. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure the Client Environment 15. . . . . . . . . . . . . . . . . . . . . . . . . . .
Verify the Installation 16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Look at Sample Applications 16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Troubleshooting 16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 3 Web Application Server: Windows 19. . . . . . . . . . . . . . . . .
Web Application Server: Pre-Installation for Windows 19. . . . . . . . . . . . . .
Before Installing 20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Web Application Server: Post-Installation for Windows 21. . . . . . . . . . . . . .
Post-Installation Overview 21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Licensing for Prolifics Web Application Server 21. . . . . . . . . . . . . . . . .
Configure the Web Application Server Environment 23. . . . . . . . . . . . .
Verify the Installation 24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Look at Samples 25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 4 Client: UNIX Installation 27. . . . . . . . . . . . . . . . . . . . . . . . . . .
Client: Pre-Installation for UNIX 27. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Hardware and Software Requirements 27. . . . . . . . . . . . . . . . . . . . . . . .
File Ownership and Protection 28. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Determine File Location 29. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Client: Installation for UNIX 30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation Procedure 30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring the Installation 31. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Client: Post-Installation for UNIX 33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Post-Installation Overview 33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Licensing for Prolifics 33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Create New Prolifics Executables 36. . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure the Client Environment 38. . . . . . . . . . . . . . . . . . . . . . . . . . .
Verify the Installation 40. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Look at A Sample Application 40. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Post-Installation Notes 41. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Troubleshooting 41. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 5 Web Application Server: UNIX 43. . . . . . . . . . . . . . . . . . . . .
Web Application Server: Pre-Installation for UNIX 43. . . . . . . . . . . . . . . . .

Table of Contents v
Web Application Server: Post-Installation for UNIX 44. . . . . . . . . . . . . . . .
Post-Installation Overview 44. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure the Web Application Server Environment 45. . . . . . . . . . . . .
Creating Your Web Application 46. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Verify the Installation 46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Look at Samples 47. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix A Notes for Microsoft Windows 49. . . . . . . . . . . . . . . . . . . . . .
DLLs for JPEG Decoding 49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Environment Space 50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Visual C++ Floating-Point Options 50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Prolifics Utilities 50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix B Initialization and Databases 53. . . . . . . . . . . . . . . . . . . . . . .
Appendix C License Administration 57. . . . . . . . . . . . . . . . . . . . . . . . . . .
Licensing in Prolifics 58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
License Daemons and License Types 58. . . . . . . . . . . . . . . . . . . . . . . . .
Options File 59. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FLEXlm Utilities 61. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix D License File 73. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents of the License File 73. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix E Error Messages 77. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Prolifics Installation Error Messages 77. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DLL Messages 79. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Informix-Specific Messages 79. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Microsoft SQL Server-Specific Messages 79. . . . . . . . . . . . . . . . . . . . .
ODBC-Specific Messages 80. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Oracle-Specific Messages 80. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sybase-Specific Messages 81. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DLL Version Mismatch Messages 81. . . . . . . . . . . . . . . . . . . . . . . . . . .
Graph-Related Messages 81. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
License Manager Error Messages 81. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Prolifics License-Related Messages 82. . . . . . . . . . . . . . . . . . . . . . . . . .
FLEXlm Informational Messages 86. . . . . . . . . . . . . . . . . . . . . . . . . . . .
FLEXlm Configuration Problem Messages 88. . . . . . . . . . . . . . . . . . . .
Daemon Software Error Messages 89. . . . . . . . . . . . . . . . . . . . . . . . . . .
Index 93. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

vii
About this Guide
The Installation Guide contains complete instructions for installing Panther and for
setting up the initial configuration on machines for the supported platforms. It also
discusses system requirements, contents of the installation package, licensing, and
linking in databases.
The guide assumes that the person doing the installation is a system administrator
or someone familiar with UNIX and Windows operating systems.
Organization of this Guide
This guide includes the following information:
`Pre-installation information —An overview of application architectures, the
Prolifics components which make up Panther, and requirements and
procedures necessary to install Panther.
`Installation instructions —Installing Prolifics software components on UNIX
and Windows systems.
`Post-installation notes —Instructions on verifying installation and configura-
tion, how to install the licensing software, creating new Prolifics executables
for your installation, and information about sample applications distributed
with Panther.

Conventions
viii 2-Tier Installation
In addition, appendices provide information on modifications you can make to the
distributed initialization files, background information on licensing including
license utility programs, and the format and content of the password-enabled
license file.
Conventions
The following typographical and terminological conventions are used in this guide:
Text Conventions
Monospace (fixed-spaced) text is used to indicate:
`Code examples.
`Words you’re instructed to type exactly as indicated.
`Filenames, directories, library functions, and utilities.
`Error and status messages.
Uppercase, fixed-space font is used to indicate:
`SQL keywords.
`Mnemonics or Prolifics constants.
Italicized helvetica is used to indicate placeholders for information you supply.
Items inside square brackets are optional.
One of the items listed inside curly braces needs to be selected.
Ellipses indicate that you can specify one or more items, or that an element can be
repeated.
Italicized text is used:
`To indicate defined terms when used for the first time in the guide.
`Occasionally for emphasis.
Keyboard Conventions
Prolifics logical keys are indicated with uppercase characters.
expression
KEYWORDS
numeric_value
[option_list]
{x | y}
x ...
new terms
XMIT

Panther Documentation
About this Guide ix
Physical keys are indicated with initial capitalization, and keys that you press
simultaneously are connected with a plus sign.
Panther Documentation
The Panther documentation set includes the following guides and reference
material (available as indicated), as illustrated in Figure NO TAG:
Installation —Instructions for installing software and licensing for Panther
products in the following books: JetNet Installation, TUXEDO Installation, MTS
Installation, WebLogic Enterprise Installation, and 2-Tier Installation.
New Features Guide —Information about new features in Panther, including Java
support, enhanced three-tier and web functionality, new properties, new library
functions, and, for Windows 32–bit platforms, tab controls and dockable toolbars.
Upgrade Guide —Information for upgrading from JAM to Panther.
Getting Started —Introduction to the Prolifics products and the tutorial, with
step-by-step instructions that help you get started with understanding, setting up
and developing either a two- or three-tier Prolifics application.
Developer’s Guide —Introduction and process of how to use Prolifics to build
two- and three-tier Prolifics database applications. As the major developer’s
manual, it includes information for each step of the development path.
Web Developer’s Guide —Introduction and process of how to build and deploy a
Prolifics web application.
Using the Editors —Instructions for using the Prolifics graphical authoring
environment—the screen editor, screen and report wizards, JIF editor, menu bar
editor, and styles editor—to build two- and three-tier applications.
Programming Guide —Describes JPL, Prolifics’s scripting language, and
Prolifics’s Java programming interface. Also includes alphabetical listings of JPL
commands, built-in functions, Prolifics’s library functions, transaction manager
commands, and database commands and variables.
Reports —Instructions for using Prolifics’s report generation utility to build,
modify and run reports.
JDB —Instructions for using JDB, Prolifics’s prototyping database, and JISQL,
the interactive SQL editor for JDB. Also describes how to build SQL statements
and the SQL commands available in JDB.
Alt+A

Panther Documentation
x2-Tier Installation
Database Drivers —Instructions for using Prolifics’s database drivers. Each driver
has its own section containing the information specific to that relational database
engine.
Configuration —Instructions for configuring Prolifics on various platforms and to
your preferences. Also includes information on GUI resource and initialization
files.
Installation*
Getting Started*
(for new users)
Developer’s Guide
Reports
Upgrade Guide
(for JAM upgrades)
New Features Guide
(for Prolifics upgrades)
Quick Reference
Database Drivers
Configuration
Using the Editors
Web Developer’s Guide
Properties Reference
(online only) Master Index/Glossary
Additional Reference:
JDB
Programming
Guide JetNet Guide
TUXEDO Guide
MTS Guide
WebLogic Enterprise Guide
(three-tier only)
Figure 1. A suggested reading path for the Panther documentation set. An asterisk (*)
indicates that there are multiple versions of the book for different environments.
JetNet Guide —Instructions for configuring and monitoring your Prolifics
three-tier JetNet application.
TUXEDO Guide —Instructions for configuring and monitoring your Prolifics
three-tier TUXEDO application.

Online Documentation
About this Guide xi
MTS Guide —Instructions for building and deploying COM components in your
Prolifics three-tier application.
WebLogic Enterprise Guide —Instructions for building and deploying WebLogic
Enterprise components in your Prolifics three-tier application.
Quick Reference —Easy reference to all Prolifics properties and definitions
associated with application objects. Also includes quick reference to database and
transaction manager commands, library functions, JPL commands, Prolifics
development utilities, and application variables.
Master Index/Glossary —Master index for all manuals—online and printed. Also
a reference to terms used throughout the documentation set.
Online Documentation
Panther’s documentation set is available online and included with the Panther
distribution. The books can be viewed through the DynaTextTM browser on GUI
platforms. To access the books, choose Help from within Prolifics or run
DynaText’s read-only browser by clicking on the DynaText icon or typing dtext
at the command line. For instructions on using DynaText, choose Help from within
a DynaText browser window, or refer to the Using DynaText title in the Collection
window.
DynaText is a full-featured online documentation system with support for:
`Text searches
After you open a title in the Collection window, the search panel is at the
bottom of the DynaText window. When you type in a search string, DynaText
lists the number of hits next to the title of each book, chapter and subsection.
Two wildcard characters are available: ? (a single character) and * (0 or more
characters). DynaText performs an exact match on the search string; you will
need to enter a wildcard if a word is used in both singular and plural contexts.
For example:
server returns: server
server* returns: server, servers, server.lib,
client/server
Common words can be on the search engine stop list or be one of the query
keywords. Either condition produces a DynaText error. Enclose the search
string in quotation marks and submit again. For example:
”use in select”
Using DynaText

Online Documentation
xii 2-Tier Installation
`Proximity searches
If desired, you can include proximity search parameters in your text searches.
For example:
connection within 5 words of database
screen within 2 words before editor
`Boolean searches
You can also include Boolean search parameters in your text searches using
the following keywords: and, not, or. For example:
procedure or module
`Search forms
Prolifics provides additional search forms which search for library functions
and for text within code examples. Choose Book⇒Search Forms (Windows)
or Search⇒Forms (Motif).
`Alternate documentation views
To automatically open the graphics, instead of displaying them as icons, on the
View menu, choose View⇒Main⇒Inline. (The default setting is Fulltext.)
To view a list of tables in the documentation, on the View menu, choose
View⇒TOC⇒Tabletoc.
`Public and private annotations
You can create your own notes inside the documentation using annotations.
The annotations are stored in the directory location specified in your .ebtrc
(Motif) or dynatext.ini (Windows) file.
`Print capability
You can print any section of the documentation or its table of contents to a
PostScript printer or file. After you choose File⇒Print:
•Highlight the desired section of the documentation. (It defaults to the
current section of documentation in the book window.)
•Choose the desired print format: full text or table of contents.
•To print to a PostScript file, modify the Print Setup in Windows, or select
the Print to File check box in Motif.
Note: Unless you print an entire chapter, the introductory paragraphs will not
be printed. If you highlight Prolifics, DynaText will attempt to print the entire
documentation set.

Online Documentation
About this Guide xiii
For more information on using DynaText, refer to the Using DynaText title in the
Collection window.
The following information is also provided with your Prolifics installation:
`Online README file.
Contact Prolifics for more information on the following services:
`Product Support
`Consulting Services
`Educational Services
Collateral
Documentation
Additional Help

1
Installation Checklist
Use this checklist to ensure that you complete the appropriate steps to install and
configure your Prolifics development environment for the chosen architecture.
Pre-Installation
-Determine the application architecture. p. 4
-Based on architecture, decide which components to
install. p. 4
-Satisfy hardware and software requirements for the
components you plan to install. Windows: p. 7 Windows Web: p. 19
UNIX: p. 27
UNIX Web: p. 43
Installation
-Install each Prolifics component. Windows: p. 9
UNIX: p. 30
Post-Installation
-Submit request for permanent license (in the mean-
time, you can start using Prolifics since it is installed
with a Start-up License).
Windows Web: p. 21
UNIX: p. 33
-Create new Prolifics executables, if necessary. Windows: p. 13
UNIX: p. 36
-Configure the client environment. Windows: p. 15
UNIX: p. 38
-(Web application development only) Configure the
web application server environment. Windows Web: p. 23 UNIX Web: p. 45
-Verify installation and configuration. Windows: p. 16
Windows Web: p. 24
UNIX: p. 40
UNIX Web: p. 46
-Look at sample applications. Windows: p. 16
Windows Web: p. 25
UNIX: p. 40
UNIX Web: p. 47
When you complete the appropriate steps in the installation checklist, and set up
your application environment, you are ready to build a Prolifics application.

3
General Information
In order to help you install the appropriate components, this chapter describes the
contents of the Panther installation package, application architectures, and the
functionality of the Prolifics software components that make up your Panther
distribution.
Before you begin the installation process, review the Release Notes for the latest
information about Panther, including known problems.
Contents of the Installation Package
The Panther installation package consists of the items listed below. Some of these
items may not be required or appropriate for your particular installation, and
therefore are not included in your package. For a complete list of files included in
the installation, refer to packlist.txt in the notes subdirectory of the
installation.
`Prolifics client and web application server executables, with corresponding
utilities, tools, and configuration files.
`JDB, the Prolifics single-user database.
11

Application Architecture
42-Tier Installation
`Database drivers for connecting to third-party relational databases, such as
Oracle and Sybase.
`Files for C program development.
`Files for Java program development.
`License management software.
`Online documentation and help system; sample two-tier applications and a
tutorial; and the Prolifics Gallery, which includes a variety of sample web
applications.
Application Architecture
Choose the appropriate architecture for your application based on your require-
ments.
-Two-tier application The two-tier client/server model typically separates
data from the logic of an application.
-Web application A web application is an application deployed on the
web application server and viewed from a web
browser. The web application server works with your
HTTP server software.
Which Panther Components to Install?
For Panther, you are required to install the Prolifics client software. You can also
choose to install a web application server. Each component is described, as well as
the platforms on which each component is supported. Based on your chosen
architecture, install the appropriate Prolifics components purchased.
`Prolifics client —Provides the development and runtime environment for
building two-tier applications. Client platforms supported are:
-UNIX
-Windows 32-bit (95/98 and NT 4)
`Prolifics web application server —Provides the runtime environment for
client-server applications that are accessed through web browsers. Web
application server platforms supported are:
-UNIX
-Windows NT 4

For More Information
Chapter 5 1 GeneralInformation
For More Information
After Panther is installed and configured, you can refer to the online documenta-
tion for information on specific topics. The preface, About this Guide, contains a
suggested reading path and more information about the documentation.
Refer to: For:
Getting Started Step-by-step instructions for building a two-tier
application, including setting up a client environ-
ment as well as a web application server.
online New Features Guide New features in Panther.
online Upgrade Guide Upgrade information from JAM to Panther.
online Configuration Prolifics variables used for configuring Prolifics on
various platforms and to your preferences. Informa-
tion on GUI resource and initialization files.
Developer’s Guide Introduction and process of how to build database
applications.
online Using the Editors Basic guide to the Prolifics graphical authoring
environment.
Web Developer’s Guide Guide to building and deploying a Prolifics web
application.
Reports Guide to using Prolifics’s report generation utility
to build, modify and run reports.
Programming Guide Guide to JPL, Prolifics’s programming language,
and using Java and C library functions in Prolifics.
online JDB Guide to JDB, Prolifics’s prototyping database, and
JISQL, the interactive SQL editor for JDB.
readme.* in the notes
subdirectory Database-specific release notes detailing the setup of your Prolifics application as a database client.
fixlist.txt in the
notes subdirectory List of bugs fixed in Prolifics.

7
Client: Windows
Installation
Client: Pre-Installation for Windows
This section discusses hardware and software requirements and upgrade informa-
tion for Prolifics software running under Windows.
Hardware and Software Requirements
The full installation of the Panther development environment requires the
following:
`80486 or better processor; Pentium processor is recommended.
`A maximum of 137 MB of disk space (of which 35 is for the online documen-
tation). However, the disk space required can be less depending on the options
installed. The installation checks for adequate space.
`Microsoft Windows 95/98 or Microsoft NT 4.
Note: Under Windows platforms, web application servers are only supported
on Windows NT, version 4.
22

Client: Pre-Installation for Windows
82-Tier Installation
`32 MB of memory.
`Database vendor’s client and network software installed if you are using a
database other than JDB. For more information, consult the database-specific
release notes online.
`To use Java files, you must have either JDK 1.1 (Java Development Kit) or the
JRE (Java Runtime Environment), or compatible versions, installed. To
compile Java programs, the JDK is required. If you are using Microsoft’s
Virtual Machine for Java, use version 5.00.3167 (1/25/99) or later.
`If you are going to add your own C functions to Prolifics, install the Microsoft
Visual C (MSVC) compiler (version 6 for Windows 95/98 and NT 4). You also
need to install the MFC (Microsoft Foundation Class) portion of MSVC along
with the compiler.
If you are installing a Prolifics client and web application server on the same
Windows NT machine, you must install them in the same directory. This allows
them to share common environment settings that point to the location of required
files. It also saves disk space.
Upgrading
If you are upgrading from an earlier version of Prolifics, install Panther in a
separate directory from previous installations, for example, C:\Panther.
The setup program unsets any existing SMVARS, SMPATH, SMTERM, SMMSGS, SMKEY,
and SMVIDEO settings in your autoexec.bat file. The setup program lets you
choose from the following three options:
`Let the setup program modify the autoexec.bat file. The existing
autoexec.bat is saved to autoexec.xxx where xxx is a three-number
extension.
`Save the required changes to autoexec.new file.
`Not make any changes for the autoexec.bat file.
After successfully installing Prolifics software, there are several post-installation
steps required to start using Prolifics. This chapter discusses licensing, building
Prolifics executables, the steps required to set up the environment for each of the
Prolifics components installed, and post-installation issues and troubleshooting
tips.

Client: Installation for Windows
Chapter 9 2 Client:Windows Installation
Client: Installation for Windows
These instructions apply to both first-time installations and to upgrades from
previous versions of JAM and Prolifics. Before beginning the installation, review
the requirements and other pre-installation steps discussed earlier in this chapter.
This section discusses running the setup program to install a Prolifics client and
database drivers under Windows.
InstallationProcedure
Panther is supplied in compressed form on CD-ROM along with a Windows-based
setup program.
To run the setup program:
1. Insert the CD-ROM in the appropriate drive.
2. If the setup program does not start automatically, choose Start⇒Run. In the
Run dialog box, type D:SETUP (where Dis the letter of the drive from which
you are installing).
Choose to install the Client software.
The setup guides you through the steps to install and configure your
installation.
3. During the installation you can select a setup type. Each setup type includes
certain Prolifics components. The components are:
•Program Files —Required to run Prolifics. Contains all configuration
files, utilities, and DLLs necessary to run the Prolifics development
environment.
•Development Files —Optional. Only necessary if you want to add your
own C code, link out certain options, link statically with a database driver,
or use Java files with the client or web application server.
•Samples and Tutorial Files —Optional. Installs the sample applications
VideoBiz (two-tier application), Enterprise Bank (three-tier application),
sample ActiveX controls, and the Tutorial.
•Help Files and Online Documentation —Optional. Since these can be
quite large, consider sharing a copy across a network if disk space is a
concern. Or, if you are installing from CD-ROM, leave the files on the
CD-ROM rather than copying them to your PC.