IBM Informix 4GL V7.50 - IBM Informix 4GL Installation Guide
IBM Informix 4GL V7.50 - IBM Informix 4GL Installation Guide
IBM Informix 4GL V7.50 - IBM Informix 4GL Installation Guide
Version 7.50
GC23-9597-02
IBM Informix
Version 7.50
GC23-9597-02
Note
Before using this information and the product it supports, read the information in “Notices” on page B-1.
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3
Software dependencies
This publication is written with the assumption that you are using IBM Informix
11.10, 11.50, or 11.70 as your database server.
The IBM Informix OLE DB Provider follows the ISO string formats for date, time,
and money, as defined by the Microsoft OLE DB standards. You can override that
default by setting an Informix environment variable or registry entry, such as
DBDATE.
The examples in this publication are written with the assumption that you are
using one of these locales: en_us.8859-1 (ISO 8859-1) on UNIX platforms or
en_us.1252 (Microsoft 1252) in Windows environments. These locales support U.S.
English format conventions for displaying and entering date, time, number, and
currency values. They also support the ISO 8859-1 code set (on UNIX and Linux)
or the Microsoft 1252 code set (on Windows), which includes the ASCII code set
plus many 8-bit characters such as é, è, and ñ.
You can specify another locale if you plan to use characters from other locales in
your data or your SQL identifiers, or if you want to conform to other collation
rules for character data.
For instructions about how to specify locales, additional syntax, and other
considerations related to GLS locales, see the IBM Informix GLS User's Guide.
Demonstration database
IBM Informix 4GL includes a demonstration database called stores7. For
information about how to build this sample database and examples, see IBM
Demonstration programs
Demonstration programs for IBM Informix 4GL web services are available from the
$INFORMIXDIR/demo/soa/en_us/0333 directory.
Introduction vii
Table 2. What's new in IBM Informix 4GL for Version 7.50.xC4 (continued)
New feature Description
Error handling for When you enable your 4GL applications to run on the web, you can
4GL web services handle errors generated by the application or web services. Informix
4GL defines errors by error number (WS_STATUS variable) and error
message (WS_STATUS_MSG variable). The applications can check for
error numbers to determine whether certain errors occurred. The
applications can relay the correct error messages to users who can be
in different locations on remote clients. Error messages are relayed in
English only.
Additional documentation
Documentation about this release of IBM Informix products is available in various
formats.
You can access or install the product documentation from the Quick Start CD that
is shipped with Informix products. To get the most current information, see the
Informix information centers at ibm.com®. You can access the information centers
and other Informix technical information such as technotes, white papers, and IBM
Redbooks® publications online at http://www.ibm.com/software/data/sw-
library/.
Feedback from all methods is monitored by the team that maintains the user
documentation. The feedback methods are reserved for reporting errors and
omissions in the documentation. For immediate help with a technical problem,
Introduction ix
contact IBM Technical Support. For instructions, see the IBM Informix Technical
Support website at http://www.ibm.com/planetwide/.
The 4GL product has two different implementations, each of which includes the
4GL Interactive Debugger component.
v The IBM Informix 4GL C Compiler uses a preprocessor to generate IBM
Informix ESQL/C source code. This code is preprocessed in turn to produce C
source code, which is then compiled and linked as object code in an executable
command file.
Beginning with 4GL 7.50.xC2, this implementation includes the Apache Axis2/C
and Apache Axis2/Java packages. For more information about the Apache
Axis2/C server, see http://ws.apache.org/axis2/c/docs/installationguide.html.
v The IBM Informix 4GL Rapid Development System (RDS) uses a compiler to
produce pseudocode (called P code) in a single step. You then invoke a runner
to execute the P-code version of your 4GL application.
The following table indicates how much RAM is required, based on the number of
users.
Table 1-1. RAM requirements per users
Number of users RAM requirements
Small multiuser (1-10 users) 8 MB
Large multiuser (11 plus users) 16 MB or more
The following table lists the memory requirements of the various 4GL components.
See your platform-specific machine notes for more exact requirements.
Table 1-2. Memory required for 4GL components
4GL component Memory required
IBM Informix 4GL C Compiler
The following table lists the disk-space requirements of the various 4GL
components. See your platform-specific machine notes for more exact
requirements.
Table 1-3. Disk space required for 4GL components
4GL component Maximum disk space required
IBM Informix 4GL C Compiler
Order of installation
Many IBM Informix products must be installed in a specific order. Before you
install Informix 4GL, review the order of installation for your 4GL components.
If you install more than one IBM Informix product (for example, 4GL and IBM
Informix), you must install each product in the following order:
1. Application development tools
Install application development tools in chronological product order, from the
oldest to the newest versions.
2. SQL application programming interfaces (APIs)
Install SQL APIs in chronological product order, from the oldest to the newest
versions.
3. Database servers
Install database servers in chronological product order, from the oldest to the
newest versions.
Generally, a database server should be installed in the same directory as any
SQL API or application development tools that use it. Therefore, verify that
$INFORMIXDIR is set to the common directory before you install these types
of products.
4. Additional products
Install remaining interface and documentation products in chronological
product order, from the oldest to the newest versions.
User informix is a user account with main authority over an IBM Informix
instance. The user informix is the database equivalent of the UNIX root account, so
anyone logged in as informix can completely access any IBM Informix products
and databases. Make sure that you keep the password for user informix
confidential.
Group informix must exist on the system for the user accounts required to install
and administer an IBM Informix product. IBM Informix products use group
informix internally to control database access. Make user informix the only
member of group informix. If you make a user of an IBM Informix product a
member of group informix, you can cause unintended and uncontrolled database
access.
To create the user informix, group informix, and informix product directory:
1. Create a group called informix in the group file (/etc/group on most
UNIX-based systems).
Generally, you should provide a unique group number that is greater than or
equal to 100. If necessary, see your system administrator or operating-system
manual for assistance.
2. Add a new user called informix to the /etc/passwd file and assign the user to
the group informix.
Generally, you should provide a user ID number greater than or equal to 100
for that user and include a password for user informix.
3. If you are using a network, propagate the new user name to all systems on the
network. For example, you (or the network administrator) might need to run
the ypmake utility.
4. By default, the software is installed in /usr/informix. If you decide to use a
different directory, substitute that directory path and name throughout this
documentation whenever you see /usr/informix. Create a directory for your
4GL software by entering a command such as the following:
mkdir /usr/informix
For more information about setting Informix environment variables, see the IBM
Informix Guide to SQL: Reference and the IBM Informix 4GL Web Services
Administration Guide.
You must run the environment variables in the windows from which you are
running an IBM Informix product. You can then source the file to set the
environment variables.
Before you begin your 4GL installation, you need the following:
v IBM Informix 4GL software product media or downloaded files
v Your device name
Important: To run the 4GL compiler, you must have a C compiler installed on
your computer. A C compiler is not included with this product.
where pathname is the full path to the .tar file for the product on the CD.
For example:
/cd/ibm/i4gl/4gl.tar
The following table provides the specific .tar file names for your 4GL
product:
Table 1-4. 4GL product .tar file names
Product .tar file name
4GL C Compiler c4gl
4GL Interactive Debugger 4glid
4GL Rapid Development System 4glrds
5. Enter the installation command for the first 4GL product that you want to
install.
For example, to install the 4GL C Compiler, enter the following command:
./install4gl
The following table provides the specific installation command for your 4GL
product:
Table 1-5. 4GL product installation commands
Product Installation command
4GL C Compiler ./install4gl
4GL Interactive Debugger ./install4db
4GL Rapid Development System ./install4gp
You can view the publications in Adobe Portable Document Format (PDF) by using
the Adobe Acrobat Reader.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not grant you
any license to these patents. You can send license inquiries, in writing, to:
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law: INTERNATIONAL
BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS"
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
PURPOSE. Some states do not allow disclaimer of express or implied warranties in
certain transactions, therefore, this statement may not apply to you.
Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
IBM Corporation
J46A/G4
555 Bailey Avenue
San Jose, CA 95141-1003
U.S.A.
The licensed program described in this document and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement or any equivalent agreement
between us.
All statements regarding IBM's future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.
All IBM prices shown are IBM's suggested retail prices, are current and are subject
to change without notice. Dealer prices may vary.
This information is for planning purposes only. The information herein is subject to
change before the products described become available.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.
COPYRIGHT LICENSE:
Each copy or any portion of these sample programs or any derivative work, must
include a copyright notice as follows:
© (your company name) (year). Portions of this code are derived from IBM Corp.
Sample Programs.
© Copyright IBM Corp. _enter the year or years_. All rights reserved.
If you are viewing this information softcopy, the photographs and color
illustrations may not appear.
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or other companies.
A current list of IBM trademarks is available on the web at "Copyright and
trademark information" at http://www.ibm.com/legal/copytrade.shtml.
Adobe, the Adobe logo, and PostScript are either registered trademarks or
trademarks of Adobe Systems Incorporated in the United States, and/or other
countries.
Java and all Java-based trademarks and logos are trademarks or registered
trademarks of Oracle and/or its affiliates.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Notices B-3
B-4 IBM Informix 4GL Installation Guide
Printed in USA
GC23-9597-02