SQL Ref

Informix Guide to SQL
Reference
Version 7.1
December 1994
Part No. 000-7632
Published by INFORMIX Press
Informix Software, Inc.

4100 Bohannon Drive
Menlo Park, CA 94025
The following are worldwide trademarks of Informix Software, Inc., or its subsidiaries, registered in the
United States of America as indicated by an , and in numerous other countries worldwide:
INFORMIX; C-ISAM
The following are worldwide trademarks of the indicated owners or their subsidiaries, registered in the
United States of America as indicated by an , and in numerous other countries worldwide:
X/Open Company Ltd.: UNIX; X/Open
Adobe Systems Incorporated: PostScript
Micro Focus Ltd.: Micro Focus; Micro Focus COBOL/2
Some of the products or services mentioned in this document are provided by companies other than Informix.
These products or services are identified by the trademark or servicemark of the appropriate companies. If you
have a question about one of these products or services, please contact the company in question directly.
Documentation Team:
Sally Cox, Mary Kraemer, Geeta Karmarkar, Steve Klitzing, Catherine Lyman,
Judith Sherwood, Eileen Wollam
Copyright 1981-1994 by Informix Software, Inc. All Rights Reserved.

No part of this work covered by the copyright hereon may be reproduced or used in any form or by any
meansgraphic, electronic, or mechanical, including photocopying, recording, taping, or information storage
and retrieval systemswithout permission of the publisher.
RESTRICTED RIGHTS LEGEND
Software and accompanying materials acquired with United States Federal Government funds or intended for
use within or for any United States federal agency are provided with Restricted Rights as defined in DFARS
252.227-7013(c)(1)(ii) or FAR 52.227-19.
ii
Informix Guide to SQL: Reference
Preface
The Informix Guide to SQL: Reference is intended to be used as a companion

volume to the Informix Guide to SQL: Tutorial and the Informix Guide to SQL:
Syntax. Like the other books in this series, this book is written for people who
use SQL. It assumes that you already know how to use computers and who
rely on them in their daily work.
Whereas the Informix Guide to SQL: Tutorial explains the philosophy and
concepts behind relational databases, this volume and the Informix Guide to
SQL: Syntax are references that you can use on a daily basis after you finish
reading and experimenting with the Informix Guide to SQL: Tutorial. The
Informix Guide to SQL: Tutorial contains material that you need to know when
writing SQL-based applications with an Informix product.
You must have the following Informix software:
An INFORMIX-OnLine Dynamic Server database server or an

INFORMIX-SE database server.
The database server either must be installed on your computer or on
another computer to which your computer is connected over a
network.
Either an Informix application development tool, such as

INFORMIX-4GL; an SQL application programming interface (API),
such as INFORMIX-ESQL/C; or the DB-Access database access utility,
which is shipped as part of your database server.
The application development tool, the SQL API, or DB-Access enables
you to compose queries, send them to the database server, and view
the results that the database server returns.
Preface
iii
Summary of Chapters
Summary of Chapters
The Informix Guide to SQL: Reference includes the following chapters:
iv
This Preface provides general information about the manual and lists
additional reference materials that will help you understand Structured Query Language (SQL) concepts.
The Introduction describes the Informix family of products and manuals, explains how to use this manual, introduces the demonstration
database from which the product examples are drawn, and lists the
new features for Version 7.1 of Informix database server products.
Chapter 1, Informix Databases, explains differences between the

INFORMIX-OnLine Dynamic Server and INFORMIX-SE database servers, provides information about ANSI compliance in Informix databases, and provides a discussion of the Native Language Support
(NLS).
Chapter 2, System Catalog, provides details of the Informix system

catalog, which is a collection of system catalog tables that describe
the structure of the stores7 and other Informix databases. The chapter explains how to access and update statistics in the system catalog,
shows the system catalog structure, and lists the name and data type
for each column in each table. This chapter also include information
about Information Schema Views.
Chapter 3, Data Types, defines the column data types supported

by Informix products, tells how to convert between different data
types, and describes how to use specific values in arithmetic and
relational expressions.
Chapter 4, Environment Variables, describes the various environment variables that you can or should set to properly use your Informix products. These variables identify your terminal, specify the
location of your software, and define other parameters of your product environment.
Chapter 5, SQL Utilities, contains the syntax and usage of the user
utilities. These utilities allow you to import and export data to your
databases, load files, and perform other tasks.
Appendix A, The stores7 Database, describes the structure and

contents of the stores7 demonstration database that is installed with
the Informix database server products. It includes a map of the nine
Informix Welcomes Your Comments
tables in the database, illustrates the columns on which they are

joined, and displays the data in them.
A glossary of common database terms follows the chapters, and a

comprehensive index directs you to areas of particular interest.
Informix Welcomes Your Comments

A reader-response card is provided with this manual. Please use this card to
tell us what you like or dislike about this manual. To help us with future versions of the manual, please tell us about any corrections or clarifications that
you might find useful. Return this card to:
Technical Publications Department
4100 Bohannon Drive
Menlo Park, CA 94025
If you prefer to share your comments on-line, address your e-mail to:
doc@informix.com
Related Reading
If you want additional technical information on database management,
consult the following books. The first book is an introductory text for readers
who are new to database management, while the second book is a more complex technical work for SQL programmers and database administrators.
Database: A Primer by C. J. Date (Addison-Wesley Publishing, 1983)
An Introduction to Database Systems by C. J. Date (Addison-Wesley

Publishing, 1994).
Preface
Related Reading
If you are interested in learning more about the SQL language, consider the
following books:
A Guide to the SQL Standard by C.J. Date with H. Darwen (AddisonWesley Publishing, 1993)
Understanding the New SQL: A Complete Guide by J. Melton and A.

Simon (Morgan Kaufmann Publishers, 1993)
Using SQL by J. Groff and P. Weinberg (Osborne McGraw-Hill, 1990)
This manual assumes that you are familiar with your computer operating
system. If you have limited UNIX system experience, you might want to look
at your operating system manual or a good introductory text before you read
this manual. Some texts about UNIX systems are suggested in the following
list:
Introducing the UNIX System by H. McGilton and R. Morgan

(McGraw-Hill Book Company, 1983)
Learning the UNIX Operating System, by G. Todino, J. Strang, and

J. Peek (OReilly & Associates, 1993)
A Practical Guide to the UNIX System, by M. Sobell

(Benjamin/Cummings Publishing, 1989)
UNIX for People by P. Birns, P. Brown, and J. Muster (Prentice-Hall,
1985)
UNIX System V: A Practical Guide by M. Sobell (Benjamin/Cummings
Publishing, 1995)
vi
Table of
Contents
Table of Contents
Introduction
Chapter 1
Informix Products That Use SQL .
Products Covered in This Manual .
Other Useful Documentation
How to Use This Manual . . .

Typographical Conventions
Command-Line Conventions
Example Code Conventions
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
5
5
6
9
Useful On-Line Files
10
ASCII and PostScript Error Message Files .
10
The Demonstration Database . . . . .

Creating the Demonstration Database .
.
.
.
.
.
.
11
12
Compliance with Industry Standards
14
New Features in Informix Version 7.1 Products

That Use SQL . . . . . . . . . .
14
.
.
.
.
.
.
.
1-3
1-4
1-5
1-5
1-5
1-6
1-7
Informix Databases
Choosing a Database Server . . . . . .
Data Types . . . . . . . . . .
Rolling Back Statements in a Transaction
Transaction Logging . . . . . . .
Table and Index Fragmentation . . .
Locking Issues . . . . . . . . .
Isolation Level . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
System Catalog Tables . . . . . .

SQL Statements Supported by Specific
Database Servers . . . . .
Chapter 2
viii
1-8
1-8
Using ANSI-Compliant Databases . . . . . . .

Differences between ANSI-Compliant Databases
and Databases that are not
ANSI-Compliant . . . . . . . .
1-10
Using Native Language Support . . . . . . .

Activating NLS . . . . . . . . . . . .
NLS Data Types . . . . . . . . . . . .
NLS Versus Non-NLS Databases and
Database Servers . . . . . . . .
1-16
1-18
1-22
1-12
1-22
System Catalog
Objects Tracked by the System Catalog Table .
2-3
Using the System Catalog . . . .

Accessing the System Catalog .
Updating System Catalog Data
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2-4
2-10
2-11
Structure of the System Catalog

SYSBLOBS . . . . . .
SYSCHECKS . . . . . .
SYSCOLAUTH . . . . .
SYSCOLDEPEND . . . .
SYSCOLUMNS . . . . .
SYSCONSTRAINTS . . .
SYSDEFAULTS . . . . .
SYSDEPEND . . . . . .
SYSDISTRIB . . . . . .
SYSFRAGMENTS . . . .
SYSINDEXES. . . . . .
SYSOPCLSTR . . . . .
SYSPROCAUTH . . . .
SYSPROCBODY. . . . .
SYSPROCEDURES . . . .
SYSPROCPLAN. . . . .
SYSREFERENCES . . . .
SYSSYNONYMS . . . .
SYSSYNTABLE . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2-12
2-13
2-14
2-15
2-16
2-17
2-20
2-22
2-23
2-24
2-25
2-26
2-29
2-31
2-32
2-33
2-34
2-35
2-36
2-36
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
SYSTABAUTH
SYSTABLES .
SYSTRIGBODY
SYSTRIGGERS
SYSUSERS . .
SYSVIEWS . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2-38
2-39
2-42
2-43
2-44
2-44
2-45
Information Schema . . . . . . . . . . . .
Generating the Information Schema Views. . .
Accessing the Information Schema Views . . .
Structure of the Information Schema Views . .
2-47
2-47
2-48
2-48
System Catalog Map
Chapter 3
.
.
.
.
.
.
Data Types
Database Data Types . . . .
Effects of NLS. . . . . .
Summary of Data Types . .
BYTE. . . . . . . . .
CHAR(n) . . . . . . .
CHARACTER(n) . . . .
CHARACTER VARYING(m,r)
DATE . . . . . . . .
DATETIME . . . . . .
DEC . . . . . . . . .
DECIMAL . . . . . . .
DOUBLE PRECISION . . .
FLOAT(n) . . . . . . .
INT . . . . . . . . .
INTEGER . . . . . . .
INTERVAL. . . . . . .
MONEY(p,s) . . . . . .
NCHAR(n) . . . . . .
NUMERIC(p,s) . . . . .
NVARCHAR(m,r) . . . .
REAL . . . . . . . .
SERIAL(n) . . . . . . .
SMALLFLOAT . . . . .
SMALLINT . . . . . .
TEXT. . . . . . . . .
VARCHAR(m,r) . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3-3
3-3
3-4
3-5
3-6
3-7
3-8
3-9
3-9
3-12
3-13
3-15
3-15
3-15
3-16
3-16
3-19
3-20
3-21
3-21
3-23
3-23
3-24
3-24
3-25
3-26
Table of Contents
ix
Data Type Conversions . . . . . . . . . . .

Converting from Number to Number . . . . .
Converting Between Number and CHAR . . .
Converting Between DATE and DATETIME . .
Range of Operations Using DATE, DATETIME,
and INTERVAL . . . . . . . . . . .
Manipulating DATETIME Values . . . . . .
Manipulating DATETIME with INTERVAL Values
Manipulating DATE with DATETIME and
INTERVAL Values . . . . . . . .
Manipulating INTERVAL Values . . . . . .
Multiplying or Dividing INTERVAL Values. . .
Chapter 4
3-30
3-32
3-33
3-34
3-36
3-36
Environment Variables
Types of Environment Variables .
3-28
3-28
3-29
3-30
4-5
Where to Set Environment Variables . . . .

Setting Environment Variables at the
System Prompt. . . . . . . .
Setting Environment Variables in a
Environment Configuration File . .
Setting Environment Variables at Login Time
4-6
4-6
. .
. .
4-6
4-7
Manipulating Environment Variables . . .

Setting Environment Variables . . . .
Viewing Your Current Settings . . . .
Unsetting Environment Variables . . .
Modifying the Setting of an Environment
Variable . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
4-8
4-8
4-9
4-9
4-9
Rules of Precedence .
4-10
NLS Environment Variables . . . . . . .

Rules of Precedence for NLS Environment
Variables . . . . . . . . . .
4-11
4-11
UNIX Environment Variables .
4-11
List of Environment Variables .
4-12
Environment Variables . .
ARC_DEFAULT . . .
ARC_KEYPAD . . .
COLLCHAR . . . .
DBANSIWARN . . .
DBAPICODE . . . .
DBBLOBBUF . . . .
DBDATE . . . . .
DBDELIMITER . . .
DBEDIT. . . . . .
DBLANG . . . . .
DBMONEY . . . .
DBNLS . . . . . .
DBPATH . . . . .
DBPRINT . . . . .
DBREMOTECMD . .
DBSPACETEMP . . .
DBTEMP . . . . .
DBTIME . . . . .
DBUPSPACE . . . .
DELIMIDENT . . .
ENVIGNORE . . . .
FET_BUF_SIZE . . .
INFORMIXC . . . .
INFORMIXCOB . . .
INFORMIXCOBDIR .
INFORMIXCOBSTORE
INFORMIXCOBTYPE .
INFORMIXCONRETRY
INFORMIXCONTIME.
INFORMIXDIR . . .
INFORMIXSERVER .
INFORMIXSHMBASE.
INFORMIXSTACKSIZE
INFORMIXTERM . .
LANG . . . . . .
LC_COLLATE . . .
LC_CTYPE. . . . .
LC_MONETARY . .
LC_NUMERIC . . .
LC_TIME . . . . .
ONCONFIG . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
4-15
4-15
4-15
4-16
4-18
4-19
4-20
4-21
4-23
4-23
4-24
4-25
4-26
4-28
4-31
4-32
4-33
4-34
4-34
4-37
4-38
4-38
4-39
4-40
4-40
4-41
4-42
4-43
4-43
4-44
4-46
4-46
4-47
4-48
4-49
4-49
4-51
4-53
4-55
4-56
4-57
4-59
Table of Contents
xi
OPTCOMPIND .
PATH . . . . .
PDQPRIORITY .
PSORT_DBTEMP .
PSORT_NPROCS .
SQLEXEC . . .
SQLRM . . . .
SQLRMDIR . . .
TERM . . . . .
TERMCAP . . .
TERMINFO . . .
Chapter 5
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
4-59
4-60
4-61
4-62
4-63
4-64
4-65
4-65
4-66
4-66
4-67
Index of Environment Variables .
4-68
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
5-4
The crtcmap Utility . . . . . .

Creating Mapping Files for NLS.
.
.
.
.
.
.
.
.
.
.
.
.
5-5
5-5
The dbexport Utility . . . . . . . . . . . .

Unloading a Database and Its Schema File . . .
Using dbexport with NLS . . . . . . . . .
5-9
5-10
5-14
The dbimport Utility . . . . . . . .

Building a Database from ASCII Files
Created by dbexport . . . .
Changing the Database Name . . .
Using dbimport with NLS . . . .
SQL Utilities
The chkenv Utility
xii
.
.
.
.
.
.
.
.
.
.
.
5-15
.
.
.
.
.
.
.
.
.
.
.
.
5-16
5-21
5-22
The dbload Utility . . . . . . . . . . . .

Loading Data from a Command File into a Table .
Creating a dbload Command File . . . . . .
5-23
5-25
5-29
The dbschema Utility . . . . . . . . . . .

Creating the Schema for a Database . . . . .
Displaying the Distribution Information
for Tables. . . . . . . . . . . .
5-40
5-42
5-47
Appendix A
The stores7 Database

Structure of the Tables . . . . . . . . . . .
The customer Table . . . . . . . . . . .
The orders Table . . . . . . . . . . . .
The items Table . . . . . . . . . . . .
The stock Table . . . . . . . . . . . .
The catalog Table . . . . . . . . . . .
The cust_calls Table . . . . . . . . . .
The call_type Table . . . . . . . . . . .
The manufact Table. . . . . . . . . . .
The state Table . . . . . . . . . . . .
2
2
3
4
4
5
6
6
7
7
The stores7 Database Map
Primary-Foreign Key Relationships .

The customer and orders Tables .
The orders and items Tables. . .
The items and stock Tables . . .
The stock and catalog Tables . .
The stock and manufact Tables. .
The cust_calls and customer Tables
The call_type and cust_calls Table
The state and customer Tables . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
9
9
10
11
12
13
14
15
16
Data in the stores7 Database .
16
Glossary
Index
Table of Contents
xiii
Introduction
Introduction
Informix Products That Use SQL .
Products Covered in This Manual.
Other Useful Documentation .
How to Use This Manual . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
5
5
6
8
Useful On-Line Files .
ASCII and PostScript Error Message Files .
10
The Demonstration Database . . . . .

Creating the Demonstration Database .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
11
12
14

That Use SQL . . . . . . . . . .
14
tructured Query Language (SQL) is an English-like language that

you can use when creating, managing, and using relational databases. The
SQL provided with Informix products is an enhanced version of the industrystandard query language developed by International Business Machines
Corporation (IBM).
In addition to SQL, Informix provides the Stored Procedure Language (SPL)
with which you can write stored procedures. Stored procedures are programs
that are stored as database objects.
Informix Products That Use SQL

Informix produces many application development tools and SQL application
programming interfaces (API). Application development tools currently
available include products such as INFORMIX-SQL, INFORMIX-4GL, and
INFORMIX-NewEra. SQL APIs currently available include INFORMIX-ESQL/C
and INFORMIX-ESQL/COBOL.
The INFORMIX-NewEra development environment can access Informix
database servers directly through embedded SQL statements as well as
through the call-level interface of the CCL/INFORMIX and CCL/ODBC
function libraries.
Informix products work with a database server, either INFORMIX-OnLine
Dynamic Server, INFORMIX-SE, or an INFORMIX-Gateway product. The
DB-Access database access utility is shipped as a part of each database server.
If you are running client applications developed with Version 4.1 and 5.0
application development tools, you use INFORMIX-NET to connect the client
to the network.
Introduction
Products Covered in This Manual
Products Covered in This Manual

All the information presented in this manual is valid for the following products. Differences in their use of SQL are indicated where appropriate.
INFORMIX-ESQL/C, Version 7.1
INFORMIX-ESQL/COBOL, Version 7.1
INFORMIX-OnLine Dynamic Server, Version 7.1
INFORMIX-SE, Version 7.1
INFORMIX-Enterprise Gateway, Version 7.1
Other Useful Documentation

You can refer to the following related Informix documents that complement
this manual:
A companion volume to the Reference, the Informix Guide to SQL:

Tutorial, provides a tutorial on SQL as it is implemented by Informix
products. It describes the fundamental ideas and terminology that
are used when planning, using, and implementing a relational
database.
An additional companion volume to the Reference, the Informix

Guide to SQL: Syntax, provides a detailed description of all the SQL
statements supported by Informix products. This guide also provides a detailed description of Stored Procedure Language (SPL)
statements.
The SQL Quick Syntax Guide contains syntax diagrams for all statements and segments described in this manual.
You, or whoever installs your Informix products, should refer to the

UNIX Products Installation Guide for your particular release to ensure
that your Informix product is properly set up before you begin to
work with it. A matrix depicting possible client/server configurations is included in the UNIX Products Installation Guide.
How to Use This Manual
Depending on the database server you are using, you or your system
administrator need either the INFORMIX-SE Administrators Guide or
the INFORMIX-OnLine Dynamic Server Administrators Guide.
The DB-Access User Manual describes how to invoke the DB-Access

utility to access, modify, and retrieve information from Informix
database servers.
When errors occur, you can look them up by number and learn their
cause and solution in the Informix Error Messages manual. If you prefer, you can look up the error messages in the on-line message file
described in the section ASCII and PostScript Error Message Files
later in this Introduction and in the Introduction to the Informix Error
Messages manual.
How to Use This Manual

This manual assumes that you are using INFORMIX-OnLine Dynamic Server
as your database server. Features and behavior specific to INFORMIX-SE are
noted throughout the manual.
The following sections describe the conventions used in this manual for
typographical format, syntax, and examples of code.
Informix product manuals use a standard set of conventions to introduce
new terms, illustrate screen displays, describe command syntax, and so on.
The following typographical conventions are used throughout this manual:
italics
New terms, emphasized words, and variables are

printed in italics.
boldface
Database names, table names, column names, file

names, utilities, and other similar terms are printed in
boldface.
Introduction
computer
Information that OnLine displays and information that

you enter is printed in a computer typeface.
KEYWORD
All keywords appear in uppercase letters.
The diamond symbol appears at the beginning and the

end of product-specific information.
This symbol indicates a unique identifier (primary key)
for each table.
This symbol indicates a warning. Warnings provide critical information that, if ignored, could cause harm to
your database.
This symbol indicates important information that you
should consider when working with the product.
This symbol indicates a tip. It alerts you to useful information that, for instance, might indicate a shortcut or
make it easier to navigate in the product or manual.
Additionally, when you are instructed to enter or execute text, immediately press RETURN after the entry. When you are instructed to type the text
or press a key, no RETURN is required.
This section defines and illustrates the format of the commands available in
Informix products. These commands have their own conventions, which
may include alternative forms of a command, required and optional parts of
the command, and so on.
Each diagram displays the sequences of required and optional elements that
are valid in a command. A diagram begins at the upper left with a command.
It ends at the upper right with a vertical line. Between these points, you can
trace any path that does not stop or back up. Each path describes a valid form
of the command. You must supply a value for words that are in italics.
6
Along a command-line path, you might encounter the following elements:

command
variable
-flag
.ext
(.,;+*-/)
' '
Privileges
p. XXX
ALL
This required element is usually the product

name or other short word used to invoke the
product or call the compiler or preprocessor
script for a compiled Informix product. It might
appear alone or precede one or more options.
You must spell a command exactly as shown
and must use lowercase letters.
A word in italics represents a value that you
must supply. The nature of the value is
explained immediately following the diagram
unless the variable appears in a box. In that case,
the page number of the detailed explanation follows the variable name.
A flag is usually an abbreviation for a function,
menu, or option name or for a compiler or preprocessor argument. You must enter a flag
exactly as shown, including the preceding
hyphen.
A filename extension, such as .sql or .cob, might
follow a variable representing a filename. Type
this extension exactly as shown, immediately
after the name of the file and a period. The
extension might be optional in certain products.
Punctuation and mathematical notations are literal symbols that you must enter exactly as
shown.
Single quotes are literal symbols that you must
enter as shown.
A reference in a box represents a subdiagram on
the same page (if no page number is supplied)
or on a specified page. Imagine that the subdiagram is spliced into the main diagram at this
point.
A shaded option is the default. Even if you do
not explicitly type the option, it will be in effect
unless you choose another option.
Syntax enclosed in a pair of arrows indicates
that this is a subdiagram.
Introduction
IN
The vertical line is a terminator and indicates

that the statement is complete.
A branch below the main line indicates an
option
NOT
,
variable
column
A loop indicates a path that can be repeated.

Punctuation along the top of the loop indicates
the separator symbol for list items.
A gate ( 1 ) in an option indicates that
you can only use that option once,
even if it is within a larger loop.
key
Figure 1 shows how to read the command-line diagram for setting the
DBMONEY environment variable in a C shell:
Figure 1
Elements of a command-line diagram
setenv
DBMONEY
'$'
front
back
To construct a correct command, start at the top left with the command
setenv. Then follow the diagram to the right, including the elements that you
want. The elements in the diagram are case-sensitive. This diagram conveys
the following information:
1.
You must type the command setenv.
2.
You must supply the keyword DBMONEY.
3.
You must choose either the $ or another front symbol.
4.
You must choose either the period or comma as the symbol that separates the integral from the fractional part of the money value.
5.
You can specify a back option or no back option.
6.
After your back option choice, you come to the terminator. Your
setenv command is complete. Press RETURN to execute the
command.
As shown in the following example, you can set the DBMONEY environment
variable for Canadian currency using the string $CAN for front, using the
period as the separator, and omitting the back option:
setenv DBMONEY '$CAN'.

Examples of SQL code occur throughout this manual. Except where noted,
the code is not specific to any single Informix application development tool.
If only SQL statements are listed in the example, they are not delineated by
semicolons. To use this SQL code for a specific product, you must apply the
syntax rules for that product. For example, if you are using the Querylanguage option of DB-Access, you must delineate multiple statements with
semicolons. If you are using an SQL API, you must use EXEC SQL and a semicolon (or other appropriate delimiters) at the start and end of each statement,
respectively.
For instance, you might see the code in the following example:
CONNECT TO stores7
.
.
.
DELETE FROM customer
WHERE customer_num = 121
.
.
.
COMMIT WORK
DISCONNECT CURRENT
For detailed directions on using SQL statements for a particular application

development tool or SQL API, see the manual for your product.
Also note that dots in the example indicate that more code would be added
in a full application, but it is not necessary to show it to describe the concept
being discussed.
Introduction

In addition to the Informix set of manuals, the following on-line files, located
in the $INFORMIXDIR/release directory, might supplement the information
in this manual:
Documentation
Notes
Release Notes
Machine Notes
describe features not covered in the manual or that have

been modified since publication. The file containing the
Documentation Notes for this product is called
SQLRDOC_7.1.
describe feature differences from earlier versions of
Informix products and how these differences might
affect current products. The file containing the Release
Notes for Version 7.1 of Informix database server products is called SERVERS_7.1.
describe any special actions required to configure and
use Informix products on your computer. Machine
Notes are named for the product described, for example, the Machine Notes file for INFORMIX-OnLine
Dynamic Server is ONLINE_7.1.
Please examine these files because they contain vital information about
application and performance issues.
ASCII and PostScript Error Message Files

Informix software products provide ASCII files that contain all the Informix
error messages and their corrective actions. To access the error messages in
the ASCII file, Informix provides scripts that let you display error messages
on the screen (finderr) or print formatted error messages (rofferr). See the
Introduction to the Informix Error Messages manual for a detailed description
of these scripts.
The optional Informix Messages and Corrections product provides
PostScript files that contain the error messages and their corrective actions.
If you have installed this product, you can print the PostScript files on a
10
The Demonstration Database
PostScript printer. The PostScript error messages are distributed in a number

of files of the format errmsg1.ps, errmsg2.ps, and so on. These files are
located in the $INFORMIXDIR/msg directory.
The Demonstration Database

The DB-Access utility, which is provided with your Informix database server
products, includes a demonstration database called stores7 that contains
information about a fictitious wholesale sporting-goods distributor. The sample command files that make up a demonstration application are also
included.
Most examples in this manual are based on the stores7 demonstration database. The stores7 database is described in detail and its contents are listed in
Appendix A.
The script that you use to install the demonstration database is called
dbaccessdemo7 and is located in the $INFORMIXDIR/bin directory. The
database name that you supply is the name given to the demonstration database. If you do not supply a database name, the name defaults to stores7. Use
the following rules for naming your database:
Names can be up to 18 characters long for INFORMIX-OnLine

Dynamic Server databases and up to 10 characters long for
INFORMIX-SE databases.
The first character of a name must be a letter or an underscore (_).
You can use letters, characters, and underscores (_) for the rest of the
name.
DB-Access makes no distinction between uppercase and lowercase
letters.
The database name must be unique.
When you run dbaccessdemo7, you are, as the creator of the database, the
owner and Database Administrator (DBA) of that database.
If you install your Informix database server according to the installation
instructions, the files that comprise the demonstration database are protected
so you cannot make any changes to the original database.
Introduction
11
Creating the Demonstration Database
You can run the dbaccessdemo7 script again whenever you want to work
with a fresh demonstration database. The script prompts you when the creation of the database is complete and asks if you would like to copy the sample command files to the current directory. Enter N if you have made changes
to the sample files and do not want them replaced with the original versions.
Enter Y if you want to copy over the sample command files.

Use the following steps to create and populate the demonstration database:
1.
Set the INFORMIXDIR environment variable so that it contains the

name of the directory in which your Informix products are installed.
Set INFORMIXSERVER to the name of the default database server.
The name of the default database server must exist in the $INFORMIXDIR/etc/sqlhosts file. (For a full description of environment variables, see Chapter 4, Environment Variables.) For information
about sqlhosts, see the INFORMIX-OnLine Dynamic Server Administrators Guide or the INFORMIX-SE Administrators Guide.
2.
Create a new directory for the SQL command files. Create the directory by entering the following command:
3.
Make the new directory the current directory by entering the following command:
mkdir dirname
cd dirname
12
4.
Create the demonstration database and copy over the sample command files by entering the dbaccessdemo7 command.
To create the database without logging enter the follwoing
command:
dbaccessdemo7 dbname
To create the demonstration database with logging enter the following command:
dbaccessdemo7 -log dbname
If you are using INFORMIX-OnLine Dynamic Server, by default the

data for the database is put into the root dbspace. If you wish, you
can specify a dbspace for the demonstration database.
To create a demonstration database in a particular dbspace enter the
following command:
dbaccessdemo7 dbname -dbspace dbspacename
You can specify all the options in one command as shown in the following command:
dbaccessdemo7 -log dbname -dbspace dbspacename
If you are using INFORMIX-SE, a subdirectory called dbname.dbs is

created in your current directory and the database files associated
with stores7 are placed there. You will see both data (.dat) and index
(.idx) files in the dbname.dbs directory. (If you specify a dbspace
name, it will be ignored.)
To use the database and the command files that have been copied to
your directory, you must have UNIX read and execute permissions
for each directory in the pathname of the directory from which
you ran the dbaccessdemo7 script. Check with your system
administrator for more information about operating-system file
and directory permissions. UNIX permissions are discussed in the
INFORMIX-OnLine Administrators Guide and the INFORMIX-SE Administrators Guide
5.
To give someone else the permissions to access the command files in

your directory, use the UNIX chmod command.
6.
To give someone else the access to the database that you have created, grant them the appropriate privileges using the GRANT statement. To remove privileges, use the REVOKE statement. The GRANT
and REVOKE statements are described in Chapter 1 of the Informix
Guide to SQL: Syntax.
Introduction
13

The American National Standards Institute (ANSI) has established a set of
industry standards for SQL. Informix SQL-based products are fully compliant
with SQL-92 Entry Level (published as ANSI X3.l35-1992), which is identical to
ISO 9075:1992 on INFORMIX-OnLine Dynamic Server. In addition, many features of OnLine comply with the SQL-92 Intermediate and Full Level and
X/Open CAE (common applications environment) standards.
Informix SQL-based products are compliant with ANSI SQL-92 Entry Level
(published as ANSI X3.135-1992) on INFORMIX-SE with the following
exceptions:
Effective checking of constraints
Serializable transactions

That Use SQL
The Introduction to each Version 7.1 product manual contains a list of new
features for that product. The Introduction to each manual in the Version 7.1
Informix Guide to SQL series contains a list of new SQL features.
A comprehensive list of all the new features for Version 7.1 Informix products
is in the Release Notes file called SERVERS_7.1.
This section highlights the major new features implemented in Version 7.1 of
Informix products that use SQL.
New FRAGMENT BY clause in the CREATE TABLE statement

The CREATE TABLE statement contains a new FRAGMENT BY clause
that allows you to create fragmented tables. Fragmentation enables
you to define groups of rows within a table based on a rule and to
specify a separate dbspace for each group.
14
New Features in Informix Version 7.1 Products That Use SQL
New FRAGMENT BY EXPRESSION clause in the CREATE INDEX

statement
The CREATE INDEX statement contains a new FRAGMENT BY
EXPRESSION clause that allows you to create fragmented indexes.
New ALTER FRAGMENT statement

You can use the ALTER FRAGMENT statement to dynamically alter an
existing table or index-fragmentation strategy as well as to initially
create fragments.
New ADD ROWIDS and DROP ROWIDS clauses in the ALTER TABLE
statement
You can use the ADD ROWIDS clause to add the rowid column to
fragmented tables. You can use the DROP ROWIDS clause to drop the
rowid column from a fragmented table that has a rowid column.
New FRAGMENTS keyword in INFO statement

The FRAGMENTS keyword allows you to display the dbspace names
where fragments are located for a specified table.
New SET DATASKIP statement

The SET DATASKIP statement allows you to control whether
INFORMIX-OnLine Dynamic Server skips any dbspaces in the fragmentation list that are unavailable while a transaction is being
processed.
New sysfragments system catalog table

The sysfragments table stores fragmentation information for tables
and indexes.
New SET PDQPRIORITY statement

The SET PDQPRIORITY statement supports the parallel-data-query
(PDQ) functionality. PDQ allows queries to be processed in parallel.
The SET PDQPRIORITY statement allows an application to set the
query priority level dynamically within the application. The query
priority level refers to the degree of parallelism to be used for
queries.
New output in the SET EXPLAIN statement

The output of the SET EXPLAIN statement has been enhanced to support the new fragmentation and PDQ features.
Introduction
15
Changes to the dbexport and dbschema utilities

The dbexport and dbschema utilities have been enhanced to support
the new fragmentation and PDQ features.
New SET TRANSACTION statement

You can now use the ANSI isolation levels for transactions. In addition, the SET TRANSACTION statement permits you to use read-only
and read-write access modes.
New TRIM function

The TRIM function allows you to strip leading characters or blanks,
trailing characters or blanks, or both from a character string.
Support for Delimited Identifiers

Delimited identifiers allow you to specify as identifiers character
strings that are otherwise identical to SQL reserved keywords. They
also allow you to specify nonalphanumeric characters in database
object names. This feature is only activated when the DELIMIDENT
environment variable is set.
WITH REOPTIMIZATION clause for the OPEN CURSOR statement
The WITH REOPTIMIZATION clause allows you to reoptimize a query

plan if that query plan becomes deoptimized.
INTO clause for the EXECUTE statement
The INTO clause allows you to execute a prepared singleton select

statement or execute a prepared EXECUTE PROCEDURE statement. In
addition, you can specify output variables using the INTO clause.
New Environment Variables

The following environment variables, described in Chapter 4, Environment Variables, are new in Version 7.1:
16
DBBLOBBUF
DELIMIDENT
BUF_FET_SIZE
OPTCOMPIND
PDQPRIORITY
XPG4 SQL CAE compliance
X/Open information schemas
The information schema consists of a set of read-only views from

which you can retrieve information about any tables, views, and
columns to which you have access.
Support for CHARACTER VARYING syntax

The CHARACTER VARYING data type syntax, which is compliant
with XPG4 and ANSI, performs like the Informix data type
VARCHAR. The data type supports both a maximum and minimum length.
Specification of cursors as READ ONLY

You can specify cursors as READ ONLY with the DECLARE
statement.
Optional specification of RESTRICT/CASCADE on the DROP

TABLE, DROP VIEW, and REVOKE statements
You can now restrict drop and revoke actions with the RESTRICT
keyword. Previously, all drop requests to tables and views and
revoke requests cascaded to drop all related tables, views, and
permissions. Now you can specify the RESTRICT keyword on
these statements to disallow the drop or revoke.
Hexadecimal load/unload format

This feature allows the LOAD/UNLOAD statements, as well as the
dbexport, dbimport, and dbload utilities, to format the nonprintable
ASCII characters in hexadecimal format. It affects the formats of
unload files if the CHAR/VARCHAR NCHAR/NVARCHAR data types
contain nonprintable ASCII characters. It also allows you to load the
nonprintable characters from the file into the database after they are
prepared in hex format.
Introduction
17
Chapter
Informix Databases
Choosing a Database Server . . . . . . . . . . . . .

Data Types . . . . . . . . . . . . . . . . .
Rolling Back Statements in a Transaction . . . . . . .
Transaction Logging . . . . . . . . . . . . . .
Table and Index Fragmentation . . . . . . . . . .
Locking Issues . . . . . . . . . . . . . . . .
Lock Scope . . . . . . . . . . . . . . . .
Lock Mode . . . . . . . . . . . . . . . .
Use of Shared Locks . . . . . . . . . . . . .
Waiting for Locks. . . . . . . . . . . . . .
Isolation Level . . . . . . . . . . . . . . . .
System Catalog Tables . . . . . . . . . . . . .
SQL Statements Supported by Specific Database Servers .
SQL Statements Supported Only by INFORMIX-OnLine
Dynamic Server . . . . . . . . . . .
SQL Statements Containing Branches Specific to
INFORMIX-OnLine Dynamic Server . . . .
SQL Segments Containing Branches Specific to
INFORMIX-OnLine Dynamic Server . . . .
SQL Statements Supported Only by INFORMIX-SE . .
SQL Statements and Segments Containing Branches
Specific to INFORMIX-SE . . . . . . . .
1
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
1-3
1-4
1-5
1-5
1-5
1-6
1-6
1-6
1-7
1-7
1-7
1-8
1-8
1-8
1-9
.
.
.
.
.
.
1-9
1-10
1-10
Using ANSI-Compliant Databases . . . . . . . . . . . .

Designating a Database as ANSI-Compliant . . . . . .
Determining If an Existing Database Is ANSI-Compliant . .
Differences between ANSI-Compliant Databases and Databases
that are not ANSI-Compliant. . . . . . . . . . . .
Transactions . . . . . . . . . . . . . . . . .
Transaction Logging. . . . . . . . . . . . . . .
Owner Naming . . . . . . . . . . . . . . . .
Privileges on Objects . . . . . . . . . . . . . .
.
.
.
1-10
1-11
1-11
.
.
.
.
.
1-12
1-13
1-13
1-13
1-14
Default Isolation Level . . . . . . . . . . . . .

Character Data Types . . . . . . . . . . . . .
Decimal Data Type . . . . . . . . . . . . . .
Escape Characters . . . . . . . . . . . . . .
Cursor Behavior . . . . . . . . . . . . . . .
The SQLCODE Field of the SQL Communications Area .
SQL Statements Allowed with ANSI-Compliant Databases
Synonym Behavior . . . . . . . . . . . . . .
1-2
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
1-14
1-15
1-15
1-15
1-15
1-16
1-16
1-16
Using Native Language Support . . . . . . . . . . . . .

Activating NLS . . . . . . . . . . . . . . . . . .
Setting Environment Variables for NLS . . . . . . . .
Using Environment Variables to Determine the Locale . . .
Determining NLS Functionality for a Session and a Database
NLS Data Types. . . . . . . . . . . . . . . . . .
NLS Versus Non-NLS Databases and Database Servers . . . .
Error Messages Regarding NLS Compatibility . . . . . .
NLS Functionality in Version 6.0 and Later Database
Server and SQL API Products . . . . . . . . .
NLS Functionality in Pre-Version 6.0 Database Server
and SQL API Products . . . . . . . . . . .
.
.
.
.
.
.
.
.
1-16
1-18
1-18
1-20
1-21
1-22
1-22
1-24
1-25
1-26
efore you create a database using an Informix product, you must

make several decisions that affect which features will be available to
applications that use the database. The following major decisions are:
Which database server will house the database: INFORMIX-OnLine

Dynamic Server or INFORMIX-SE?
Does the database need to be ANSI-compliant?
Will the database use characters from a language other than English
in its tables?
This chapter describes the implications of each choice and summarizes how
these choices affect your databases. For many of the features and behaviors
described in this chapter, the specifics of implementation are discussed elsewhere in this Reference, the Informix Guide to SQL: Syntax or in the Informix
Guide to SQL: Tutorial.
Choosing a Database Server

If you have access to both an INFORMIX-OnLine Dynamic Server and an
INFORMIX-SE database server, you must choose one to serve your database.
If you create a database with one database server, you can transfer it later to
the other database server. Informix recommends, however, that you consider
which database server is more appropriate for your needs before you create
and populate the database.
Various factors might influence your choice of database server, for example,
the size of your databases, speed, the need for distributed access, and ease of
installation and maintenance. You should also be aware of differences in the
SQL features that are available on INFORMIX-OnLine Dynamic Server and
INFORMIX-SE. These differences are summarized in this section.
Informix Databases
1-3
Data Types
Your choice of database server decides the following issues for a database:
Which data types are available
Whether data-definition statements can be rolled back
Whether buffered logging is supported
Whether tables can be fragmented
Which locking options are available
Which isolation levels are available
What information is stored in the system catalog tables
Which SQL statements are available
This section summarizes how your choice of database server affects each of
these issues. References are also provided to indicate where you can find
more extended discussions of these issues.
Data Types
INFORMIX-OnLine Dynamic Server supports all the data types available to
INFORMIX-SE as well as the following additional data types:
BYTE
CHARACTER VARYING
TEXT
VARCHAR
NVARCHAR
INFORMIX-SE and INFORMIX-OnLine Dynamic Server also have different

values for the maximum length of CHAR(n) and NCHAR(n) data types.
See Database Data Types on page 3-3 for more information on individual
data types.
1-4

For both database servers, if you have not yet issued a COMMIT WORK
statement for a transaction, the ROLLBACK WORK statement allows you to
undo any changes that occurred since the beginning of that transaction. In
INFORMIX-OnLine Dynamic Server, you can roll back any statement.
If you are using INFORMIX-SE, you cannot undo certain operations with
ROLLBACK WORK. These operations comprise all the data definition statements as well as the GRANT and REVOKE statements. (For a list of the data
definition statements, refer to Chapter 1 of the Informix Guide to SQL: Syntax.)
For a discussion of transactions, refer to Chapter 4 of the Informix Guide to
SQL: Tutorial. See also the description of the ROLLBACK WORK statement in
Chapter 1 of the Informix Guide to SQL: Syntax.
Transaction Logging
INFORMIX-OnLine Dynamic Server supports buffered logging and allows
you to change logging from buffered to unbuffered or unbuffered to buffered

with the SET LOG statement. You can also choose to log or not to log.
INFORMIX-SE does not support buffered logging.
For more information on the SET LOG statement, refer to Chapter 1 of the
Informix Guide to SQL: Syntax. See the INFORMIX-OnLine Dynamic Server
Administrators Guide for more information about buffered and unbuffered
logging.
Table and Index Fragmentation

INFORMIX-OnLine Dynamic Server supports the fragmentation of tables and
indexes. The feature allows you to group rows within a table according to a
distribution scheme. The rows are stored in separate dbspaces that you
specify in a fragmentation strategy.
For more information about fragmentation and the SQL statements you use
to created fragmented tables and indexes, see Chapter 1 of the Informix Guide
to SQL: Syntax. See the INFORMIX-OnLine Dynamic Server Performance Guide
for more information about how fragmentation can enhance performance.
Informix Databases
1-5
Locking Issues
Locking Issues
When you write applications for INFORMIX-OnLine Dynamic Server and
INFORMIX-SE, you should be aware of how each handles the following
locking issues:
Which choices of lock scope are available
Which choices of lock mode are available
How shared locks are used
Whether a process can wait for a lock
The following four sections briefly describe how the different database
servers handle these locking issues.
Lock Scope
When you create a table, INFORMIX-OnLine Dynamic Server sets the lock
scope to page level by default. If you want, you can set the lock scope to row
level instead.
INFORMIX-SE supports only row-level locking.
Refer to Chapter 7 of the Informix Guide to SQL: Tutorial for more information
on lock scope. See the descriptions of CREATE TABLE or ALTER TABLE in
Chapter 1 of the Informix Guide to SQL: Syntax for how to specify a lock scope.
Lock Mode
INFORMIX-OnLine Dynamic Server supports three locking modes: shared,
exclusive, and promotable.The OnLine database server implicitly places promotable locks on the rows, which are selected for an update operation. Just
before the actual update, the OnLine promotes the lock to exclusive.
The INFORMIX-SE database server supports only shared and exclusive
locking. This results in different locking strategies for table updates. The
INFORMIX-SE database server does not have promotable locking, so it places
exclusive locks on rows that are selected for update.
For more information on lock modes, refer to Chapter 7 of the Informix Guide
to SQL: Tutorial. See also the description of the UPDATE statement in Chapter 1
of the Informix Guide to SQL: Syntax.
1-6
Isolation Level
Use of Shared Locks
INFORMIX-OnLine Dynamic Server supports shared locks on tables. Multiple
users may place shared locks on a table.

INFORMIX-SE also supports shared locks on tables. However, the
INFORMIX-SE database server allows only one user at a time to have a shared
lock on a table.
For more information, see the description of LOCK TABLE in Chapter 1 of the
Informix Guide to SQL: Syntax.
Waiting for Locks

The SET LOCK MODE statement is always available with INFORMIX-OnLine
Dynamic Server. This statement specifies whether a process that tries to
access a locked row or table must wait until OnLine releases the lock.
Only those INFORMIX-SE database servers that use kernel locking have the
SET LOCK MODE statement available.
For more information, refer to Chapter 7 of the Informix Guide to SQL: Tutorial.
See also the description of SET LOCK MODE in Chapter 1 of the Informix Guide
to SQL: Syntax.
Isolation Level
INFORMIX-OnLine Dynamic Server supports the SET TRANSACTION state-
ment for databases that use transaction logging. Using this option, you can
set the isolation level to Read Uncommitted, Read Committed, Repeatable
Read, and Serializable. The default isolation level is Read Committed, unless
the database is ANSI-compliant, in which case the default is Serializable.
INFORMIX-SE supports the SET TRANSACTION statement for access modes
only. All databases running on INFORMIX-SE use the Read Uncommitted
isolation level.
For more information, refer to the description of the SET TRANSACTION

statement in Chapter 1 of the Informix Guide to SQL: Syntax. See also
Chapter 7 of the Informix Guide to SQL: Tutorial.
Informix Databases
1-7
System Catalog Tables
System Catalog Tables

The following system catalog tables in an INFORMIX-SE database are defined
or used differently than their corresponding system catalog tables in an
INFORMIX-OnLine Dynamic Server database:
syscolumns
sysindexes
syssyntables
systables
sysreferences
The following system catalog tables exist only on INFORMIX-OnLine

Dynamic Server database servers:
sysfragments
sysopclstr
sysblobs
For more information on the system catalog tables, see Chapter 2, System
Catalog.
SQL Statements Supported by Specific Database Servers

This section lists which SQL statements are supported by INFORMIX-OnLine
Dynamic Server and which statements are supported by INFORMIX-SE. This
information also appears in Chapter 1 of the Informix Guide to SQL: Syntax,
where syntax specific to OnLine and SE is indicated by the appropriate icon.
SQL Statements Supported Only by INFORMIX-OnLine Dynamic Server

The following statements are supported only by OnLine:
1-8
ALTER FRAGMENT
SET CONSTRAINTS
SET ISOLATION
SET LOG
SQL Statements Supported by Specific Database Servers

SQL Statements Containing Branches Specific to INFORMIX-OnLine
Dynamic Server
The following statements contain at least one option or branch that is
supported only by OnLine:
ALTER TABLE
CREATE DATABASE
CREATE TABLE
REVOKE
SET LOCK MODE
SET TRANSACTION
SQL Segments Containing Branches Specific to INFORMIX-OnLine

Dynamic Server
Segments are elements of syntax that are extracted from the syntax of the SQL
statements. Segments are described in Chapter 1 of the Informix Guide to SQL:
Syntax. The following segments contain at least one option or branch that is
supported only by OnLine:
Condition
Constraint
Database Name
Expression
Index Name
Procedure Name
Synonym Name
Table Name
View Name
Important: If one of the segments in the preceding list contains a branch that is
specific to INFORMIX-OnLine Dynamic Server, the entire SQL statement is supported only by OnLine. For example, if a SELECT statement contains an expression
with a branch that is supported only by OnLine, the entire SELECT statement is
supported only by an OnLine database server.
Informix Databases
1-9
Using ANSI-Compliant Databases

SQL Statements Supported Only by INFORMIX-SE
The following statements are supported only by the INFORMIX-SE database
server:
CHECK TABLE
CREATE AUDIT
DROP AUDIT
RECOVER TABLE
REPAIR TABLE
ROLLFORWARD DATABASE
START DATABASE
SQL Statements and Segments Containing Branches Specific to

INFORMIX-SE
The following statements contain at least one option or branch that is
supported only by INFORMIX-SE:
CONNECT
CREATE DATABASE
CREATE TABLE
Segments are elements of syntax that are extracted from the syntax of the SQL
statements. Segments are described in Chapter 1 of the Informix Guide to SQL:
Syntax. The Database Name segment is the only segment that contains an
option or branch that is supported only by INFORMIX-SE.

An ANSI-compliant database is created using the MODE ANSI keywords. The
differences between ANSI-compliant databases and those that are not ANSIcompliant are described on page 1-12.
1-10
You might want to create an ANSI-compliant database for the following

reasons:
Privileges and access to objects

ANSI rules govern privileges and access to objects such as tables and
synonyms. However, creating an ANSI-compliant database does not
ensure that this database remains compliant with the
ANSI/ISO SQL-92 standards. (If you take a non-ANSI action, such as
CREATE INDEX, on an ANSI database, you will receive a warning, but
it will not forbid the action.)
Name isolation
The ANSI table-naming scheme allows different users to create tables
in a database without having to worry about name conflicts.
Transaction isolation
Data recovery
ANSI-compliant databases enforce unbuffered logging and
automatic transactions for INFORMIX-OnLine Dynamic Server
database servers.
Designating a Database as ANSI-Compliant

You designate a database as ANSI-compliant by using the MODE ANSI
keywords when you create it. Once you create a database using the MODE
ANSI keywords, the database is considered ANSI-compliant. In an ANSIcompliant database, you cannot change the logging mode to buffered
logging, and you cannot turn logging off.
Determining If an Existing Database Is ANSI-Compliant

The following list describes several methods to determine if a database is
ANSI-compliant:
If the default database server is INFORMIX-OnLine Dynamic Server,

you can use the DB-Monitor utility to list all the databases that reside
on that default database server. The Databases option of the Status
Menu displays this list. In the Log Status column on the list, an ANSIcompliant database has the notation U*.
Informix Databases
1-11
Differences between ANSI-Compliant Databases and Databases that are not ANSI-Compliant
If you are using an SQL API such as INFORMIX-ESQL/C, you can test
the SQL Communications Area (SQLCA). Specifically, the third element in the SQLCAWARN structure contains a W immediately after
you open an ANSI-compliant database using the DATABASE or
CONNECT statement. For information on SQLCA, see Chapter 5 of
the Informix Guide to SQL: Tutorial or your SQL API manual.
If you are running on an INFORMIX-SE database server, you can

query the systables system catalog table. If a database was created
with the MODE ANSI keywords, systables lists a row with a tabname
of ANSI and a tabid of 100. For example, if the following query on
systables returns a row, the database is ANSI-compliant:
SELECT * FROM 'informix'.systables WHERE tabname = 'ANSI'
Differences between ANSI-Compliant Databases and

Databases that are not ANSI-Compliant
Databases that you designate as ANSI-compliant (by using the MODE ANSI
keywords when you create them) and databases that are not ANSI-compliant
behave differently in the following areas:
1-12
Transactions
Transaction logging
Owner naming
Privileges on objects
Default isolation level
Character data types
Decimal data type
Escape characters
Cursor behavior
SQLCODE of the SQL Communications Area (SQLCA)
Allowed SQL statements
Synonym behavior
Differences between ANSI-Compliant Databases and Databases that are not ANSITransactions
All the SQL statements that you issue in an ANSI-compliant database are
automatically contained in transactions. With a database that is not ANSIcompliant, you can choose whether to use transaction processing.
In a database that is not ANSI-compliant, a transaction is enclosed by a BEGIN
WORK statement and a COMMIT WORK or a ROLLBACK WORK statement.
However, in an ANSI-compliant database, the BEGIN WORK statement is
redundant and unnecessary because all statements are automatically
contained in a transaction. You need to indicate only the end of a transaction
with a COMMIT WORK or ROLLBACK WORK statement.
See Chapter 4 of the Informix Guide to SQL: Tutorial for more information on
transactions.
Transaction Logging
All ANSI-compliant databases on an INFORMIX-OnLine Dynamic Server
database server run with unbuffered transaction logging. Databases that are
not ANSI-compliant can run with either buffered logging or unbuffered logging. Unbuffered logging provides more comprehensive data recovery, but
buffered logging provides better performance.
See the description of CREATE DATABASE in Chapter 1 of the Informix Guide
to SQL: Syntax for more information.
Owner Naming
In an ANSI-compliant database, owner naming is enforced. When you supply
an object name in an SQL statement, ANSI standards require that the name
include the prefix owner., unless you are the owner of the object. The combination of owner and name must be unique in the database. If you are the
owner of the object, the database server supplies your user name as the
default.
Databases that are not ANSI-compliant do not enforce owner naming.
See Table Name in Chapter 1 of the Informix Guide to SQL: Syntax for more
information.
Informix Databases
1-13
Differences between ANSI-Compliant Databases and Databases that are not ANSI-Compliant
Privileges on Objects
ANSI-compliant databases and databases that are not ANSI-compliant differ
as to which users are granted table-level privileges by default when a table in

a database is created. ANSI standards specify that the database server grants
only the table owner (as well as the DBA if they are not the same user) any
table-level privileges. In a database that is not ANSI-compliant, however,
privileges are granted to PUBLIC. In addition, Informix provides two tablelevel privileges, Alter and Index, that are not included in the ANSI standards.
See Chapter 11 of the Informix Guide to SQL: Tutorial and the description of the
GRANT statement in Chapter 1 of the Informix Guide to SQL: Syntax for more
information on granting table-level privileges.
To run a stored procedure, you must have the Execute privilege for that
procedure. When you create an owner-privileged procedure for an ANSIcompliant database, only the owner of the stored procedure has the Execute
privilege. When you create an owner-privileged procedure in a database that
is not ANSI-compliant, the database server grants the Execute privilege to
public by default.
See Chapter 14 of the Informix Guide to SQL: Tutorial for more information on
stored procedure privileges.
Default Isolation Level

The database isolation level specifies the degree to which your program is
isolated from the concurrent actions of other programs. The default isolation
level for all ANSI-compliant databases is Serializable. The default isolation
level for databases that are not ANSI-compliant but do use logging is ANSI
Read Committed on an OnLine database server and Informix Dirty Read on
an INFORMIX-SE database server. The default isolation level in a database
that is not ANSI-compliant and without logging is Read Uncommitted.
See Chapter 7 of the Informix Guide to SQL: Tutorial and the description of the
SET TRANSACTION and SET ISOLATION statements in Chapter 1 of the
Informix Guide to SQL: Syntax for more information.
1-14
Differences between ANSI-Compliant Databases and Databases that are not ANSICharacter Data Types
In an ANSI-compliant database, you get an error if any character field (CHAR,
CHARACTER, VARCHAR, NCHAR, NVARCHAR, CHARACTER VARYING) is
filled with a string that is longer than the specified width of the field.
Decimal Data Type

In an ANSI-compliant database, no scale is used for the DECIMAL data type.
You can think of this as scale=0.
Escape Characters
In an ANSI-compliant database, escape characters can only escape the
following characters: percent (%) and underscore(_). An escape character can
also be used to escape itself. See the Condition segment in the Informix Guide
to SQL: Syntax for additional information.
Cursor Behavior
If a database is not ANSI-compliant, you need to use the FOR UPDATE
keywords when you declare an update cursor for a SELECT statement. The
SELECT statement must also meet the following conditions:
It selects from a single table.
It does not include any aggregate functions.
It does not include the DISTINCT, GROUP BY, INTO TEMP, ORDER BY,
UNION, or UNIQUE clauses and keywords.
With an ANSI-compliant database, you do not have to explicitly use the FOR
UPDATE keywords when you declare a cursor. In ANSI-compliant databases,
all cursors that meet the restrictions described in the preceding list are potentially UPDATE cursors. You can specify that a cursor is read-only with the FOR
READ ONLY keywords on the DECLARE statement.
See the description of the DECLARE statement in Chapter 1 of the Informix
Guide to SQL: Syntax for more information.
Informix Databases
1-15
Using Native Language Support

The SQLCODE Field of the SQL Communications Area
If no rows satisfy the search criteria of a DELETE, an INSERT INTO tablename
SELECT, a SELECT... INTO TEMP, or an UPDATE statement, the database server
sets SQLCODE to 100 if the database is ANSI-compliant and to 0 if the database
is not ANSI-compliant.
See the descriptions of SQLCODE in Chapter 5 of the Informix Guide to SQL:
Tutorial for more information.
SQL Statements Allowed with ANSI-Compliant Databases

No restrictions exist on SQL statements allowed in applications used with
an ANSI-compliant database. You can use the Informix extensions with an
ANSI-compliant database just as you can with a database that is not
ANSI-compliant.
Synonym Behavior
Synonyms are always private in an ANSI-compliant database. If you attempt
to create a public synonym, or use the PRIVATE keyword to designate a
private synonym in an ANSI-compliant database, you receive an error.

If you plan to use non-English characters in your data or user-specified object
names, you need to set your environment to accommodate Native Language
Support (NLS). This allows you to work in a European language other than
English and to conform to the customs of a specific non-U.S. locale. A database that allows local sorting and other operations on non-English character
data is referred to as an NLS database. (A non-NLS database accepts nonEnglish character data, if the locale is not set to C. However, sorting and other
operations on the non-English character data are done according to ASCII
conventions.)
1-16
If you do not need to work with non-English character data or identifiers, you
can simply not activate NLS. Your Informix products thus perform as
intended for a U.S. English environment, and you can skip this section. However, even if your data does not contain non-English characters, you can
activate NLS to deviate from the standard ASCII collation order of your data.
Both the INFORMIX-OnLine Dynamic Server and INFORMIX-SE database servers allow database names in national character sets (the latter only if the operating system environment allows it). The associated utilities can display
database names, user names, and so on, on the screen in the local language.
Informix NLS-ready products are available only on platforms that support
NLS.
Once you activate the NLS functionality built into your Informix product by
setting the appropriate environment variables, you can create or access
database information in any language available on the system.
The implementation of NLS affects the following operations:
Processing national characters and strings

You can name all user-specifiable objects, such as tables, columns,
views, statements, cursors, and variables using national character
sets and can use a collation order that suits the local customs.
You can use country-specific values instead of ASCII values to
evaluate the WHERE and ORDER BY clauses of your SELECT statements or to sort indexes built on NCHAR and NVARCHAR character
fields.
Evaluation of regular expressions

You can use country-specific values instead of ASCII values when
comparing regular expressions involving NCHAR and NVARCHAR
character fields.
Representation of money and currency symbols

You can specify monetary values using a format that is not
ANSI-compliant for locales outside the U.S.
Informix Databases
1-17
Activating NLS
Representation of dates and times

You can specify date and time values in a format that is not
ANSI-compliant for locales outside the U.S.
Accessibility of formerly incompatible character code sets

You can access and share data from databases that use nonstandard
code sets and can use NLS collation features without modifying
existing code.
The Informix implementation of NLS is based on the X/Open specification of

NLS as outlined in the XPG3 documents. NLS terms are defined in the Glossary of this manual, and specific features are described where appropriate
throughout this manual set.
Activating NLS
You set specific environment variables to activate the NLS functionality in
Informix products and to create NLS databases. If you do not activate NLS,
your Informix products function in English.
Setting Environment Variables for NLS

Set the following environment variables to activate or work with NLS:
DBNLS
LANG
Before starting a client application or accessing

DB-Access, you must set DBNLS to 1 or 2, which enables
NLS features.
Next, Informix recommends that you set LANG to
specify the locale (language environment) for your database operations. Messages, collating sequences, character classifications, and local customs information are all
associated with the LANG setting. The setting depends
on your system and the locale you want to support.
Alternatively, you can set or modify individual characteristics with the environment variables described in the
following list. You can set additional environment variables categories for a fuller implementation of NLS features. Set the variables that start with LC_ to modify or
override the LANG setting.
1-18
Activating NLS
The following NLS environment variables are listed here alphabetically and
all are described in detail in the section NLS Environment Variables on
page 4-11:
COLLCHAR
DBAPICODE
LC_COLLATE
LC_CTYPE
LC_MONETARY
LC_NUMERIC
LC_TIME
Set this environment variable if you want previously written client applications to take advantage of the NLS collation feature without changing the code.
Set this environment variable so that your client applications on different platforms can use a different code set
than the one used by the database server and thus share
data. DBAPICODE lets systems that use nonstandard or
rare code sets access databases that store data using a
standard code set.
Set this environment variable to specify a collating or sort
sequence for your locale. The setting affects the evaluation of regular expressions and character-string handling
involving NCHAR and NVARCHAR data type fields.
Set this environment variable to affect the behavior of regular expressions and character evaluation functions such
as case conversion, spaces, and punctuation.
Set this environment variable to specify the format and
national currency symbol for money values.
Set this environment variable to specify the format and
decimal separator for numeric values.
Set this environment variable to define the format for
national dates and times, including country-specific
names and abbreviations for days of the week and
months.
The following example illustrates various NLS environment variable and

environment variable settings using UNIX commands in a C shell. Settings in
the example activate NLS and specify the German language environment for
database operations, the German Swiss dictionary collation order for that
locale, and the ISO 8859/1 code set for money values in Swiss francs:
setenv
setenv
setenv
setenv
DBNLS 1
LANG DE
LC_COLLATE DE_ch@dict
LC_MONETARY CH.88591
Informix Databases
1-19
Activating NLS
These NLS environment variables and their interactions with Informix

environment variables are described in detail in Chapter 4, Environment
Variables, of this manual. Example settings are shown in Chapter 4,
Environment Variables, but the settings are not standardized and might
vary among systems.
Using Environment Variables to Determine the Locale

If DBNLS is set, activating NLS, the locale used by the database server is
determined by the setting of various other NLS environment variables. This
section indicates the order of precedence for selecting the locale in two cases.
1.
For a Version 6.0 or later SQL API or a pre-Version 6.0 SQL API that
goes through the relay module, the order of precedence for the locale
is outlined in the following list, from highest to lowest:
LC_CTYPE and LC_COLLATE set by the user or the application
LANG set by the user or the application
Default locale (C)
The database server uses the current locale to try to open the specified
database. If the database name contains non-ASCII characters and the locale
setting is different from that character set, the database name might be
rejected because the statement contains illegal characters. Or, the wrong database might open because a character from locale X might be mapped to
another character in locale Y. In other words, if database name contains characters that are not recognized by all European languages, you must be careful
to set the local correctly before opening the database.
For example, if the current locale is Z and the database name is tet, the
database cannot open unless the Z locale understands the character in the
database name. If the Z locale does not understand the character , the database cannot open.
This is true even if DBNLS is set to use open NLS (DBNLS=2). When DBNLS
is set to 2, all it means is that once the database is opened, its locale becomes
the active one. However, the SQL API locale must be able to find the database.
If you want to use open NLS to advantage, all the database names should
contain characters valid in the default locale C. (The database itself can be a
non-C database and the data can contain non-C characters.) When accessing
the database, set the locale to C; once the database opens, it switches to the
locale specified in the database.
1-20
Activating NLS
2.
For a PC client talking to a UNIX server, the locale used by the server
follows the order shown in the following list, from highest to lowest:
LC_CTYPE and LC_COLLATE set in the SQL API

LC_CTYPE and LC_COLLATE set when the server was brought
up
LANG set when the server was brought up
Default locale (C)
As stated previously, the database server uses this locale to try to open the
specified database. If the locale used is different from the one the database
name is in, the server might not be able to open the database. Again, to use
Open-NLS effectively, you should create the database with a name in ASCII
characters and set LC_CTYPE and LC_COLLATE to C when trying to access
the database. Or make sure that when the server is started, the locale is either
set to C or not set (the default is C).
Determining NLS Functionality for a Session and a Database

If you are using DB-Access, you can use the Session option on the main menu
to view the NLS capabilities and attributes for the current DB-Access session.
This information includes the mode (NLS or non-NLS) and the LC_COLLATE
and LC_CTYPE settings when in NLS mode.
You also can use the Nls option of the DB-Access DATABASE INFO menu to
view the NLS collating sequence (LC_COLLATE setting) and character classification type (LC_CTYPE setting) stored in the active database. Because the
LANG setting is not stored in the database, it does not appear. However, you
probably can infer the NLS language setting from the collating sequence
setting shown.
See Chapter 4 and Chapter 6 in the DB-Access User Manual for details of these
menu options.
If you are using INFORMIX-ESQL/C or INFORMIX-ESQL/COBOL, you must
rely on errors returned to the SQLCA data structure to learn whether you have
compromised the NLS compatibility guidelines.
See your INFORMIX-ESQL/C Programmers Manual or INFORMIX-ESQL/COBOL
Programmers Manual for details of the error-handling process. Specific error
messages and their corrective actions are described in the Informix Error
Messages manual.
Informix Databases
1-21
NLS Data Types
NLS Data Types

With NLS activated, data in tables can contain characters from the local
language. You can create columns that have the data type NCHAR
(INFORMIX-OnLine Dynamic Server or INFORMIX-SE) or NVARCHAR
(INFORMIX-OnLine Dynamic Server only) instead of CHAR or VARCHAR,
respectively. Columns created with the NLS data types follow the rules of the
language and collating sequence of the database.
Use the CREATE TABLE and ALTER TABLE statements to declare columns
with the NCHAR or NVARCHAR data type. See Chapter 1 of the Informix
Guide to SQL: Syntax for information on using these SQL statements. You can
also use the DB-Access schema editor to declare NCHAR or NVARCHAR
columns, as described in Chapter 5 of the DB-Access User Manual.
The specifications for the NCHAR and NVARCHAR data types are basically
the same as for their non-NLS counterparts, except that NCHAR and
NVARCHAR allow the use of non-English characters. See Chapter 3, Data
Types, for information on available character data types.
Once you activate NLS, the columns in the system catalog tables identified
as CHAR are defined as NCHAR. (They remain CHAR if NLS has not been
activated.) See Chapter 2, System Catalog, for information on the system
catalog tables.
Important: If you do not need NLS functionality for your character data, Informix
recommends using the CHAR column wherever possible. CHAR data require simple
value-based comparisons, sorting, and indexing, and thus these columns are
relatively inexpensive in terms of performance.
NLS Versus Non-NLS Databases and Database Servers

When you create an NLS database, the database server saves the settings for
LC_COLLATE and LC_CTYPE X/Open categories in the system catalog. The
settings are used throughout the lifetime of the database for such operations
as handling regular expressions, collating character strings, and ensuring
proper use of code sets. (Operations on non-NLS databases follow the same
rules as for Informix products before Version 6.0, namely, collation order is
based on character code.)
1-22
A database created after DBNLS is set to 1 or 2 is an NLS database. An NLS

database can be accessed by NLS or non-NLS programs and client applications through NLS database servers. An NLS database is limited to a single
language or code set, as implied by the LANG setting that is stored in the
database when the database is created.
If you want to use NLS with existing (non-NLS) databases, such as for
building indexes using local cultural conventions, you must unload the data
and rebuild the databases after activating NLS.
If your current database is not an NLS database, you cannot access an NLS
database on another database server. However, you can drop an external NLS
database even if your current database is not an NLS database, if the NLS
environment variables are set correctly. When the DROP statement is executed, the current database is considered temporarily closed, thus allowing
the NLS environment variable settings to take effect.
You can set DBNLS to 2 and set COLLCHAR to 1 to allow existing
INFORMIX-4GL or pre-Version 6.0 INFORMIX-ESQL programs to access NLS
databases and obtain proper sorting and collation of character data types
from the database server. Setting DBNLS to 2 also allows applications with
different settings for their locales to access an NLS database.
The Informix Version 6.0 and later database servers are NLS-ready; Informix
database servers prior to Version 6.0 are considered non-NLS database servers. An NLS database server can access non-NLS databases as well as NLS
databases. However, a non-NLS database server can access only non-NLS
databases.
Informix software can support more than one language or locale in a single
NLS environment although not in the same database.
Warning: If you try to use a pre-Version 6.0 INFORMIX-OnLine or INFORMIX-SE

with an NLS database, the results could be unpredictable and might even result in
corrupted data.
You might experience performance degradation on some INFORMIX-OnLine
Dynamic Server database servers if you have activated NLS and multiple concurrent
users have specified different locales. Significant overhead might be incurred during
simultaneous collation due to the context switching that the OnLine database server
must perform for the various locales. Informix, therefore, recommends that you do not
undertake a major sorting operation if you know that another NLS locale is active.
Informix Databases
1-23

Error Messages Regarding NLS Compatibility
Certain actions on a database or database server might result in an error,
depending on the settings for the various NLS environment variables and
X/Open categories. The corrective actions for these error messages are
described in the Informix Error Messages book.
If you attempt to create an NCHAR (or NVARCHAR) column or

declare an NCHAR (or NVARCHAR) variable in a non-NLS database,
you receive the following message:
-7202 Database was created without NLS functionality.
If you try to access a database that has a different collating sequence

than the one defined when the database was created, the database
server rejects the connection and returns the following error
message:
-7203 DBNLS is not set or LC_COLLATE must be 'category-value'
The database server also returns the name of the correct

LC_COLLATE setting in the SQLERRM field of the SQLCA data
structure for Informix programming-language products.
If you try to access a database that has a different character

classification type than the one defined when the database was
created, the database server rejects the connection and returns the
following error message:
-7205 DBNLS is not set or LC_CTYPE must be set to 'category-value'
The database server also returns the name of the correct LC_CTYPE
setting in the SQLERRM field of the SQLCA data structure for
Informix programming-language products.
If you try to access an NLS database with a non-NLS-ready database

server, you see the following message:
-7210 This server does not have NLS capability.
If you try to access an external NLS database when the current

database is not an NLS database, you receive the following message:
-7211 Cannot reference an external NLS database.
1-24
Incompatibilities in the database server environment can also result

in error messages. For instance, in a network environment, the client
and server systems must have a compatible X/Open NLS implementation. Distributed operations can succeed only if all accessed
databases are using the same code sets. Otherwise, error -7203 or
-7205 is returned.
Also, if your current database is not an NLS database, you cannot
access an NLS database on another database server or within the
same database server.
NLS Functionality in Version 6.0 and Later Database Server and SQL
API Products
The Informix Version 6.0 and later products are NLS-ready. They allow you to
use NLS databases and database servers when working with SQL, provided
that you have activated NLS as described earlier.
In addition to the NLS functionality previously described for the
INFORMIX-OnLine Dynamic Server and INFORMIX-SE database server
products, the following Informix products have also been enhanced to
support NLS:
The DB-Access utility provided with INFORMIX-OnLine Dynamic

Server and INFORMIX-SE, which allows all user-specifiable objects
such as tables, columns, views, and statements to be named with
national character sets and sorted according to local database collation rules
The SQL APIs, which allow host and indicator variable names as well
as names of all user-specifiable objects such as tables, columns,
views, cursors, and statements in national character sets
If you also want to receive error and warning messages in a language other
than English, you can install a language supplement for the specific locale
along with your Informix Version 6.0 and later product. The DBLANG
environment variable setting specifies the subdirectory under
$INFORMIXDIR/msg where the message files for each supported native
language reside.
Informix Databases
1-25
In addition, when a language supplement is installed, the DB-Access menu

names, menu options, and selection codes, as well as on-line Help, can
appear in the local language. You also receive translated SQL command files
for practice with NLS.
The installation scripts for the language supplements create the appropriate
directories. Installation is described in on-line or printed installation notes
that accompany the language supplements.
NLS Functionality in Pre-Version 6.0 Database Server and SQL API

Products
Informix products prior to Version 6.0 are not NLS-ready. This also might
apply to third-party applications.
In Informix software prior to Version 6.0, CHAR and VARCHAR data are
sorted or collated according to ASCII conventions, not according to local conventions. This earlier software does not know how to process the NCHAR and
NVARCHAR data types that were introduced in Version 6.0.
To use such products with Version 6.0 and later NLS databases and database
servers, and obtain reasonable collation results, you should set the DBNLS
environment variable to 2 and the COLLCHAR environment variable to 1.
(You can, however, set DBNLS to 1 if LANG is set to the language of the
database.)
With these settings, the database server is NLS-aware; it sorts or collates
according to the local conventions, using the NCHAR and NVARCHAR data
types. The application is not NLS-aware and has only the CHAR and
VARCHAR data types; it sends queries to the NLS database server for collation
according to local conventions and receives properly sorted results. (However, comparisons in the application and in the database server might be
inconsistent.)
When DBNLS is set to 1, all databases created are NLS databases and are
locked into a locale. The application must operate in the same locale as the
database being accessed. Only Version 6.0 and later INFORMIX-ESQL/C,
INFORMIX-ESQL/COBOL, and DB-Access can make use of the difference
between CHAR/VARCHAR and NCHAR/NVARCHAR data types.
1-26
When DBNLS is set to 2, the locale of the application is not checked. When
the database server accesses the database, it assumes the locale of the
database.
You should be aware of the following behaviors when DBNLS is set to 2 and
COLLCHAR is set to 1:
The locale of identifiers used in an application must be consistent

with the locale of the database server.
If the application is not aware of the NLS data types, it should not
directly access the column type information in the system catalog
tables.
INFORMIX-OnLine Dynamic Server does not allow concurrent access

to (or distributed queries on) databases that have different locales.
For example, if database1 is the current database and has a French
locale, and, in the same session, you attempt to open or query on
database2 that has a German locale, an error is returned. You can,
however, open the German database if the French database is closed.
Informix Databases
1-27
Chapter
System Catalog
Objects Tracked by the System Catalog Table .
2-3
Using the System Catalog . . . .

Accessing the System Catalog . .
Updating System Catalog Data .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2-4
2-10
2-11

SYSBLOBS . . . . . .
SYSCHECKS . . . . .
SYSCOLAUTH . . . . .
SYSCOLDEPEND . . . .
SYSCOLUMNS . . . . .
SYSCONSTRAINTS . . .
SYSDEFAULTS . . . . .
SYSDEPEND . . . . .
SYSDISTRIB . . . . . .
SYSFRAGMENTS . . . .
SYSINDEXES . . . . .
SYSOPCLSTR . . . . .
SYSPROCAUTH . . . .
SYSPROCBODY . . . .
SYSPROCEDURES . . .
SYSPROCPLAN . . . .
SYSREFERENCES . . . .
SYSSYNONYMS . . . .
SYSSYNTABLE . . . . .
SYSTABAUTH . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2-12
2-13
2-14
2-15
2-16
2-17
2-20
2-22
2-23
2-24
2-25
2-26
2-29
2-31
2-32
2-33
2-34
2-35
2-36
2-36
2-38
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
SYSTABLES . . . . . . . . . . . . . . . . . . . .
SYSTRIGBODY . . . . . . . . . . . . . . . . . . .
SYSTRIGGERS . . . . . . . . . . . . . . . . . . .
SYSUSERS . . . . . . . . . . . . . . . . . . . .
SYSVIEWS . . . . . . . . . . . . . . . . . . . .
System Catalog Map .
Information Schema . . . . . . . . .
Generating the Information Schema Views
Accessing the Information Schema Views .
Structure of the Information Schema Views
TABLES . . . . . . . . . . .
COLUMNS . . . . . . . . . .
SQL_LANGUAGES . . . . . . .
SERVER_INFO . . . . . . . .
2-2
2-39
2-42
2-43
2-44
2-44
2-45
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2-47
2-47
2-48
2-48
2-49
2-49
2-51
2-51
he system catalog consists of tables that describe the structure of the

database. Each system catalog table contains specific information about an
element in the database.
This chapter covers the following topics:
How to access tables in the system catalog
How to update statistics in the system catalog
The structure, including the name and data type of each column, of
the tables that constitute the system catalog
Information Schema views that are created from system catalog

information
Objects Tracked by the System Catalog Table

The system catalog tables track the following objects:
Tables and constraints
Views
Triggers
Authorized users and privileges associated with every table you

create
Stored procedures
The system catalog tables are generated automatically when you create a
database, and you can query them as you would query any other table in the
database. If you are using INFORMIX-OnLine Dynamic Server, the data for
a newly created database and the 25 system catalog tables for that database
reside in a common area of the disk called a dbspace. If you are using the
INFORMIX-SE database server, the 22 system catalog tables for a newly
System Catalog 2-3
Using the System Catalog
created database reside in the databasename.dbs directory. All tables in the

system catalog have the prefix sys (for example, the systables system catalog
table).

The database server accesses the system catalog constantly. Each time an SQL
statement is processed, the database server accesses the system catalog to
determine system privileges, add or verify table names or column names,
and so on. For example, the following CREATE SCHEMA block adds the
customer table, with its respective indexes and privileges, to the stores7 database. This block also adds a view, california, that restricts the view into the
customer table to only the first and last names of the customer, the company
name, and the phone number of all customers who reside in California.
CREATE SCHEMA AUTHORIZATION maryl
CREATE TABLE customer
(customer_num SERIAL(101), fname CHAR(15), lname CHAR(15), company CHAR(20),
address1 CHAR(20), address2 CHAR(20), city CHAR(15), state CHAR(2),
zipcode CHAR(5), phone CHAR(18))
GRANT ALTER, ALL ON customer TO cathl WITH GRANT OPTION AS maryl
GRANT SELECT ON CUSTOMER TO public
GRANT UPDATE (fname, lname, phone) ON customer TO nhowe
CREATE VIEW california AS
SELECT fname, lname, company, phone FROM customer WHERE state = 'CA'
CREATE UNIQUE INDEX c_num_ix ON customer (customer_num)
CREATE INDEX state_ix ON customer (state);
To process this CREATE SCHEMA block, the database server first accesses the
system catalog to verify the following information:
2-4
The new table and view names do not already exist in the database.
(If the database is ANSI-compliant, the database server verifies that
the table and view names do not already exist for the specified
owners.)
The user has permission to create the tables and grant user
privileges.
The column names in the CREATE VIEW and CREATE INDEX

statements exist in the customer table.
In addition to verifying this information and creating two new tables, the
database server adds new rows to the following system catalog tables:
systables
syscolumns
sysviews
systabauth
syscolauth
sysindexes
The following two new rows of information are added to the systables
system catalog table after the CREATE SCHEMA block shown on page 2-4 is
run.
System Catalog 2-5
tabname
owner
partnum
tabid
rowsize
ncols
nindexes
nrows
created
version
tabtype
locklevel
npused
fextsize
nextsize
flags
site
dbname
customer
maryl
16778361
101
134
10
2
0
04/26/1994
1
T
P
0
16
16
0
tabname
owner
partnum
tabid
rowsize
ncols
nindexes
nrows
created
version
tabtype
locklevel
npused
fextsize
nextsize
flags
site
dbname
california
maryl
0
102
134
4
0
0
04/26/1994
0
V
B
0
0
0
0
Each table recorded in the systables system catalog table is assigned a tabid,
a system-assigned sequential ID number that uniquely identifies each table
in the database. The system catalog tables receive tabid numbers 1 through
24, and the user-created tables receive tabid numbers beginning with 100.
2-6
The CREATE SCHEMA block also adds 14 rows to the syscolumns system
catalog table. These rows correspond to the columns in the table customer
and the view california, as shown in the following example:
colname
tabid colno coltype collength colmin colmax
customer_num
fname
lname
company
address1
address2
city
state
zipcode
phone
101
101
101
101
101
101
101
101
101
101
1
2
3
4
5
6
7
8
9
10
262
0
0
0
0
0
0
0
0
0
4
15
15
20
20
20
15
2
5
18
fname
lname
company
phone
102
102
102
102
1
2
3
4
0
0
0
0
15
15
20
18
In the syscolumns system catalog table, each column within a table is

assigned a sequential column number, colno, that uniquely identifies the column within its table. In the colno column, the frame column of the customer
table is assigned the value 1 and the frame column of the view california is
assigned the value 2. Note that the colmin and colmax columns contain no
entries. These two columns contain values only when a column is the first key
in a composite index or is the only key in the index, has no null or duplicate
values, and the UPDATE STATISTICS statement has been run.
Tip: For all system catalog tables, all columns identified as a CHAR data type are
NCHAR data type if NLS functionality is activated. The data type remains as CHAR
if NLS functionality is not activated.
System Catalog 2-7
The rows shown in the following example are added to the sysviews system
catalog table. These rows correspond to the CREATE VIEW portion of the
CREATE SCHEMA block:
tabid
102
102
102
102
102
seq viewtext
0
1
2
3
4
create view 'maryl'.california (customer_num, fname, lname, company

,address1, address2, city, state, zipcode, phone) as select x0.custom
er_num, x0.fname, x0.lname, x0.company, x0.address1, x0.address2
,x0.city, x0.state, x0.zipcode, x0.phone from 'maryl'.customer
x0 where (x0.state = 'CA');
The sysviews system catalog table contains the CREATE VIEW statement used
to create the view. Each line of the CREATE VIEW statement in the current
schema is stored in this table. In the viewtext column, the x0 that precedes the
column names in the statement (for example, x0.fname) operates as an alias
name that distinguishes between the same columns used in a self-join.
The CREATE SCHEMA block also adds rows to the systabauth system catalog
table. These rows correspond to the user privileges granted on customer and
california, as shown in the following example:
grantor
grantee
tabid
tabauth
maryl
maryl
maryl
public
cathl
nhowe
maryl
101
101
101
102
su-idx-SU-IDXAR
--*----SU-ID---
The tabauth column of this table specifies the table-level privileges granted
to users on the customer and california tables. This column uses an 8-byte
patterns (select), u (update), * (column-level privilege), i (insert), d (delete),
x (index), a (alter), r (references)to identify the type of privilege granted. In
this example, the user nhowe has column-level privileges on the customer
table.
If the tabauth privilege code is uppercase (for example, S for select), the user
who is granted this privilege can also grant it to others. If the tabauth privilege code is lowercase (for example, s for select), the user who is granted this
privilege cannot grant it to others.
2-8
In addition, three rows are added to the syscolauth system catalog table.
These rows correspond to the user privileges granted on specific columns in
the customer table, as shown in the following example:
grantor
grantee
tabid
colno
colauth
maryl
maryl
maryl
nhowe
nhowe
nhowe
101
101
101
2
3
10
-u-u-u-
The colauth column of this table specifies the column-level privileges

granted on the customer table. This column uses a 3-byte patterns (select),
u (update), r (references)to identify the type of privilege granted. For
example, the user nhowe has update privileges on the second column
(because the colno value is 2) of the customer table (indicated by tabid value
of 100).
System Catalog 2-9
Accessing the System Catalog
The CREATE SCHEMA block adds two rows to the sysindexes system catalog
table. These rows correspond to the indexes created on the customer table, as
shown in the following example:
idxname
owner
tabid
idxtype
clustered
part1
part2
part3
part4
part5
part6
part7
part8
part9
part10
part11
part12
part13
part14
part15
part16
levels
leaves
nunique
clust
c_num_ix
maryl
101
U
state_ix
maryl
101
D
1
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
8
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
In this table, the idxtype column identifies whether the index created is
unique or a duplicate. For example, the index c_num_ix placed on the
customer_num column of the customer table is unique.
Accessing the System Catalog

Normal user access to the system catalog is read-only. Users with the Connect
or Resource privileges cannot alter the system catalog. They can, however,
access data in the system catalog tables on a read-only basis using standard
2-10
SELECT statements. For example, the following SELECT statement displays all
the table names and corresponding table ID numbers of user-created tables

in the database:
SELECT tabname, tabid FROM systables WHERE tabid > 99
Warning: Although the user informix and DBAs can modify most system catalog
tables (only user informix can modify systables), Informix strongly recommends
that you do not update, delete, or insert any rows in them. Modifying the system catalog tables can destroy the integrity of the database. Informix supports using the
ALTER TABLE statement to modify the size of the next extent of system catalog tables.

The optimizer in Informix database servers determines the most efficient
strategy for executing SQL queries. This allows you to query the database
without having to fully consider which tables to search first in a join or which
indexes to use. The optimizer uses information from the system catalog to
determine the best possible query strategy.
By using the UPDATE STATISTICS statement to update the system catalog,
you can insure that the information provided to the optimizer is current.
When you delete or modify a table, the database server does not automatically update the related statistical data in the system catalog. For example, if
you delete rows in a table using the DELETE statement, the nrows column in
the systables system catalog table, which holds the number of rows for that
table, does not get updated. The UPDATE STATISTICS statement causes the
database server to recalculate data in the systables, sysdistrib, syscolumns,
and sysindexes system catalog tables. After you run UPDATE STATISTICS, the
systables system catalog table holds the correct value in its nrows column. If
you use the MEDIUM or HIGH mode with UPDATE STATISTICS, the sysdistrib
system catalog table holds the updated data-distribution data after you run
UPDATE STATISTICS.
Whenever you modify a table extensively, use the UPDATE STATISTICS
statement to update data in the system catalog. For more information on the
UPDATE STATISTICS statement, see Chapter 1 of the Informix Guide to SQL:
Syntax.
System Catalog 2-11

The following system catalog tables describe the structure of the Informix
database:
2-12
sysblobs
syschecks
syscolauth
syscoldepend
syscolumns
sysconstraints
sysdefaults
sysdepend
sysdistrib
sysfragments
sysindexes
sysopclstr
sysprocauth
sysprocbody
sysprocedures
sysprocplan
sysreferences
syssynonyms
syssyntable
systabauth
systables
systrigbody
systriggers
sysusers
sysviews
SYSBLOBS
You should not confuse the system catalog tables of a database with the tables
in the sysmaster database of INFORMIX-OnLine Dynamic Server database
servers. The sysmaster tables also start with sys, but they contain information about an entire OnLine database server (which might manage many
databases). The information in the sysmaster tables is primarily useful for
OnLine database administrators. For more information about the sysmaster
tables, see the INFORMIX-OnLine Dynamic Server Administrators Guide.
SYSBLOBS
The sysblobs system catalog table specifies the storage location of a blob
column. It contains one row for each blob column in a table. Available in
INFORMIX-OnLine Dynamic Server only, the sysblobs system catalog table
has the following columns:
Column Name
Type
Explanation
spacename
CHAR(18)
Blobspace, dbspace, or family name
type
CHAR(1)
Media type:
M = Magnetic
O = Optical
tabid
INTEGER
Table identifier
colno
SMALLINT
Column number
A composite index for the tabid and colno columns allows only unique
values.
System Catalog 2-13
SYSCHECKS
SYSCHECKS
The syschecks system catalog table describes each check constraint defined
in the database. Because the syschecks system catalog table stores both the
ASCII text and a binary encoded form of the check constraint, it contains multiple rows for each check constraint. The syschecks system catalog table has
the following columns:
Column Name
Type
Explanation
constrid
INTEGER
Constraint identifier
type
CHAR(1)
Form in which the check constraint is stored:

B = Binary encoded
T = ASCII text
seqno
SMALLINT
Line number of the check constraint
checktext
CHAR(32)
Text of the check constraint
A composite index for the constrid, type, and seqno columns allows only
unique values.
The text in the checktext column associated with B type in the type column
is in machine-readable format. To view the text associated with a particular
check constraint, use the following query with the appropriate constraint ID:
SELECT * FROM syschecks WHERE constrid=10 AND type='T'
Each check constraint described in the syschecks system catalog table also
has its own row in the sysconstraints system catalog table.
2-14
SYSCOLAUTH
SYSCOLAUTH
The syscolauth system catalog table describes each set of privileges granted
on a column. It contains one row for each set of column privileges granted in
the database. The syscolauth system catalog table has the following columns:
Column Name
Type
Explanation
grantor
CHAR(8)
Grantor of privilege
grantee
CHAR(8)
Grantee (receiver) of privilege
tabid
INTEGER
Table identifier
colno
SMALLINT
Column number
colauth
CHAR(3)
3-byte pattern that specifies column privileges:

s = Select
u = Update
r = References
If the colauth privilege code is uppercase (for example, S for select), a user
who has this privilege can also grant it to others. If the colauth privilege code
is lowercase (for example, s for select), the user who is granted this privilege
cannot grant it to others.
A composite index for the tabid, grantor, grantee, and colno columns allows
only unique values. A composite index for the tabid and grantee columns
allows duplicate values.
System Catalog 2-15
SYSCOLDEPEND
SYSCOLDEPEND
The syscoldepend system catalog table tracks the table columns specified in
each check constraint. Because a check constraint can involve more than one
column in a table, it can contain multiple rows for each check constraint. The
syscoldepend system catalog table has the following columns:
Column Name
Type
Explanation
constrid
INTEGER
tabid
INTEGER
Table identifier
colno
SMALLINT
Column number
A composite index for the constrid, tabid, and colno columns allows only
unique values. A composite index for the tabid and colno columns allows
duplicate values.
2-16
SYSCOLUMNS
SYSCOLUMNS
The syscolumns system catalog table describes each column in the database.
One row exists for each column defined in a table or view. If you are using
the OnLine database server, the syscolumns system catalog table has the
following columns:
Column Name
Type
Explanation
colname
CHAR(18)
Column name
tabid
INTEGER
Table identifier
colno
SMALLINT
Column number sequentially assigned by the

system (from left to right within each table)
coltype
SMALLINT
Code for column data type:

0 = CHAR
8 = MONEY
1 = SMALLINT
10 = DATETIME
2 = INTEGER
11 = BYTE
3 = FLOAT
12 = TEXT
4 = SMALLFLOAT
13 = VARCHAR
5 = DECIMAL
14 = INTERVAL
6 = SERIAL
15 = NCHAR
7 = DATE
16 = NVARCHAR
collength
SMALLINT
Column length (in bytes)
colmin
INTEGER
Second minimum value
colmax
INTEGER
Second maximum value
If the coltype column contains a value greater than 256, it does not allow null
values. To determine the data type for a coltype column that contains a value
greater than 256, subtract 256 from the value and evaluate the remainder
based on the possible coltype values. For example, if a column has a coltype
value of 262, subtracting 256 from 262 leaves a remainder of 6, which
indicates that this column uses a SERIAL data type.
System Catalog 2-17
SYSCOLUMNS
The value that the collength column holds depends on the data type of the
column. If the data type of the column is BYTE or TEXT, collength holds the
length of the descriptor. A collength value for a MONEY or DECIMAL column
is determined using the following formula:
(precision * 256) + scale
For columns of type VARCHAR, the max_size and min_space values are
encoded in the collength column using one of the following formulas:
If the collength value is positive:
collength = (min_space * 256) + max_size
If the collength value is negative:
collength + 65536 = (min_space * 256) + max_size
For columns of type DATETIME or INTERVAL, collength is determined using

the following formula:
(length * 256) + (largest_qualifier_value * 16) + smallest_qualifier_value
The length is the physical length of the DATETIME or INTERVAL field, and
largest_qualifier and smallest_qualifier have the following values:
2-18
Field Qualifier
Value
YEAR
MONTH
DAY
HOUR
MINUTE
SECOND
10
FRACTION(1)
11
FRACTION(2)
12
FRACTION(3)
13
FRACTION(4)
14
FRACTION(5)
15
SYSCOLUMNS
For example, if a DATETIME YEAR TO MINUTE column has a length of 12

(such as YYYY:DD:MM:HH:MM), a largest_qualifier value of 0 (for YEAR), and a
smallest_qualifier value of 8 (for MINUTE), the collength value is 3080, or
(256 12) + (0 16) + 8.
For information about using the HEX function to display the collength and
coltype values, see the Column Expression discussion in the Expression
segment section in Chapter 1 of the Informix Guide to SQL: Syntax.
The colmin and colmax column values hold the second-smallest and secondlargest data values in the column, respectively. For example, if the values in
an indexed column are 1, 2, 3, 4, and 5, the value 2 is the colmin value and 4
is the colmax value. Storing the second-smallest and second-largest data values allows the database server to make assumptions about the range of values in a given column and, in turn, further optimize searching strategies. The
colmin and colmax columns contain values only if the column is indexed and
you have run UPDATE STATISTICS. If you store BYTE or TEXT data in the
tblspace, the colmin value is 1. The values for all other noninteger column
types are the initial 4 bytes of the maximum or minimum value, treated as an
integer.
values.
System Catalog 2-19
SYSCONSTRAINTS
If you are using the INFORMIX-SE database server, the syscolumns system
catalog table has the following columns:
Column Name
Type
Explanation
colname
CHAR(18)
Column name
tabid
INTEGER
Table identifier
colno
SMALLINT
Column number sequentially assigned by the system (ordinally from left to right within each table)
coltype
SMALLINT
Code for column data type:
collength
SMALLINT
0 = CHAR
6 = SERIAL
1 = SMALLINT
7 = DATE
2 = INTEGER
8 = MONEY
3 = FLOAT
10 = DATETIME
4 = SMALLFLOAT
14 = INTERVAL
5 = DECIMAL
15 = NCHAR
Column length (in bytes)
values.
SYSCONSTRAINTS
The sysconstraints system catalog table lists the constraints placed on the
columns in each database table. An entry is also placed in the sysindexes system catalog table for each unique primary-key, or referential constraint you
create, if the constraint does not already have a corresponding entry in the
sysindexes system catalog table. (Because indexes can be shared, more than
one constraint can be associated with an index.) The sysconstraints system
2-20
SYSCONSTRAINTS
Column Name
Type
Explanation
constrid
SERIAL
System-assigned sequential identifier
constrname
CHAR(18)
Constraint name
owner
CHAR(8)
User name of owner
tabid
INTEGER
Table identifier
constrtype
CHAR(1)
Constraint type:
C = Check constraint
P = Primary key
R = Referential
U = Unique
idxname
CHAR(18)
Index name
A composite index for the constrname and owner columns allows only
unique values. The index for the tabid column allows duplicate values, and
the index for the constrid column allows only unique values.
For check constraints (where constrtype = C), the idxname is always null.
Additional information about each check constraint is contained in the
syschecks system catalog table.
System Catalog 2-21
SYSDEFAULTS
SYSDEFAULTS
The sysdefaults system catalog table lists the user-defined defaults placed on
each column in the database. One row exists for each user-defined default
value. If a default is not explicitly specified in the CREATE TABLE statement,
no entry exists in this table. The sysdefaults system catalog table has the
following columns:
Column Name
Type
Explanation
tabid
INTEGER
Table identifier
colno
SMALLINT
Column identifier
type
CHAR(1)
Default type:
L = Literal default
U = User
C = Current
N = Null
T = Today
S = Dbservername
default
CHAR(256)
If default type = L, the literal default value
If a literal is specified for the default value, it is stored in the default column
as ASCII text. If the literal value is not of type CHAR, the default column consists of two parts. The first part is the 6-bit representation of the binary value
of the default value structure. The second part is the default value in English
text. The two parts are separated by a space.
If the data type of the column is not CHAR or VARCHAR, a binary
representation is encoded in the default column.
A composite index for both the tabid and colno columns allows only unique
values.
2-22
SYSDEPEND
SYSDEPEND
The sysdepend system catalog table describes how each view or table
depends on other views or tables. One row exists in this table for each dependency, so a view based on three tables has three rows. The sysdepend system
Column Name
Type
Explanation
btabid
INTEGER
Table identifier of base table or view
btype
CHAR(1)
Base object type:

T = Table
V = View
dtabid
INTEGER
Table identifier of dependent table
dtype
CHAR(1)
Dependent object type (V = View); currently, only

view is implemented
The btabid and dtabid columns are indexed and allow duplicate values.
System Catalog 2-23
SYSDISTRIB
SYSDISTRIB
The sysdistrib system catalog table stores data-distribution information for
use by the database server. Data distributions provide detailed table column
information to the optimizer to improve the choice of execution paths for
optimization of SQL SELECT statements. Information is stored in the
sysdistrib table when an UPDATE STATISTICS statement with mode MEDIUM
or HIGH is run for a table. The sysdistrib system catalog table has the
following columns:
Column Name
Type
Explanation
tabid
INTEGER
Table identifier of the table where data was

gathered
colno
SMALLINT
Column number in the source table
seqno
INTEGER
Sequence number for multiple entries
constructed
DATE
Date when the data distribution was created
mode
CHAR(1)
Optimization level:
L = Low
M = Medium
H = High
resolution
FLOAT
Specified in the UPDATE STATISTICS statement
confidence
FLOAT
Specified in the UPDATE STATISTICS statement
encdat
CHAR(256)
ASCII-encoded histogram in fixed-length

character field; accessible only to user informix.
You can select any column from sysdistrib except encdat. User informix can
select the encdat column.
2-24
SYSFRAGMENTS
SYSFRAGMENTS
The sysfragments table stores fragmentation information for tables and
indexes. One row exists for each table or index fragment.
The sysfragments table has the following columns:
Column Name
Type
Explanation
fragtype
CHAR(1)
Fragment type:
I = Index
T = Table
tabid
INTEGER
Table identifier
indexname
CHAR(18)
Index identifier
colno
SMALLINT
Blob column identifier
partn
INTEGER
Physical location identifier
strategy
CHAR(1)
Distribution scheme type:

R = Round robin
E = Expression
T = Table-based
location
CHAR(1)
Reserved for future use. Shows L for local.
servername
CHAR(18)
Reserved for future use
evalpos
INTEGER
Position of fragment in the fragmentation list
exprtext
TEXT
Expression that was entered
exprbin
BYTE
Binary version of expression
exprarr
BYTE
Range partitioning data used to optimize

expression in range-expression fragmentation
strategy
flags
INTEGER
Internally used
dbspace
CHAR(18)
Dbspacename for fragment
(1 of 2)
System Catalog 2-25
SYSINDEXES
Column Name
Type
Explanation
levels
SMALLINT
Number of B+ tree index levels
npused
INTEGER
For table fragmentation strategy this is the number

of data pages; for index fragmentation strategy
this is the number of leaf pages
nrows
INTEGER
For tables this is the number of rows in the

fragment; for indexes this is the number of unique
keys
clust
INTEGER
Degree of index clustering; smaller numbers

correspond to greater clustering
(2 of 2)
The strategy type T is used for attached indexes (where index fragmentation
is the same as the table fragmentation).
SYSINDEXES
The sysindexes system catalog table describes the indexes in the database. It
contains one row for each index defined in the database. The sysindexes system catalog table for the OnLine database server has the following columns:
Column Name
Type
Explanation
idxname
CHAR(18)
Index name
owner
CHAR(8)
Owner of index (user informix for system catalog

tables and user name for database tables)
tabid
INTEGER
Table identifier
idxtype
CHAR(1)
Index type:
U = Unique
D = Duplicates
clustered
CHAR(1)
Clustered or nonclustered index (C = Clustered)
part1
SMALLINT
Column number (colno) of a single index or the

1st component of a composite index
(1 of 2)
2-26
SYSINDEXES
Column Name
Type
Explanation
part2
SMALLINT
2nd component of a composite index
part3
SMALLINT
3rd component of a composite index
part4
SMALLINT
4th component of a composite index
part5
SMALLINT
part6
SMALLINT
part7
SMALLINT
part8
SMALLINT
part9
SMALLINT
part10
SMALLINT
part11
SMALLINT
part12
SMALLINT
part13
SMALLINT
part14
SMALLINT
part15
SMALLINT
part16
SMALLINT
levels
SMALLINT
Number of B+ tree levels
leaves
INTEGER
Number of leaves
nunique
INTEGER
Number of unique keys
clust
INTEGER
Degree of clustering: smaller numbers correspond to greater clustering
(2 of 2)
Changes that affect existing indexes are reflected in this table only after you
run UPDATE STATISTICS.
System Catalog 2-27
SYSINDEXES
Each partnth column component of a composite index (the part1 through

part16 columns in this table) holds the column number (colno) of each part
of the 16 possible parts of a composite index. If the component is ordered in
descending order, the colno is entered as a negative value.
The clust column is blank until UPDATE STATISTICS is run on the table. The
maximum value is the number of rows in the table and the minimum value
is the number of data pages in the table.
The tabid column is indexed and allows duplicate values. A composite index
for the idxname, owner, and tabid columns allows only unique values.
If you are using the INFORMIX-SE database server, the sysindexes system
Column Name
Type
Explanation
idxname
CHAR(18)
Index name
owner
CHAR(8)
Owner of index (user informix for system tables

and user name for database tables)
tabid
INTEGER
Table identifier
idxtype
CHAR(1)
Index type:
U = Unique
D = Duplicates
2-28
clustered
CHAR(1)
Clustered or nonclustered index (C = Clustered)
part1
SMALLINT
Column number (colno) of a single index or the

1st component of a composite index
part2
SMALLINT
2nd component of a composite index
part3
SMALLINT
3rd component of a composite index
part4
SMALLINT
part5
SMALLINT
part6
SMALLINT
part7
SMALLINT
part8
SMALLINT
SYSOPCLSTR
Each partnth column component of a composite index (the part1 through

part8 columns in this table) holds the column number (colno) of each part of
the eight possible parts of an index.
The tabid column is indexed and allows duplicate values. A composite index
for both the idxname and tabid columns allows only unique values.
SYSOPCLSTR
The sysopclstr system catalog table defines each optical cluster in the
database. Available for INFORMIX-OnLine Dynamic Server only, it contains
one row for each optical cluster. The sysopclstr system catalog table has the
following columns:
Column Name
Type
Explanation
owner
CHAR(8)
Owner of the cluster
clstrname
CHAR(18)
Name of the cluster
clstrsize
INTEGER
Size of the cluster
tabid
INTEGER
Table identifier
blobcol1
SMALLINT
Blob column number 1
blobcol2
SMALLINT
blobcol3
SMALLINT
blobcol4
SMALLINT
blobcol5
SMALLINT
blobco16
SMALLINT
blobcol7
SMALLINT
blobcol8
SMALLINT
blobcol9
SMALLINT
blobcol10
SMALLINT
blobcol11
SMALLINT
(1 of 2)
System Catalog 2-29
SYSOPCLSTR
Column Name
Type
Explanation
blobcol12
SMALLINT
blobcol13
SMALLINT
blobcol14
SMALLINT
blobcol15
SMALLINT
blobcol16
SMALLINT
clstrkey1
SMALLINT
Cluster key number 1
clstrkey2
SMALLINT
clstrkey3
SMALLINT
clstrkey4
SMALLINT
clstrkey5
SMALLINT
clstrkey6
SMALLINT
clstrkey7
SMALLINT
clstrkey8
SMALLINT
clstrkey9
SMALLINT
clstrkey10
SMALLINT
clstrkey11
SMALLINT
clstrkey12
SMALLINT
clstrkey13
SMALLINT
clstrkey14
SMALLINT
clstrkey15
SMALLINT
clstrkey16
SMALLINT
(2 of 2)
A composite index for both the clstrname and owner columns allows only
unique values. The tabid column allows duplicate values.
2-30
SYSPROCAUTH
SYSPROCAUTH
The sysprocauth table describes the privileges granted on a procedure. It
contains one row for each set of privileges granted. The sysprocauth system
Column Name
Type
Explanation
grantor
CHAR(8)
Grantor of procedure
grantee
CHAR(8)
Grantee (receiver) of procedure
procid
INTEGER
Procedure identifier
procauth
CHAR(1)
Type of procedure permission granted:

e = Execute permission on procedure
E = Execute permission and the ability to grant
it to others
A composite index for the procid, grantor, and grantee columns allows only
unique values. The composite index for the procid and grantee columns
System Catalog 2-31
SYSPROCBODY
SYSPROCBODY
The sysprocbody system catalog table describes the compiled version of each
stored procedure in the database. Because the sysprocbody system catalog
table stores the text of the procedure, each procedure can have multiple rows.
The sysprocbody system catalog table has the following columns
:
Column Name
Type
Explanation
procid
INTEGER
datakey
CHAR(1)
Data-descriptor type:
D = User document text
T = Actual procedure source
R = Return value type list
S = Procedure symbol table
L = Constant procedure data string (that is, lit-
eral numbers or quoted strings)

P = Interpreter instruction code
seqno
INTEGER
Line number of the procedure
data
CHAR(256)
Actual text of the procedure
Although the datakey column indicates the type of data stored, the data
column contains the actual data, which can be one of the following types of
data: the encoded return values list, the encoded symbol table, constant data,
compiled code for the procedure, or the text of the procedure and its
documentation.
A composite index for the procid, datakey, and seqno columns allows only
unique values.
2-32
SYSPROCEDURES
SYSPROCEDURES
The sysprocedures system catalog table lists the characteristics for each
stored procedure in the database. It contains one row for each procedure. The
sysprocedures system catalog table has the following columns:
Column Name
Type
Explanation
procname
CHAR(18)
Procedure name
owner
CHAR(8)
Owner name
procid
SERIAL
mode
CHAR(1)
Mode type:
D = DBA
O = Owner
P = Protected
retsize
INTEGER
Compiled size (in bytes) of values
symsize
INTEGER
Compiled size (in bytes) of symbol table
datasize
INTEGER
Compiled size (in bytes) constant data
codesize
INTEGER
Compiled size (in bytes) of procedure instruction

code
numargs
INTEGER
Number of procedure arguments
A composite index for the procname and owner columns allows only unique
values.
A database server can create special-purpose protected stored procedures for
internal use. The sysprocedures table identifies these protected procedures
with the letter P in the mode column. You cannot modify or drop protected
stored procedures.
System Catalog 2-33
SYSPROCPLAN
SYSPROCPLAN
The sysprocplan system catalog table describes the query-execution plans
and dependency lists for data-manipulation statements within each stored
procedure. Because different parts of a procedure plan can be created on different dates, the table can contain multiple rows for each procedure. The
sysprocplan system catalog table has the following columns:
Column Name
Type
Explanation
procid
INTEGER
planid
INTEGER
Plan identifier
datakey
CHAR(1)
Identifier procedure plan part:

D = Dependency list
Q = Execution plan
seqno
INTEGER
Line number of plan
created
DATE
Date plan created
datasize
INTEGER
Size (in bytes) of the list or plan
data
CHAR(256)
Encoded (compiled) list or plan
A composite index for the procid, planid, datakey, and seqno columns
allows only unique values.
2-34
SYSREFERENCES
SYSREFERENCES
The sysreferences system catalog table lists the referential constraints placed
on columns in the database. It contains a row for each referential constraint
in the database. The sysreferences table has the following columns:
Column Name
Type
Explanation
constrid
INTEGER
primary
INTEGER
Constraint identifier of the corresponding

primary key
ptabid
INTEGER
Table identifier of the primary key
updrule
CHAR(1)
Reserved for future use; displays an R
delrule
CHAR(1)
Displays cascading delete or restrict rule:

C = Cascading delete
R = Restrict (default)
matchtype
CHAR(1)
Reserved for future use; displays an N
pendant
CHAR(1)
Reserved for future use; displays an N
The constrid column is indexed and allows only unique values. The primary
column is indexed and allows duplicate values. If you are using the
INFORMIX-SE database server, the contents of the delrule column are
reserved.
System Catalog 2-35
SYSSYNONYMS
SYSSYNONYMS
The syssynonyms system catalog table lists the synonyms for each table or
view. It contains a row for every synonym defined in the database. The
syssynonyms system catalog table has the following columns:
Column Name
Type
Explanation
owner
CHAR(8)
User name of owner
synname
CHAR(18)
Synonym identifier
created
DATE
Date synonym created
tabid
INTEGER
Table identifier
A composite index for the owner and synonym columns allows only unique
values. The tabid column is indexed and allows duplicate values.
Important: Informix products Version 4.0 or later no longer use this table; however,
any syssynonyms entries made before Version 4.0 remain in this table.
SYSSYNTABLE
The syssyntable system catalog table outlines the mapping between each
synonym and the object it represents. It contains one row for each entry in the
systables table that has a tabtype of S. The syssyntable system catalog table
2-36
Column Name
Type
Explanation
tabid
INTEGER
Table identifier
servername
CHAR(18)
Server name
dbname
CHAR(18)
Database name
owner
CHAR(8)
User name of owner
tabname
CHAR(18)
Name of table
btabid
INTEGER
Table identifier of base table or view
SYSSYNTABLE
If you define a synonym for a table that is in your current database, only the
tabid and btabid columns are used. If you define a synonym for a table that
is external to your current database, the btabid column is not used, but the
tabid, servername, dbname, owner, and tabname columns are used.
The tabid column maps to the tabid column in systables. With the tabid
information, you can determine additional facts about the synonym from
systables.
An index for the tabid column allows only unique values. The btabid column
is indexed to allow duplicate values.
If you are using the INFORMIX-SE database server, only the tabid and btabid
columns are used.
System Catalog 2-37
SYSTABAUTH
SYSTABAUTH
The systabauth system catalog table describes each set of privileges granted
in a table. It contains one row for each set of table privileges granted in the
database. The systabauth system catalog table has the following columns:
Column Name
Type
Explanation
grantor
CHAR(8)
Grantor of privilege
grantee
CHAR(8)
Grantee (receiver) of privilege
tabid
INTEGER
Table identifier
tabauth
CHAR(8)
8-byte pattern that specifies table privileges:

s = Select
u = Update
* = Column-level authority
i = Insert
d = Delete
x = Index
a = Alter
r = References
If the tabauth privilege code is uppercase (for example, S for select), a user
who has this privilege also can grant it to others. If the tabauth privilege code
is lowercase (for example, s for select), the user who has this privilege cannot
grant it to others.
A composite index for the tabid, grantor, and grantee columns allows only
unique values. The composite index for the tabid and grantee columns
2-38
SYSTABLES
SYSTABLES
The systables system catalog table describes each table in the database. It
contains one row for each table, view, or synonym defined in the database.
This includes all database tables and the system catalog tables. If you are
using INFORMIX-OnLine Dynamic Server, the systables system catalog table
Column Name
Type
Explanation
tabname
CHAR(18)
Name of table, view, or synonym
owner
CHAR(8)
Owner of table (user informix for system catalog

tables and user name for database tables)
partnum
INTEGER
Tblspace identifier (similar to tabid)
tabid
SERIAL
System-assigned sequential ID number (system

tables: 1-24, user tables: 100-nnn)
rowsize
SMALLINT
Row size
ncols
SMALLINT
Number of columns
nindexes
SMALLINT
Number of indexes
nrows
INTEGER
Number of rows
created
DATE
Date created
version
INTEGER
Number that changes when table is altered
tabtype
CHAR(1)
Table type:
T = Table
V = View
P = Private synonym
P = Synonym (in an ANSI-compliant database)
S = Synonym
(1 of 2)
System Catalog 2-39
SYSTABLES
Column Name
Type
Explanation
locklevel
CHAR(1)
Lock mode for a table:

B = Page
P = Page
R = Row
npused
INTEGER
Number of data pages in use
fextsize
INTEGER
Size of initial extent (in kilobytes)
nextsize
INTEGER
Size of all subsequent extents (in kilobytes)
flags
SMALLINT
site
CHAR(18)
Reserved for future use in OnLine (used to store

NLS data in NLS databases)
dbname
CHAR(18)
(2 of 2)
The tabid column is indexed and must contain unique values. A composite
index for both the tabname and owner columns allows only unique values.
The version column contains an encoded number that is put into the
systables system catalog table when the table is created. Portions of the
encoded value are incremented when data definition statements, such as
ALTER INDEX, ALTER TABLE, DROP INDEX, and CREATE INDEX, are performed. When a prepared statement is executed, the version number is
checked to make sure that nothing has changed since the statement was prepared. If the version number has changed, your statement does not execute
and you must prepare your statement again.
2-40
SYSTABLES
If you are using the INFORMIX-SE database server, the systables system
Column Name
Type
Explanation
tabname
CHAR(18)
Name of table
owner
CHAR(8)
Owner of table (user informix for system tables

and user name for database tables)
dirpath
CHAR(64)
Directory path for the table file
tabid
SERIAL
System assigned sequential ID number (system

tables: 1-21, user tables: 100-nnn)
rowsize
SMALLINT
Row size
ncols
SMALLINT
Number of columns
nindexes
SMALLINT
Number of indexes
nrows
INTEGER
Number of rows
created
DATE
Date created
version
INTEGER
Number that changes when table is altered
tabtype
CHAR(1)
Table type:
T = Table
V = View
S = Synonym
L = Log
P = Synonym (in an ANSI-compliant database)
audpath
CHAR(64)
Audit filename (full pathname)
The dirpath column contains the directory path for the table or log file. The
tabid column is indexed and must contain unique values. A composite index
for the tabname and owner columns allows only unique values.
System Catalog 2-41
SYSTRIGBODY
When NLS functionality has been activated, two hidden rows are added to
the systables system catalog table. NLSCOLL represents the LC_COLLATE setting and has a tabid of 90; NLSCTYPE represents the LC_CTYPE setting and
has a tabid of 91. Enter the following SELECT statement to view these two
hidden rows:
SELECT tabname, tabid FROM systables
SYSTRIGBODY
The systrigbody system catalog table contains the English text of the trigger
definition and the linearized code for the trigger. Linearized code is binary
data and code that is represented in ASCII format.
Warning: The database server uses the linearized code that is stored in systrigbody.
You must not alter the content of rows that contain linearized code.
The systrigbody system catalog table has the following columns:
Column Name
Type
Explanation
trigid
INT
Trigger identifier
datakey
CHAR
Type of data:
D = English text for the header, trigger definition
A = English text for the body, triggered actions
H = Linearized code for the header
S = Linearized code for the symbol table
B = Linearized code for the body
seqno
INT
Sequence number
data
CHAR(256)
English text or linearized code
A composite index for the trigid, datakey, and seqno columns allows only
unique values.
2-42
SYSTRIGGERS
SYSTRIGGERS
The systriggers system catalog table contains miscellaneous information
about the SQL triggers in the database. This information includes the trigger
event and the correlated reference specification for the trigger. The
systriggers system catalog table has the following columns:
Column Name
Type
Explanation
trigid
SERIAL
Trigger identifier
trigname
CHAR(18)
Trigger name
owner
CHAR(8)
Owner of trigger
tabid
INT
ID of triggering table
event
CHAR
Triggering event:
I = Insert trigger
U = Update trigger
D = Delete trigger
old
CHAR(18)
Name of value before update
new
CHAR(18)
Name of value after update
mode
CHAR
A composite index for the trigname and owner columns allows only unique
values. The trigid column is indexed and must contain unique values. An
index for the tabid column allows duplicate values.
System Catalog 2-43
SYSUSERS
SYSUSERS
The sysusers system catalog table describes each set of privileges granted in
the database. It contains one row for each user who is granted privileges in
the database. The sysusers system catalog table has the following columns:
Column Name
Type
Explanation
username
CHAR(8)
Name of the database user
usertype
CHAR(1)
Specifies database-level privileges:

D = DBA (all privileges)
R = Resource (create permanent tables and
indexes)
C = Connect (work within existing tables)
priority
SMALLINT
password
CHAR(8)
The username column is indexed and allows only unique values.
SYSVIEWS
The sysviews system catalog table describes each view defined in the
database. Because the sysviews system catalog table stores the actual SELECT
statement used to create the view, it can contain multiple rows for each view
into the database. The sysviews system catalog table has the following
columns:
Column Name
Type
Explanation
tabid
INTEGER
Table identifier
seqno
SMALLINT
Line number of the SELECT statement
viewtext
CHAR(64)
Actual SELECT statement used to create the view
A composite index for the tabid and seqno columns allows only unique
values.
2-44
System Catalog Map
System Catalog Map

The following System Catalog Map displays the column names of the tables
in an INFORMIX-OnLine Dynamic Server system catalog. The lines connecting
a column in one table to a column in another table indicate columns that
contain the same information.
Figure 2-1
System catalog map
systables
tabid tabname owner dirpath rowsize ncols nindexes nrows created version tabtype audpath
partnum locklevel npused fextsize nextsize flags site dbname
syssyntable
tabid tabname servername dbname owne btabid
syssynonyms
tabid owner synname created
syscolumns
sysdepend
btabid btype dtabid dtype
tabid colno colname coltype collength colmin colmax
syscolauth
tabid colno grantor grantee colauth
sysusers
username usertype priority password
sysindexes
tabid idxname owner idxtype clustered part1part16 levels leaves nunique clust
sysconstraints
tabid idxname constrid constrname owner constrtype
sysopclstr
tabid owner clstrname clstrsize blobcol1blobcol16 clstrkey1clstrkey16
(1 of 2)
System Catalog 2-45
System Catalog Map
systriggers
tabid trigid trigname owner event old new mode
systrigbody
trigid datakey seqno data
sysdistrib
tabid colno seqno constructed mode resolution confidence encdat
sysprocplan
systabauth
procid planid datakey seqno created datasize data
tabid grantor grantee tabauth
sysviews
sysprocbody
tabid seqno viewtext
sysblobs
procid datakey seqno data
sysprocauth
tabid spacename type colno
procid procauth grantee grantor
sysdefaults
tabid colno type default
sysprocedures
procid procname owner mode retsize symsize
datasize codesize numargs
syscoldepend
tabid colno constrid
syschecks
constrid type seqno checktext
sysreferences
constrid primary ptabid updrule delrule matchtype pendant
(2 of 2)
2-46
Information Schema
Information Schema
The Information Schema consists of read-only views that provide information about all the tables, views, and columns on the current database server
to which you have access. In addition, Information Schema views provide
information about SQL dialects (such as Informix, Oracle, or Sybase) and SQL
standards.
This version of the Information Schema views are X/Open CAE standards.
Informix provides them so that applications developed on other database
systems can obtain Informix system catalog information without having to
use the Informix system catalogs directly.
Important: Because the X/Open CAE standards Information Schema views differ
from ANSI-compliant Information Schema views, it is not recommended that you
install the X/Open CAE Information Schema views on ANSI-compliant databases.
The following Information Schema views are available:
tables
columns
sql_languages
server_info
The following sections contain information about generating, accessing, and

the structure of the Information Schema Views.
Generating the Information Schema Views

The Information Schema views are generated automatically when you, as
DBA, run the following DB-Access command:
dbaccess database-name $INFORMIXDIR/etc/xpg4_is.sql
The views are populated by data in the Informix system catalog tables. If
tables, views, or stored procedures exist with any of the same names as the
Information Schema views, you need to either rename the database objects or
System Catalog 2-47
Accessing the Information Schema Views
rename the views in the script before you can install the views. You can drop
the views by using the DROP VIEW statement on each view. Re-create the
views by running the script again.
Important: In addition to the columns specified for each Information Schema view,
individual vendors may include additional columns or change the order of the columns. Informix recommends that applications not use the forms SELECT * or
SELECT table-name.* to access an Information Schema view.
Accessing the Information Schema Views

All Information Schema views have the Select privilege granted to PUBLIC
WITH GRANT OPTION so that all users can query the views. Because no other
privileges are granted on the Information Schema views, they cannot be
updated.
You can query the Information Schema views as you would query any other
table or view in the database.

The following views are described in this section:
tables
columns
sql_languages
server_info
Most columns in the views are defined as VARCHAR data types with large
maximums to accept large names and in anticipation of long identifier names
in future standards.
2-48

TABLES
The tables Information Schema view contains one row for each table to
which you have access. It contains the following columns:
Column Name
Data Type
Explanation
table_schema
VARCHAR(128)
Owner of table
table_name
VARCHAR(128)
Name of table or view
table_type
VARCHAR(128)
BASE TABLE for table or VIEW for view
remarks
VARCHAR(255)
Reserved
The visible rows in the tables view depend on your privileges. For example,
if you have one or more privileges on a table, (such as Insert, Delete, Select,
References, Alter, Index, or Update on one or more columns) or if these privileges have been granted to PUBLIC, you see one row describing that table.
COLUMNS
The columns Information Schema view contains one row for each column
accessible to you. It contains the following columns:
Column Name
Data Type
Explanation
table_schema
VARCHAR(128)
Owner of table
table_name
VARCHAR(128)
Name of table or view
column_name
VARCHAR(128)
Name of the column of the table or view
ordinal_position
INTEGER
Ordinal position of the column. The

ordinal_position of a column in a table is
a sequential number starting at 1 for the
first column.This column is an Informix
extension to XPG4.
data_type
VARCHAR(254)
Contains the data type of the column,

such as CHARACTER or DECIMAL.
char_max_length
INTEGER
Maximum length for character data

types, null otherwise
(1 of 2)
System Catalog 2-49
Column Name
Data Type
Explanation
numeric_precision
INTEGER
Total number of digits allowed for exact

numeric data types (DECIMAL, INTEGER,
MONEY, and SMALLINT), and the
number of digits of mantissa precision
for approximate data types (FLOAT and
SMALLFLOAT), and null for all other
data types. The value is machine
dependent for FLOAT and SMALLFLOAT.
numeric_prec_radix
INTEGER
Uses one of the following values:

2
approximate data types (FLOAT
and SMALLFLOAT)
10
exact numeric data types
(DECIMAL, INTEGER, MONEY,
and SMALLINT)
null for all other data types
numeric_scale
INTEGER
Number of significant digits to the right

of the decimal point for DECIMAL and
MONEY data types:
0
for INTEGER and SMALLINT data
types
null for all other data types
datetime_precision
INTEGER
Number of digits in the fractional part of

the seconds for DATE and DATETIME
columns, null otherwise. This column is
an Informix extension to XPG4.
is_nullable
VARCHAR(3)
Indicates whether a column allows

nulls; either YES or NO
remarks
VARCHAR(254)
Reserved
(2 of 2)
2-50

SQL_LANGUAGES
The sql_languages Information Schema view contains a row for each conformance to standards that the current database server supports. If the database server is INFORMIX-SE, the table shows no rows. The sql_languages
Information Schema view contains the following columns:
Column Name
Data Type
Explanation
source
VARCHAR(254)
Organization that defines this SQL

version
source_year
VARCHAR(254)
Year the source document was approved
conformance
VARCHAR(254)
Which conformance is supported
integrity
VARCHAR(254)
Indicates whether this is an integrity enhancement feature; either YES or NO
implementation
VARCHAR(254)
Identifies the vendors SQL product
binding_style
VARCHAR(254)
Direct, module, or other bind style
programming_lang
VARCHAR(254)
Host language for which the binding

style is adopted
The sql_languages Information Schema view is completely visible to all

users.
SERVER_INFO
The server_info Information Schema view describes the database server to
which the application is currently connected. It contains the following
columns:
Column Name
Data Type
Explanation
server_attribute
VARCHAR(254)
An attribute of the database server
attribute_value
VARCHAR(254)
Value of the server_attribute as it applies to

the current database server
System Catalog 2-51
Each row in this view provides information about one attribute.

X/Open-compliant databases must provide applications with certain
required information about the database server. The server_info view
includes the following information:
server_attribute
Description
identifier_length
Maximum number of characters for a user-defined name
row_length
Maximum length of a row
userid_length
Maximum number of characters of a user name

(or authorization identifier)
txn_isolation
Initial transaction isolation level that the database server

assumes:
READ COMMITTED
Default isolation level for databases created without logging
READ UNCOMMITTED Default isolation level for databases created with logging, but not
ANSI-compliant
SERIALIZABLE
Default isolation level forANSIcompliant databases
collation_seq
Assumed ordering of the character set for the database

server. The following values are possible:
ISO 8859-1
EBCDIC
The Informix representation shows ISO 8859-1
The server_info Information Schema view is completely visible to all users.
2-52
Chapter
Data Types
Database Data Types . . . . . . . . . . .

Effects of NLS . . . . . . . . . . . .
Summary of Data Types . . . . . . . . .
BYTE . . . . . . . . . . . . . . .
CHAR(n) . . . . . . . . . . . . . .
CHARACTER(n) . . . . . . . . . . .
CHARACTER VARYING(m,r) . . . . . .
DATE . . . . . . . . . . . . . . .
DATETIME . . . . . . . . . . . . .
DEC . . . . . . . . . . . . . . .
DECIMAL . . . . . . . . . . . . .
DECIMAL Storage . . . . . . . . .
DOUBLE PRECISION . . . . . . . . .
FLOAT(n). . . . . . . . . . . . . .
INT . . . . . . . . . . . . . . . .
INTEGER . . . . . . . . . . . . . .
INTERVAL . . . . . . . . . . . . .
MONEY(p,s). . . . . . . . . . . . .
NCHAR(n) . . . . . . . . . . . . .
Nonprintable Characters with NCHAR . .
NUMERIC(p,s) . . . . . . . . . . . .
NVARCHAR(m,r) . . . . . . . . . . .
Nonprintable Characters with NVARCHAR
REAL . . . . . . . . . . . . . . .
SERIAL(n) . . . . . . . . . . . . .
SMALLFLOAT . . . . . . . . . . . .
SMALLINT . . . . . . . . . . . . .
TEXT . . . . . . . . . . . . . . .
Nonprintable Characters with TEXT . . .
VARCHAR(m,r) . . . . . . . . . . .
Nonprintable Characters with VARCHAR .
3
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3-3
3-3
3-4
3-5
3-6
3-7
3-8
3-9
3-9
3-12
3-13
3-13
3-15
3-15
3-15
3-16
3-16
3-19
3-20
3-21
3-21
3-21
3-22
3-23
3-23
3-24
3-24
3-25
3-26
3-26
3-27
3-2
Data Type Conversions . . . . . . . . . . . . . . . . .

Converting from Number to Number . . . . . . . . . . .
Converting Between Number and CHAR . . . . . . . . . .
Converting Between DATE and DATETIME . . . . . . . . .
3-28
3-28
3-29
3-30
Range of Operations Using DATE, DATETIME, and INTERVAL .

Manipulating DATETIME Values . . . . . . . . . .
Manipulating DATETIME with INTERVAL Values . . . .
Manipulating DATE with DATETIME and INTERVAL Values.
Manipulating INTERVAL Values . . . . . . . . . . .
Multiplying or Dividing INTERVAL Values . . . . . . .
3-30
3-32
3-33
3-34
3-36
3-36
.
.
.
.
.
.
.
.
.
.
.
.
very column in a table is assigned a data type. The data type

precisely defines the type of values that you can store in that column.
This chapter covers the following topics:
Data types supported by Informix products
Data type conversions
DATE, DATETIME, and INTERVAL values in arithmetic and relational

expressions
Database Data Types

You assign data types with the CREATE TABLE statement and change them
with the ALTER TABLE statement. When you change an existing data type, all
data is converted to the new data type, if possible. For more information on
the ALTER TABLE and CREATE TABLE statements and data type syntax conventions, refer to Chapter 1 of the Informix Guide to SQL: Syntax. For a
detailed discussion of data types, see Chapter 9 of the Informix Guide to SQL:
Tutorial.
Effects of NLS
The NCHAR data type is recognized only when NLS is enabled by setting the
DBNLS environment variable. In addition, the LANG and the LC sublocale
environment variable settings specify a language environment that might
influence the default formats for date, monetary, and numeric values as well
as collation order.
Data Types 3-3
Summary of Data Types
Summary of Data Types

Informix products recognize the data types listed in Figure 3-1. The
remainder of this chapter describes each of these data types.
Figure 3-1
Data types recognized by informix products
Data Type
Explanation
BYTE
Stores any kind of binary data
CHAR
Stores any string of letters, numbers, and symbols
CHARACTER
Is a synonym for CHAR
CHARACTER VARYING
Stores character strings of varying length (ANSIcompliant)
DATE
Stores calendar date
DATETIME
Stores calendar date combined with time of day
DEC
Is a synonym for DECIMAL
DECIMAL
Stores numbers with definable scale and precision
DOUBLE PRECISION
Behaves the same way as FLOAT
FLOAT
Stores double-precision floating numbers corresponding

to the double data type in C
INT
Is a synonym for INTEGER
INTEGER
Stores whole numbers from 2,147,483,647 to

+2,147,483,647
INTERVAL
Stores span of time
MONEY
Stores currency amount
NCHAR
Stores any native string of letters, numbers, and symbols
NUMERIC
Is a synonym for DECIMAL
NVARCHAR
Stores native character strings of varying length
REAL
Is a synonym for SMALLFLOAT
(1 of 2)
3-4
BYTE
Data Type
Explanation
SERIAL
Stores sequential integers
SMALLFLOAT
Stores single-precision floating numbers corresponding

to the float data type in C
SMALLINT
Stores whole numbers from 32,767 to +32,767
TEXT
Stores any kind of text data
VARCHAR
Stores character strings of varying length
(2 of 2)
BYTE
The BYTE data type stores any kind of binary data in an undifferentiated byte
stream. Binary data typically consists of saved spreadsheets, program load
modules, digitized voice patterns, and so on. The INFORMIX-SE database
server does not support this data type.
The BYTE data type has no maximum size. A BYTE column has a theoretical
limit of 231 bytes and a practical limit determined by your disk capacity.
You can store, retrieve, update, or delete the contents of a BYTE column.
However, you cannot use BYTE data items in arithmetic or string operations,
or assign literals to BYTE items with the SET clause of the UPDATE statement.
You also cannot use BYTE items in any of the following ways:
With aggregate functions
With the IN clause
With the MATCHES or LIKE clauses
With the GROUP BY clause
With the ORDER BY clause
You can use BYTE objects in a Boolean expression only if you are testing for
null values.
Data Types 3-5
CHAR(n)
You can insert data into BYTE columns in the following ways:
With the dbload or onload utilities
With the LOAD statement (DB-Access)
From BYTE host variables (INFORMIX-ESQL/C)
By declaring a FILE (INFORMIX-ESQL/COBOL)
You cannot use a quoted text string, number, or any other actual value to
insert or update BYTE columns.
When you select a BYTE column, you can choose to receive all or part of it. To
see it all, use the regular syntax for selecting a column. You can also select any
part of a BYTE column by using subscripts as shown in the following
example:
SELECT cat_picture [1,75] FROM catalog WHERE catalog_num = 10001
This statement reads the first 75 bytes of the cat_picture column associated
with the catalog number 10001.
Tip: If you select a BYTE column using the DB-Access Interactive Schema Editor,
only the phrase BYTE value is returned; no actual value is displayed.
CHAR(n)
The CHAR data type stores any string of letters, numbers, and symbols. A
character column has a maximum length n, where 1 n 32,767. (If you are
using the INFORMIX-SE database server, the maximum length is 32,511.) If
you do not specify n, CHAR(1) is assumed.
Character columns typically store names, addresses, phone numbers, and so
on. Because the length of this column is fixed, when a character value is
retrieved or stored, exactly n bytes of data are transferred. If the value is
shorter than n, the string is extended with spaces to make up the n bytes. If
the value is longer than n, the string is truncated.
If you plan to perform calculations on numbers stored in a column, you
should assign a number data type to that column. Although you can store
numbers in CHAR columns, you might not be able to use them in some arithmetic operations. For example, if you are inserting the sum of values into a
character column, you might experience overflow problems if the character
column is too small to hold the value. In this case, the insert fails. However,
3-6
CHARACTER(n)
numbers that have leading zeros (such as some zip codes) have the zeros
stripped if they are stored as number types INTEGER or SMALLINT. Instead,
store these numbers in CHAR columns.
CHAR values are compared to other CHAR values by taking the shorter value
and padding it on the right with spaces until the values have equal length.
Then, the two values are compared for the full length.
CHAR data types require 1 byte per character, or n bytes.
When NLS has been enabled, CHAR data columns are treated as NCHAR data
columns. For additional information, see the description of the NCHAR data
type on page 3-20.
Nonprintable Characters with CHAR

A CHAR value can include tabs, spaces, and other nonprintable characters.
However, you must use an application to insert the nonprintable characters
into host variables and to insert the host variables into your database. After
passing nonprintable characters to the database server, you can store or
retrieve the characters. When you select nonprintable characters, fetch them
into host variables and display them using your own display mechanism.
The only nonprintable character that you can enter and display with
DB-Access is a tab. If you try to display other nonprintable characters using
DB-Access, your screen returns inconsistent results.
CHARACTER(n)
The CHARACTER data type is a synonym for CHAR.
Data Types 3-7
The CHARACTER VARYING data type stores a character string of varying
length, where m is the maximum size of the column and r is the minimum
amount of space reserved for that column. The INFORMIX-SE database server
does not support this data type. The CHARACTER VARYING data type complies with ANSI standards; the Informix VARCHAR data type displays the
same functionality.
You must specify the maximum size (m) of the CHARACTER VARYING column. The size of this parameter can range from 1 to 255 bytes. If you are placing an index on a CHARACTER VARYING column, the maximum size is 254
bytes. You can store shorter, but not longer, character strings than the value
you specify.
Specifying the minimum reserved space (r) parameter is optional. This value
can range from 0 to 255 bytes but must be less than the maximum size (m) of
the CHARACTER VARYING column. If you do not specify a minimum space
value, it defaults to 0. You should specify this parameter when you initially
intend to insert rows with short or null data in this column, but later expect
the data to be updated with longer values.
Although the use of CHARACTER VARYING economizes on space used
in a table, it has no effect on the size of an index. In an index based on a
CHARACTER VARYING column, each index key has length m, the maximum
size of the column.
When you store a CHARACTER VARYING value in the database, only
its defined characters are stored. The database server does not strip a
CHARACTER VARYING object of any user-entered trailing blanks, nor does
the database server pad the CHARACTER VARYING to the full length of the
column. However, if you specify a minimum reserved space (r) and some
data values are shorter than that amount, some space reserved for rows goes
unused.
CHARACTER VARYING values are compared to other CHARACTER VARYING
values and to character values in the same way that character values are compared. The shorter value is padded on the right with spaces until the values
have equal lengths; then they are compared for the full length.
3-8
DATE
DATE
The DATE data type stores the calendar date. A calendar date is stored
internally as an integer value equal to the number of days since December 31,
1899.
The default display format of a DATE column is shown in the following
example:
mm/dd/yyyy
In this example, mm is the month (1-12), dd is the day of the month

(1-31), and yyyy is the year (0001-9999). For the month, Informix products
accept a number value 1 or 01 for January, and so on. For the day, Informix
products accept a value 1 or 01 that corresponds to the first day of the month,
and so on. If you enter only a two-digit value for year, as in 91 or 92, Informix
products assume that the year is in the twentieth century and assign the
numbers 1 and 9 (19) as the first two digits of the year.
Because date values are stored as integers, you can use them in arithmetic
expressions. For example, you can subtract a DATE value from another DATE
value. The result, a positive or negative INTEGER value, indicates the number
of days that elapsed between the two dates.
DATE data types require 4 bytes per item.
You can change the default date format by changing the DBDATE
environment variable. In addition, NLS lets you define the date and time
format with LC_TIME. See Chapter 4, Environment Variables, for more
information.
DATETIME
The DATETIME data type stores an instant in time expressed as a calendar
date and time of day. You choose how precisely a DATETIME value is stored;
its precision can range from a year to a fraction of a second.
The DATETIME data type is composed of a contiguous sequence of fields that
represents each component of time you want to record and uses the following
syntax:
DATETIME largest_qualifier TO smallest_qualifier
Data Types 3-9
DATETIME
The largest_qualifier and smallest_qualifier can be any one of the fields listed in
Figure 3-2.
Figure 3-2
DATETIME field qualifiers
Qualifier Field
Valid Entries
YEAR
A year numbered from 1 to 9,999 (A.D.)
MONTH
A month numbered from 1 to 12
DAY
A day numbered from 1 to 31, as appropriate to the month
HOUR
An hour numbered from 0 (midnight) to 23
MINUTE
A minute numbered from 0 to 59
SECOND
A second numbered from 0 to 59
FRACTION
A decimal fraction of a second with up to 5 digits of precision.

The default precision is 3 digits (a thousandth of a second). Other precisions are indicated explicitly by writing FRACTION(n),
where n is the desired number of digits from 1 to 5.
A DATETIME column does not need to include all fields from YEAR to
FRACTION; it can include a subset of fields or even a single field. For example,
you can enter a value of MONTH TO HOUR into a column that is defined as
YEAR TO MINUTE, as long as each entered value contains information for a
contiguous sequence of fields. You cannot, however, define a column for just
MONTH and HOUR; this entry must also include a value for DAY.
If you are using the DB-Access TABLE menu and you do not specify the
DATETIME qualifiers, the default DATETIME qualifier, YEAR TO YEAR, is
assigned.
A valid DATETIME literal must include the DATETIME keyword, the values to
be entered, and the field qualifiers. (See the discussion of literal DATETIME in
Chapter 1 of the Informix Guide to SQL: Syntax.) You must include these qualifiers because, as noted earlier, the value you enter can contain fewer fields
than defined for that column. Acceptable qualifiers for the first and last fields
are identical to the list of valid DATETIME fields listed in Figure 3-2.
3-10
DATETIME
Values for the field qualifiers are written as integers and separated by
delimiters. Figure 3-3 lists the delimiters that are used with DATETIME
values.
Figure 3-3
Delimiters used with DATETIME
Delimiter
Placement in DATETIME Expression
hyphen
Between the YEAR, MONTH, and DAY portions of the value
space
Between the DAY and HOUR portions of the value
colon
Between the HOUR and MINUTE and the MINUTE and SECOND
portions of the value
decimal point
Between the SECOND and FRACTION portions of the value
Figure 3-4 shows a DATETIME YEAR TO FRACTION(3) value with delimiters
93-08-16 12:42:06.001
year
minute
day
month
hour
Figure 3-4
Example DATETIME
value with delimiters
fraction
second
When you enter a value with fewer fields than the defined column, the value
you enter is expanded automatically to fill all the defined fields. If you leave
out any more-significant fields, that is, fields of larger magnitude than any
value you supply, those fields are filled automatically with the current date.
If you leave out any less-significant fields, those fields are filled with zeros (or
a one for MONTH and DAY) in your entry.
Data Types 3-11
DEC
You also can enter DATETIME values as character strings. However, the
character string must include information for each field defined in the
DATETIME column. The INSERT statement in the following example shows a
DATETIME value entered as a character string:
INSERT into cust_calls (customer_num, call_dtime, user_id,
call_code, call_descr)
VALUES (101, '1993-08-14 08:45', 'maryj', 'D',
'Order late - placed 6/1/92')
In this example, the call_dtime column is defined as DATETIME YEAR TO

MINUTE. This character string must include values for the year, month, day,
hour, and minute fields. If the character string does not contain information
for all defined fields (or adds additional fields), the database server returns
an error. For more information on entering DATETIME values as character
strings, see Chapter 1 of the Informix Guide to SQL: Syntax.
All fields of a DATETIME column are two-digit numbers except for the year
and fraction fields. The year field is stored as four digits. The fraction field
requires n digits where 1 n 5, rounded up to an even number. You can use
the following formula (rounded up to a whole number of bytes) to calculate
the number of bytes required for a DATETIME value:
total number of digits for all fields/2 + 1
For example, a YEAR TO DAY qualifier requires a total of eight digits (four
for year, two for month, and two for day). This data value requires 5, or
(8/2) + 1, bytes of storage.
For information on using DATETIME data in arithmetic and relational expressions, see Range of Operations Using DATE, DATETIME, and INTERVAL
on page 3-30. For information on using DATETIME as a constant expression,
see Chapter 1 of the Informix Guide to SQL: Syntax.
DEC
The DEC data type is a synonym for DECIMAL.
3-12
DECIMAL
DECIMAL
The DECIMAL data type can take two forms: DECIMAL(p) floating point, and
DECIMAL(p,s) fixed point.
DECIMAL Floating Point

The DECIMAL data type stores decimal floating-point numbers up to a
maximum of 32 significant digits, where p is the total number of significant
digits (the precision). Specifying precision is optional. If you do not specify the
precision (p), DECIMAL is treated as DECIMAL(16), a floating decimal with a
precision of 16 places. DECIMAL(p) has an absolute value range between
10-130 and 10124.
If you are using a MODE ANSI database and specify DECIMAL (p), the value
defaults to DECIMAL (p, 0). See the following discussion for more information
about fixed-point decimal values.
DECIMAL Fixed Point

In fixed-point numbers, DECIMAL(p,s), the decimal point is fixed at a specific
place, regardless of the value of the number. When you specify a column of
this type, you write its precision (p) as the total number of digits it can store,
from 1 to 32. You write its scale (s) as the total number of digits that fall to the
right of the decimal point. All numbers with an absolute value less than
0.5 10-s have the value zero. The largest absolute value of a variable of this
type that you can store without an error is 10 p-s 10-s. A DECIMAL data type
column typically stores numbers with fractional parts that must be stored
and displayed exactly (for example, rates or percentages).
DECIMAL Storage
The database server uses 1 byte of disk storage to store two digits of a decimal
number. The database server uses an additional byte to store the exponent
and sign. The significant digits to left of the decimal and the significant digits
to the right of the decimal are stored on separate groups of bytes. This is best
illustrated with an example. If you specify DECIMAL(6,3), the data type consists of three significant digits to the left of the decimal and three significant
digits to the right of the decimal (for instance, 123.456). The three digits to the
left of the decimal are stored on 2 bytes (where one of the bytes only holds a
Data Types 3-13
DECIMAL
single digit) and the three digits to the right of the decimal are stored on
another 2 bytes as illustrated in Figure 3-5. With the additional byte required
for the exponent and sign, this data type requires a total of 5 bytes of storage.
Byte 1
-
Byte 2
1
Byte 3
3
Significant digits to the left of

decimal
Byte 4
5
Significant digits to the right of

decimal
Figure 3-5
Schematic
illustrating the
storage of digits in a
decimal value. (The
exponent byte is not
shown.)
You can use the following formulas (rounded down to a whole number of
bytes) to calculate the byte storage (N) for a decimal data type (N includes the
byte required to store the exponent and sign):
If the scale is odd: N = (precision + 4) / 2
If the scale is even: N = (precision + 3) / 2
For example, the data type DECIMAL(5,3) requires 4 bytes of storage (9/2
rounded down equals 4).
There is one caveat to these formulas. The maximum number of bytes the
database server uses to store a decimal value is 17. One byte is used to store
the exponent and sign leaving 16 bytes to store up to 32 digits of precision. If
you specify a precision of 32 and an odd scale, however, you lose 1 digit of precision. Consider, for example, the data type DECIMAL(32,31). This decimal is
defined as 1 digit to the left of the decimal and 31 digits to the right. The 1
digit to the left of the decimal requires 1 byte of storage. This leaves only 15
bytes of storage for the digits to the right of the decimal. The 15 bytes can
accommodate only 30 digits, so 1 digit of precision is lost.
3-14
DOUBLE PRECISION
DOUBLE PRECISION
Columns defined as DOUBLE PRECISION behave the same as those defined
for FLOAT.
FLOAT(n)
The FLOAT data type stores double-precision floating-point numbers with up
to 16 significant digits. FLOAT corresponds to the double data type in C. The
range of values for the FLOAT data type is the same as the range of values for
the C double data type on your computer.
You can use n to specify the precision of a FLOAT data type, but SQL ignores
the precision. The value n must be a whole number between 1 and 14.
A column with the FLOAT data type typically stores scientific numbers that
can be calculated only approximately. Because floating-point numbers retain

only their most significant digits, the number you enter in this type of column
and the number the database server displays can differ slightly. This depends
on how your computer stores floating-point numbers internally. For example, you might enter a value of 1.1000001 into a FLOAT field and, after processing the SQL statement, the database server might display this value as 1.1.
This occurs when a value has more digits than the floating-point number can
store. In this case, the value is stored in its approximate form with the least
significant digits treated as zeros.
FLOAT data types usually require 8 bytes per value.
INT
The INT data type is a synonym for INTEGER.
Data Types 3-15
INTEGER
INTEGER
The INTEGER data type stores whole numbers that range from 2,147,483,647
to 2,147,483,647. The maximum negative number, 2,147,483,648, is a
reserved value and cannot be used. The INTEGER data type is stored as a
signed binary integer and is typically used to store counts, quantities, and so
on.
Arithmetic operations and sort comparisons are performed more efficiently
on integer data than on float or decimal data. However, INTEGER columns
can store only a limited range of values. If the data value exceeds the numeric
range, the database server does not store the value.
INTEGER data types require 4 bytes per value.
INTERVAL
The INTERVAL data type stores a value that represents a span of time.
INTERVAL types are divided into two classes: year-month intervals and
day-time intervals. A year-month interval can represent a span of years and
months, and a day-time interval can represent a span of days, hours, minutes,
seconds, and fractions of a second.
An INTERVAL value always is composed of one value, or a contiguous
sequence of values, that represent a component of time. An INTERVAL data
type is defined using the following example:
INTERVAL largest_qualifier(n) TO smallest_qualifier(n)
In this example, the largest_qualifier and smallest_qualifier fields are taken from
one of the two INTERVAL classes shown in Figure 3-6, and n optionally specifies the precision of the largest field (and smallest field if it is a FRACTION).
3-16
INTERVAL
Figure 3-6
Interval Classes
Qualifier Field
Valid Entry
YEAR-MONTH
INTERVAL Class
YEAR
A number of years
MONTH
A number of months
DAY-TIME
INTERVAL Class
DAY
A number of days
HOUR
A number of hours
MINUTE
A number of minutes
SECOND
A number of seconds
FRACTION
A decimal fraction of a second, with up to

5 digits of precision. The default precision
is 3 digits (thousandth of a second). Other
precisions are indicated explicitly by writing FRACTION(n), where n is the desired
number of digits from 1 to 5.
As with a DATETIME column, you can define an INTERVAL column to include

a subset of the fields you need; however, because the INTERVAL data type
represents a span of time that is independent of an actual date, you cannot
combine the two INTERVAL classes. For example, because the number of
days in a month depends on which month it is, a single INTERVAL data value
cannot combine months and days.
A value entered into an INTERVAL column need not include all fields
contained in the column. For example, you can enter a value of HOUR TO
SECOND into a column defined as DAY TO SECOND. However, a value must
always consist of a contiguous sequence of fields. In the previous example,
you cannot enter just HOUR and SECOND values; you must also include
MINUTE values.
A valid INTERVAL literal contains the INTERVAL keyword, the values to be
entered, and the field qualifiers. (See the discussion of the Literal Interval segment in Chapter 1 of the Informix Guide to SQL: Syntax.) When a value
contains only one field, the largest and smallest fields are the same.
Data Types 3-17
INTERVAL
When you enter a value in an INTERVAL column, you must specify the largest
and smallest fields in the value, just as you do for DATETIME values. In addition, you can use n optionally to specify the precision of the first field (and the
last field if it is a FRACTION). If the largest and smallest field qualifiers are
both FRACTIONS, you can specify only the precision in the last field. Acceptable qualifiers for the largest and smallest fields are identical to the list of
INTERVAL fields displayed in Figure 3-6.
If you are using the DB-Access TABLE menu and you do not specify the
INTERVAL field qualifiers, the default INTERVAL qualifier, YEAR TO YEAR, is
assigned.
The largest_qualifier in an INTERVAL value can be up to nine digits (except for
FRACTION, which cannot be more than five digits), but if the value you want
to enter is greater than the default number of digits allowed for that field, you
must explicitly identify the number of significant digits in the value you are
entering. For example, to define an INTERVAL of DAY TO HOUR that can store
up to 999 days, you could specify it as shown in the following example:
INTERVAL DAY(3) TO HOUR
INTERVAL values use the same delimiters as DATETIME values. The
delimiters are shown in Figure 3-7.

Figure 3-7
INTERVAL delimiters
3-18
Delimiter
Placement in DATETIME Expression
hyphen
Between the YEAR and MONTH
space
Between the DAY and HOUR portions of the value
colon
Between the HOUR and MINUTE and the MINUTE and SECOND
portions of the value
decimal point
Between the SECOND and FRACTION portions of the value
MONEY(p,s)
You also can enter INTERVAL values as character strings. However, the
character string must include information for the identical sequence of fields
defined for that column. The INSERT statement in the following example
shows an INTERVAL value entered as a character string:
INSERT INTO manufact (manu_code, manu_name, lead_time)
VALUES ('BRO', 'Ball-Racquet Originals', '160')
Because the lead_time column is defined as INTERVAL DAY(3) TO DAY, this

INTERVAL value requires only one field, the span of days required for lead
time. Note that if the character string does not contain information for all
fields (or adds additional fields), the database server returns an error. For
more information on entering INTERVAL values as character strings, see
By default, all fields of an INTERVAL column are two-digit numbers except
for the year and fraction fields. The year field is stored as four digits. The fraction field requires n digits where 1 n 5, rounded up to an even number.
You can use the following formula (rounded up to a whole number of bytes)
to calculate the number of bytes required for an INTERVAL value:
total number of digits for all fields/2 + 1
For example, a YEAR TO MONTH qualifier requires a total of six digits (four
for year and two for month). This data value requires 4, or (6/2) + 1, bytes of
storage.
For information on using INTERVAL data in arithmetic and relational
operations, see Range of Operations Using DATE, DATETIME,
and INTERVAL on page 3-30. For information on using INTERVAL as a constant expression, see the description of the INTERVAL Field Qualifier segment
in Chapter 1 of the Informix Guide to SQL: Syntax.
MONEY(p,s)
The MONEY data type stores currency amounts. As with the DECIMAL data
type, the MONEY data type stores fixed-point numbers up to a maximum of
32 significant digits, where p is the total number of significant digits (the precision) and s is the number of digits to the right of the decimal point (the
scale).
Data Types 3-19
NCHAR(n)
Unlike the DECIMAL data type, the MONEY data type always is treated as a
fixed-point decimal number. The data type MONEY(p) is defined as
DECIMAL(p,2). If the precision and scale parameters are not specified,
MONEY is interpreted as DECIMAL(16,2).
Values in MONEY columns are displayed with a currency symbol (by default,
a dollar sign) and a decimal point. You can use the following formula
(rounded up to a whole number of bytes) to calculate the byte storage for a
MONEY data type:
If the scale is odd: N = (precision + 4) / 2
If the scale is even: N = (precision + 3) / 2
For example, a MONEY data type with a precision of 16 and a scale of 2

(MONEY(16,2)) requires 9, or (16 + 3)/2, bytes of storage.
You can change the display format for money values by changing the
DBMONEY environment variable. In addition, NLS lets you define money
value formats with the LC_MONETARY environment variable. See Chapter 4,
Environment Variables, for more information.
NCHAR(n)
The NCHAR data type is recognized only when NLS is enabled by setting the
DBNLS environment variable. The NCHAR data type stores any string of letters, numbers, and symbols. A native-character column has a logical size of n
characters, depending on the code set. For the supported European
languages/code sets, the NCHAR data type requires 1 byte per character. The
total size of an NCHAR column cannot exceed 32,767 bytes for the
INFORMIX-OnLine Dynamic Server database server or 32,511 bytes for the
INFORMIX-SE database server. If you do not specify n, NCHAR(1) is assumed.
Native-character columns typically store names, addresses, phone numbers,
and so on. Because the length of this column is fixed, when a native-character
value is retrieved or stored, exactly n bytes of data are transferred. If the value
is shorter than n, the string is extended with spaces to make up the n bytes. If
the value is longer than n, the string is truncated.
An NCHAR value can include tabs, spaces, and other nonprintable characters.
For additional information about nonprintable characters, see Nonprintable
Characters with CHAR on page 3-7.
3-20
NUMERIC(p,s)
If you plan to perform calculations on numbers stored in a column, you

should assign a number data type to that column. Although you can store
numbers in NCHAR columns, you might not be able to use them in some
arithmetic operations. For example, if you are inserting the sum of values into
a character column, you might experience overflow problems if the native
character column is too small to hold the value. In this case, the insert fails.
Numbers that have leading zeros (such as some zip codes) have the zeros
stripped if they are stored as the number types INTEGER or SMALLINT.
Instead, store these numbers in NCHAR columns.
Nonprintable Characters with NCHAR

An NCHAR value can include tabs, spaces, and other nonprintable characters.
However, you must use an application to insert the nonprintable characters
into host variables and to insert the host variables into your database. After
passing nonprintable characters to the database server, you can store or
The only nonprintable character that you can enter and display with
DB-Access is a tab. If you try to display other nonprintable characters using
NUMERIC(p,s)
The NUMERIC data type is a synonym for fixed-point DECIMAL.
NVARCHAR(m,r)
The NVARCHAR data type is recognized only when NLS is enabled by setting
the DBNLS environment variable. The NVARCHAR data type stores a nativecharacter string of varying length, where m is the maximum size of the column and r is the minimum amount of space reserved for that column,
depending on the code set. The INFORMIX-SE database server does not support this data type.
An NVARCHAR value can include tabs, spaces, and other nonprintable
characters. For additional information about nonprintable characters, see
Nonprintable Characters with NVARCHAR on page 3-22.
Data Types 3-21
NVARCHAR(m,r)
You must specify the maximum size (m) of the NVARCHAR column. The size
of this parameter cannot exceed 255 bytes, although the logical number of
native characters can be smaller. If you are placing an index on an
NVARCHAR column, the maximum size is 254 bytes. You can store shorter,
but not longer, native-character strings than the value you specify.
the NVARCHAR column. If you do not specify a minimum space value, it
defaults to 0. Specify this parameter when you initially intend to insert rows
with short or null data in this column but later expect the data to be updated
with longer values.
Although using NVARCHAR economizes on space used in a table, it has no
effect on the size of an index. In an index based on an NVARCHAR column,
each index key has length m, the maximum size of the column.
The database server does not strip an NVARCHAR object of any user-entered
trailing blanks nor does the database server pad the NVARCHAR to the full
length of the column. However, if you specify a minimum reserved space (r)
and some of the data values are shorter than that amount, some of the space
reserved for rows goes unused.
Nonprintable Characters with NVARCHAR

An NVARCHAR value can include tabs, spaces, and other nonprintable
characters. However, you must use an application to insert the nonprintable
characters into host variables and to insert the host variables into your database. After passing nonprintable characters to the database server, the characters can be stored or retrieved. When you select nonprintable characters,
fetch them into host variables and display them using your own display
mechanism.
NVARCHAR treats C null (binary 0) and string terminators as termination
characters for nonprintable characters.

The only nonprintable NVARCHAR character that you can store and retrieve
in DB-Access is a tab. If you try to display other nonprintable characters in
3-22
REAL
REAL
The REAL data type is a synonym for SMALLFLOAT.
SERIAL(n)
The SERIAL data type stores a sequential integer assigned automatically by
the database server when a row is inserted. (For more information on inserting values into SERIAL columns, see Chapter 1 of the Informix Guide to SQL:
Syntax.) You can define only one SERIAL column in a table.
The SERIAL data type is not automatically a unique column. You must apply
a unique index to this column to prevent duplicate serial numbers.
If you are using the interactive schema editor in DB-Access to define the table,
a unique index is applied automatically to a SERIAL column.
The default serial starting number is 1, but you can assign an initial value, n,
when you create or alter the table. You can assign any number greater than 0
as your starting number. The highest serial number you can assign is
2,147,483,647. If you assign a number greater than 2,147,483,647, you receive
a syntax error.
Once a nonzero number is assigned, it cannot be changed. You can, however,
insert a value into a SERIAL column (using the INSERT statement) or reset the
serial value n (using the ALTER TABLE statement), as long as that value does
not duplicate any existing values in the table. When you insert a number into
a SERIAL column or reset the next value of a SERIAL column, your database
server assigns the next number in sequence to the number entered. However,
if you reset the next value of a SERIAL column to a value that is less than the
values already in that column, the next value is computed using the
following formula:
maximum existing value in SERIAL column + 1
For example, if you reset the serial value of the customer_num column in the
customer table to 50 and the highest-assigned customer number is 128, the
next customer number assigned is 129.
A SERIAL data column is commonly used to store unique numeric codes (for
example, order, invoice, or customer numbers). SERIAL data values require 4
bytes of storage.
Data Types 3-23
SMALLFLOAT
SMALLFLOAT
The SMALLFLOAT data type stores single-precision floating-point numbers
with approximately eight significant digits. SMALLFLOAT corresponds to the
float data type in C. The range of values for a SMALLFLOAT data type is the
same as the range of values for the C float data type on your computer.
A SMALLFLOAT data type column typically stores scientific numbers that can
be calculated only approximately. Because floating-point numbers retain

only their most significant digits, the number you enter in this type of column
and the number the database displays might differ slightly depending on
how your computer stores floating-point numbers internally. For example,
you might enter a value of 1.1000001 into a SMALLFLOAT field and, after
processing the SQL statement, the application development tool might display this value as 1.1. This difference occurs when a value has more digits
than the floating-point number can store. In this case, the value is stored in its
approximate form with the least significant digits treated as zeros.
SMALLFLOAT data types usually require 4 bytes per value.
SMALLINT
The SMALLINT data type stores small whole numbers that range from
32,767 to 32,767. The maximum negative number, 32,768, is a reserved
value and cannot be used. The SMALLINT value is stored as a signed binary
integer.
Integer columns typically store counts, quantities, and so on. Because the
SMALLINT data type takes up only 2 bytes per value, arithmetic operations
are performed very efficiently. However, this data type stores a limited range
of values. If the values exceed the range between the minimum and
maximum numbers, the database server does not store the value and
provides you with an error message.
3-24
TEXT
TEXT
The TEXT data type stores any kind of text data. The INFORMIX-SE database
server does not support this data type.
The TEXT data type has no maximum size. A TEXT column has a theoretical
limit of 231 bytes and a practical limit determined by your available disk
storage.
TEXT columns typically store memos, manual chapters, business documents,
program source files, and so on. A data object of type TEXT can contain a combination of printable ASCII characters and the following control characters:
Tabs (CTRL-I)
New lines (CTRL-J)
New pages (CTRL-L)
You can store, retrieve, update, or delete the contents of a TEXT column.
However, you cannot use TEXT data items in arithmetic or string operations,
or assign literals to TEXT items with the SET clause of the UPDATE statement.
You also cannot use TEXT items in the following ways:
With aggregate functions
With the IN clause
With the MATCHES or LIKE clauses
With the GROUP BY clause
With the ORDER BY clause
You can use TEXT objects in Boolean expressions only if you are testing for
null values.
You can insert data into TEXT columns in the following ways:
With the dbload or onload utilities
With the LOAD statement (DB-Access)
From TEXT host variables (INFORMIX-ESQL/C)
By declaring a FILE (INFORMIX-ESQL/COBOL)
You cannot use a quoted text string, number, or any other actual value to
insert or update TEXT columns.
Data Types 3-25
VARCHAR(m,r)
When you select a TEXT column, you can choose to receive all or part of it. To
see all of a column, use the regular syntax for selecting a column into a variable. You also can select any part of a TEXT column by using subscripts, as
SELECT cat_descr [1,75] FROM catalog WHERE catalog_num = 10001
This statement reads the first 75 bytes of the cat_descr column associated
with catalog number 10001.
Nonprintable Characters with TEXT

A TEXT value can include tabs, spaces, and other nonprintable characters.
However, you must use an Informix SQL API to insert the nonprintable characters into host variables and to insert the host variables into your database.
After passing nonprintable characters to the database server, you can store or
The only nonprintable TEXT character that you can store and retrieve in
DB-Access is a tab. (You can insert only TEXT data with the LOAD statement
through DB-Access.) If you try to display other nonprintable characters in
VARCHAR(m,r)
The VARCHAR data type stores a character string of varying length, where m
is the maximum size of the column and r is the minimum amount of space
reserved for that column. The INFORMIX-SE database server does not support
this data type. The VARCHAR data type is the Informix implementation of a
character varying data type. The ANSI standard data type for varying character strings is CHARACTER VARYING described on page 3-8.
You must specify the maximum size (m) of the VARCHAR column. The size of
this parameter can range from 1 to 255 bytes. If you are placing an index on
a VARCHAR column, the maximum size is 254 bytes. You can store shorter,
but not longer, character strings than the value you specify.
the VARCHAR column. If you do not specify a minimum space value, it
3-26
VARCHAR(m,r)
defaults to 0. You should specify this parameter when you initially intend to
insert rows with short or null data in this column, but later expect the data to
be updated with longer values.
Although the use of VARCHAR economizes on space used in a table, it has no
effect on the size of an index. In an index based on a VARCHAR column, each
index key has length m, the maximum size of the column.
When you store a VARCHAR value in the database, only its defined characters
are stored. The database server does not strip a VARCHAR object of any userentered trailing blanks, nor does the database server pad the VARCHAR to the
full length of the column. However, if you specify a minimum reserved space
(r) and some data values are shorter than that amount, some space reserved
for rows goes unused.
VARCHAR values are compared to other VARCHAR values and to character
values in the same way that character values are compared. The shorter value
is padded on the right with spaces until the values have equal lengths; then
they are compared for the full length.
Nonprintable Characters with VARCHAR

A VARCHAR value can include tabs, spaces, and other nonprintable
characters. However, you must use an SQL API to insert the nonprintable
characters into host variables and to insert the host variables into your
program. After passing nonprintable characters to the database server, the
characters can be stored or retrieved. When you select nonprintable characters, fetch them into host variables and display them using your own display
mechanism.
VARCHAR treats C null (binary 0) and string terminators as termination
characters for nonprintable characters.

The only nonprintable VARCHAR character that you can store and retrieve in
DB-Access is a tab. If you try to display other nonprintable characters in
Data Types 3-27
Data Type Conversions
Data Type Conversions

You might want to change the data type of a column when you need to store
larger values than the current data type can accommodate. For example, if
you create a SMALLINT column and later find that you need to store integers
larger than 32,768, you must change the data type of that column to store the
larger value. You can use the ALTER TABLE statement to change the data type
of that column.
If you change data types, the new data type must be able to store all the old
values. For example, if you try to convert a column from the INTEGER data
type to the SMALLINT data type and the following values exist in the INTEGER column, the database server does not change the data type because
SMALLINT columns cannot accommodate numbers greater than 32,768:
100
400
700
50000
700
The same situation might occur if you attempt to transfer data from FLOAT
or SMALLFLOAT columns to INTEGER, SMALLINT, or DECIMAL columns.
Converting from Number to Number

When you convert columns from one number data type to another, you
occasionally find rounding errors. Figure 3-8 indicates which numeric data
type conversions are acceptable and what kinds of errors you can encounter
when you convert between certain numeric data types.
3-28
Converting Between Number and CHAR
Figure 3-8
Numeric data type conversion chart
From:
To:
SMALLINT INTEGER SMALLFLOAT
SMALLINT
FLOAT
DECIMAL
OK
OK
OK
OK
INTEGER
OK
OK
SMALLFLOAT
OK
OK
FLOAT
OK
DECIMAL
Legend:
OK = No error
O = An error can occur depending on precision of the decimal
X = An error can occur depending on data
F = No error, but less significant digits might be lost
For example, if you convert a FLOAT column to DECIMAL(4,2), your database

server rounds off the floating-point numbers before storing them as decimal
numbers. This conversion can result in an error depending on the precision
assigned to the DECIMAL column.
Converting Between Number and CHAR

You can convert a CHAR (or NCHAR) column to a number column and vice
versa. However, if the CHAR or NCHAR column contains any characters that
are not valid in a number column (for example, the letter l instead of the
number 1), your database server cannot complete the ALTER TABLE statement and leaves the column values as characters. You receive an error and the
statement is rolled back (whether you are in a transaction or not).
In INFORMIX-SE, the original table is unchanged, but the system catalog
tables might be in an inconsistent state.
Data Types 3-29
Converting Between DATE and DATETIME
Converting Between DATE and DATETIME

You can convert DATE columns to DATETIME columns. However, if the
DATETIME column contains more fields than the DATE column, the database
server either ignores the fields or fills them with zeros. The illustrations in the
following list show how these two data types are converted (assuming that
the default date format is mm/dd/yyyy):
If you convert DATE to DATETIME YEAR TO DAY, the database server

converts the existing DATE values to DATETIME values. For example,
the value 08/15/1994 becomes 1994-08-15.
If you convert DATETIME YEAR TO DAY to DATE, the value

1994-08-15 becomes 08/15/1994.
If you convert DATE to DATETIME YEAR TO SECOND, the database

server converts existing DATE values to DATETIME values and fills in
the additional DATETIME fields with zeros. For example, 08/15/1994
becomes 1994-08-15 00:00:00.
If you convert DATETIME YEAR TO SECOND to DATE, the database

server converts existing DATETIME to DATE values but drops fields
more precise than DAY. For example, 1994-08-15 12:15:37 becomes
08/15/1994.
Range of Operations Using DATE, DATETIME,

and INTERVAL
You can use DATE, DATETIME, and INTERVAL data in a variety of arithmetic
and relational expressions. You can manipulate a DATETIME value with
another DATETIME value, an INTERVAL value, the current time (identified by
the keyword CURRENT), or a specified unit of time (identified by the keyword UNITS). In most situations, you can use a DATE value wherever it is
appropriate to use a DATETIME value and vice versa. You also can manipulate an INTERVAL value with the same choices as a DATETIME value. In
addition, you can multiply or divide an INTERVAL value by a number.
An INTERVAL column can hold a value that represents the difference
between two DATETIME values or the difference between (or sum of) two
INTERVAL values. In either case, the result is a span of time, which is an
3-30
Range of Operations Using DATE, DATETIME, and INTERVAL
INTERVAL value. On the other hand, if you add or subtract an INTERVAL

value from a DATETIME value, another DATETIME value is produced because
the result is a specific point in time.

Figure 3-9 indicates the range of expressions that you can use with DATE,
DATETIME, and INTERVAL data, along with the data type that results from
each expression.
Figure 3-9
Range of expressions for DATE, DATETIME, and INTERVAL
Data Type of Operand 1
Operator
Data Type of Operand 2
Result
DATE
DATETIME
INTERVAL
DATETIME
DATE
INTERVAL
DATE
+ or
INTERVAL
DATETIME
DATETIME
DATETIME
INTERVAL
DATETIME
+ or
INTERVAL
DATETIME
INTERVAL
DATETIME
DATETIME
INTERVAL
+ or
INTERVAL
INTERVAL
DATETIME
CURRENT
INTERVAL
CURRENT
DATETIME
INTERVAL
INTERVAL
CURRENT
DATETIME
CURRENT
+ or
INTERVAL
DATETIME
DATETIME
+ or
UNITS
DATETIME
INTERVAL
+ or
UNITS
INTERVAL
INTERVAL
or /
NUMBER
INTERVAL
No other combinations are allowed. You cannot add two DATETIME values
because this operation does not produce either a point in time or a span of
time. For example, you cannot add December 25 and January 1, but you can
subtract one from the other to find the time span between them.
Data Types 3-31
Manipulating DATETIME Values
Manipulating DATETIME Values

You can subtract most DATETIME values from each other. Dates can be in any
order and the result is either a positive or a negative INTERVAL value. The
first DATETIME value determines the field precision of the result.
If the second DATETIME value has fewer fields than the first, the shorter value
is extended automatically to match the longer one. (See the discussion of the
EXTEND function in the Expression segment in Chapter 1 of the Informix
Guide to SQL: Syntax.) In the following example, subtracting the DATETIME
YEAR TO HOUR value from the DATETIME YEAR TO MINUTE value results in
a positive interval value of 60 days, 1 hour, and 30 minutes. Because minutes
were not included in the second value, the database server sets the minutes
for the result to 0.
DATETIME (1994-9-30 12:30) YEAR TO MINUTE
- DATETIME (1994-8-1 11) YEAR TO HOUR
Result: INTERVAL (60 01:30) DAY TO MINUTE
If the second DATETIME value has more fields than the first (regardless of
whether the precision of the extra fields is larger or smaller than those in the
first value), the additional fields in the second value are ignored in the
calculation.
In the following expression (and result), the year is not included for the
second value. Therefore, the year is set automatically to the current year, in
this case 1994, and the resulting INTERVAL is negative, indicating that the
second date is later than the first.
DATETIME (1994-9-30) YEAR TO DAY
- DATETIME (10-1) MONTH TO DAY
Result: INTERVAL (1) DAY TO DAY [assuming current year
is 1994]
3-32

INTERVAL values can be added to or subtracted from DATETIME values. In
either case, the result is a DATETIME value. If you are adding an INTERVAL
value to a DATETIME value, the order of values is unimportant; however, if
you are subtracting, the DATETIME value must come first. Adding or
subtracting an INTERVAL value simply moves the DATETIME value forward
or backward in time. The expression shown in the following example moves

the date ahead three years and five months:
DATETIME (1991-8-1) YEAR TO DAY
+ INTERVAL (3-5) YEAR TO MONTH
Result: DATETIME (1995-01-01) YEAR TO DAY
Important: Evaluate the logic of your addition or subtraction. Remember that months
can be 28, 29, 30, or 31 days and that years can be 365 or 366 days.
In most situations, the database server automatically adjusts the calculation
when the initial values do not have the same precision. However, in certain
situations, you must explicitly adjust the precision of one value to perform
the calculation. If the INTERVAL value you are adding or subtracting has
fields that are not included in the DATETIME value, you must use the EXTEND
function to explicitly extend the field qualifier of the DATETIME value. (For
more information on the EXTEND function, see the Expression segment in
Chapter 1 of the Informix Guide to SQL: Syntax.) For example, you cannot subtract a minute INTERVAL value from the DATETIME value in the previous
example that has a YEAR TO DAY field qualifier. You can, however, use the
EXTEND function to perform this calculation, as shown in the following
example:
EXTEND (DATETIME (1994-8-1) YEAR TO DAY, YEAR TO MINUTE)
- INTERVAL (720) MINUTE(3) TO MINUTE
Result: DATETIME (1994-07-31 12:00) YEAR TO MINUTE
The EXTEND function allows you to increase explicitly the DATETIME

precision from YEAR TO DAY to YEAR TO MINUTE. This allows the database
server to perform the calculation, with the resulting extended precision of
YEAR TO MINUTE.
Data Types 3-33
Manipulating DATE with DATETIME and INTERVAL Values

You can use DATE values in arithmetic expressions with DATETIME or
INTERVAL values by writing expressions that allow the manipulations
shown in Figure 3-10.
Figure 3-10
Results of expressions that manipulate DATE with DATETIME or INTERVAL values
Expression
Result
DATE - DATETIME
INTERVAL
DATETIME - DATE
INTERVAL
DATE + or - INTERVAL
DATETIME
In the cases shown in Figure 3-10, DATE values are first converted to their
corresponding DATETIME equivalents, and then the expression is computed
normally.
Although you can interchange DATE and DATETIME values in many
situations, you must indicate whether a value is a DATE or a DATETIME data
type. A DATE value can come from the following sources:
A column or program variable of type DATE
The TODAY keyword
The DATE() function
The MDY function
A DATETIME value can come from the following sources:
3-34
A column or program variable of type DATETIME
The CURRENT keyword
The EXTEND function
A DATETIME literal
When you represent DATE and DATETIME values as quoted character strings,
the fields in the strings must be in proper order. In other words, when a DATE
value is expected, the string must be in DATE format and when a DATETIME
value is expected, the string must be in DATETIME format. For example, you
can use the string '10/30/1994' as a DATE string but not as a DATETIME
string. Instead, you must use '1994-10-30' or '94-10-30' as the DATETIME
string.
You also can subtract one DATE value from another DATE value, but the
result is a positive or negative INTEGER value rather than an INTERVAL
value. If an INTERVAL value is required, you can either convert the INTEGER
value into an INTERVAL value or one of the DATE values into a DATETIME
value before subtracting.
For example, the following expression uses the DATE() function to convert
character string constants to DATE values, calculates their difference, and
then uses the UNITS DAY keywords to convert the INTEGER result into an
INTERVAL value:
(DATE ('5/2/1994') - DATE ('4/6/1955')) UNITS DAY
Result: INTERVAL (12810) DAY(5) TO DAY
If you need YEAR TO MONTH precision, you can use the EXTEND function on
the first DATE operand, as shown in the following example:
EXTEND (DATE ('5/2/1994'), YEAR TO MONTH) DATE ('4/6/1955')
Result: INTERVAL (35-01) YEAR TO MONTH
Note that the resulting INTERVAL precision is YEAR TO MONTH because the
DATETIME value came first. If the DATE value had come first, the resulting
INTERVAL precision would have been DAY(5) TO DAY.
Data Types 3-35
Manipulating INTERVAL Values
Manipulating INTERVAL Values

You can add or subtract INTERVAL values as long as both values are from the
same class; that is, both are year-month or both are day-time. In the following
example, a SECOND TO FRACTION value is subtracted from a MINUTE TO
FRACTION value:
INTERVAL (100:30.0005) MINUTE(3) TO FRACTION(4)
- INTERVAL (120.01) SECOND(3) TO FRACTION
Result: INTERVAL (98:29.9905) MINUTE TO FRACTION(4)
Note the use of numeric qualifiers to alert the database server that the
MINUTE and FRACTION in the first value and the SECOND in the second
value exceed the default number of digits.
When you add or subtract INTERVAL values, the second value cannot have a
field with greater precision than the first. The second INTERVAL, however,
can have a field of smaller precision than the first. For example, the second
INTERVAL can be HOUR TO SECOND when the first is DAY TO HOUR. The
additional fields (in this case MINUTE and SECOND) in the second INTERVAL
value are ignored in the calculation.
Multiplying or Dividing INTERVAL Values

You can multiply or divide INTERVAL values by a number that can be an integer or a fraction. However, any remainder from the calculation is ignored and
the result is truncated. The following expression multiplies an INTERVAL by
a fraction:
INTERVAL (15:30.0002) MINUTE TO FRACTION(4) * 2.5
Result: INTERVAL (38:45.0005) MINUTE TO FRACTION(4)
In this example, 15 2.5 = 37.5 minutes, 30 2.5 = 75 seconds, and

2 2.5 = 5 fraction(4). The 0.5 minute is converted into 30 seconds and
60 seconds are converted into 1 minute, which produces the final result of
38 minutes, 45 seconds, and 0.0005 of a second. Note that the results of any
calculation include the same amount of precision as the original INTERVAL
value.
3-36
Chapter
Types of Environment Variables .
4-5
Where to Set Environment Variables . . . . . . . .

Setting Environment Variables at the System Prompt .
Setting Environment Variables in a Environment
Configuration File . . . . . . . . . . .
Setting Environment Variables at Login Time . . .
.
.
.
.
.
.
.
.
.
.
4-6
4-6
.
.
.
.
.
.
.
.
.
.
4-6
4-7
Manipulating Environment Variables . . . . . .

Setting Environment Variables . . . . . . .
Viewing Your Current Settings . . . . . . .
Unsetting Environment Variables . . . . . .
Modifying the Setting of an Environment Variable
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
4-8
4-8
4-9
4-9
4-9
Rules of Precedence
4-10
NLS Environment Variables . . . . . . . . . . .

Rules of Precedence for NLS Environment Variables .
.
.
.
.
.
.
.
.
.
.
4-11
4-11
UNIX Environment Variables .
4-11
List of Environment Variables .
4-12
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
4-15
4-15
4-15
4-16
4-17
4-18
4-18
4-19
4-20
4-20
Environment Variables . . . . . . .
ARC_DEFAULT . . . . . . . .
ARC_KEYPAD . . . . . . . . .
COLLCHAR . . . . . . . . . .
Using pre-Version 6.0 SQL APIs. .
Using Version 6.0 or Later SQL APIs
DBANSIWARN. . . . . . . . .
DBAPICODE . . . . . . . . .
Creating Mapping Files . . . .
DBBLOBBUF . . . . . . . . .
DBDATE . . . . . .
DBDELIMITER . . . .
DBEDIT . . . . . .
DBLANG . . . . . .
DBMONEY . . . . .
DBNLS. . . . . . .
DBPATH . . . . . .
DBPRINT . . . . . .
DBREMOTECMD . . .
DBSPACETEMP . . .
DBTEMP . . . . . .
DBTIME . . . . . .
DBUPSPACE. . . . .
DELIMIDENT . . . .
ENVIGNORE . . . .
FET_BUF_SIZE . . . .
INFORMIXC. . . . .
INFORMIXCOB . . .
INFORMIXCOBDIR . .
INFORMIXCOBSTORE .
INFORMIXCOBTYPE .
INFORMIXCONRETRY .
INFORMIXCONTIME .
INFORMIXDIR . . . .
INFORMIXSERVER . .
INFORMIXSHMBASE .
INFORMIXSTACKSIZE .
INFORMIXTERM . . .
LANG . . . . . . .
LC_COLLATE . . . .
LC_CTYPE . . . . .
LC_MONETARY . . .
LC_NUMERIC . . . .
LC_TIME . . . . . .
ONCONFIG . . . . .
4-2
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
4-21
4-23
4-23
4-24
4-25
4-26
4-28
4-31
4-32
4-33
4-34
4-34
4-37
4-38
4-38
4-39
4-40
4-40
4-41
4-42
4-43
4-43
4-44
4-46
4-46
4-47
4-48
4-49
4-49
4-51
4-53
4-55
4-56
4-57
4-59
OPTCOMPIND .
PATH . . . .
PDQPRIORITY .
PSORT_DBTEMP
PSORT_NPROCS
SQLEXEC . . .
SQLRM. . . .
SQLRMDIR . .
TERM . . . .
TERMCAP . .
TERMINFO . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
4-59
4-60
4-61
4-62
4-63
4-64
4-65
4-65
4-66
4-66
4-67
Index of Environment Variables.
4-68
4-3
4-4
arious environment variables affect the functionality of your Informix

products. You can set environment variables that identify your terminal,
specify the location of your software, and define other parameters. The environment variables discussed in this chapter are grouped and listed
alphabetically beginning on page 4-11. In addition, an index of environment
variables is included at the end of this chapter, on page 4-68.
Some environment variables are required, and others are optional. For
example, you must setor accept the default setting forcertain UNIX
environment variables.
This chapter describes how to use the environment variables that apply to
one or more Informix products and shows how to set them.
Types of Environment Variables

The environment variables discussed in this chapter fall into the following
categories:
Informix environment variables

Set these standard environment variables when you want to work
with Informix products. Each product manual specifies the environment variables that you must set to use that product. The settings for
some of these variables might take precedence over those for their
NLS counterparts.
NLS environment variables
You must set some or all of these X/Open standard environment

variables to benefit from NLS. These might cause your product to
behave differently than when their standard Informix counterparts
are set. The NLS environment is described in Using Native
Language Support on page 1-16.
Environment Variables 4-5
Where to Set Environment Variables
UNIX environment variables
This section describes the major standard UNIX system environment

variables that are recognized by Informix products.
Where to Set Environment Variables

You can set environment variables in the following ways:
At the system prompt on the command line
In an environment-configuration file
In a login file
Setting Environment Variables at the System Prompt

When you set an environment variable at the system prompt, you must
reassign it the next time you log in to the system. For more information about
how to do this, see Manipulating Environment Variables on page 4-8.
Setting Environment Variables in a Environment

Configuration File
This is a common or private file where you can define all the environment
variables that are used by Informix products. Using a configuration file
reduces the number of environment variables that you must set at the
command line or in a shell file.
The common (shared) environment-configuration file resides in
$INFORMIXDIR/etc/informix.rc. The permission for this shared file must be
set to 644. A user can override the system or common environment variables
by setting variables in a private environment-configuration file. The private
environment-configuration file must have the following characteristics:
4-6
The file is stored in the users home directory
The file is named .informix
Permissions set to readable by the user
An environment configuration file can contain comment lines (preceded by

#) and variable lines and their values (separated by blanks and tabs), as
# This is an example of an environment-configuration file
#
DBDATE DMY4#
# These are ESQL/COBOL environment variable settings
#
INFORMIXCOB rmcobol
INFORMIXCOBTYPE rm85
INFORMIXCOBDIR /usr/lib/rmcobol
Use the ENVIGNORE environment variable to later override one or more

entries in this file. Use the following Informix chkenv utility to perform a
sanity check on the contents of an environment-configuration file, and return
an error message if the file contains a bad environment-variable entry or if the
file is too large:
chkenv filename
The chkenv utility is described in Chapter 5, SQL Utilities.

The first time you set an environment variable in a shell file or configuration
file, before you work with your Informix product, you should source the file
(C shell), or use a period (.) to execute an environment-configuration file
(Bourne or Korn shell). This allows the process to read your entry.

Add the commands that set your environment variables to the following
login file:
For the C shell
.login or .cshrc
For the Bourne shell or Korn shell
.profile
When you set an environment variable in your .login, .cshrc, or .profile file,
it is assigned automatically every time you log in to the system.
Manipulating Environment Variables
Manipulating Environment Variables

The following sections discuss setting, unsetting, viewing, and modifying
environment variables. If you are already using an Informix product, some or
all of the appropriate environment variables might already be set.
Setting Environment Variables

Use standard UNIX commands to set environment variables. Depending on
the type of shell you use, Figure 4-1 shows how you set the ABCD
environment variable to value. The environment variables are case-sensitive.
Figure 4-1
Different shell settings
C shell:
setenv ABCD value
Bourne shell
ABCD=value
export ABCD
Korn shell:
ABCD=value
export ABCD
Korn shell:
export ABCD=value
Note that Korn-shell syntax allows for a shortcut, as shown in the last line of
Figure 4-1.
The following diagram shows how the syntax for setting an environment
variable is represented throughout this chapter. These diagrams indicate the
setting for the C shell; for the Bourne or Korn shell, use the syntax shown in
Figure 4-1.
setenv
ABCD
value
For more information on how to read syntax diagrams, see Command-Line

Conventions in the Introduction.
4-8
Viewing Your Current Settings
Viewing Your Current Settings

After one or more Informix products have been installed, enter the following
command at the system prompt to view your current environment settings:
BSD UNIX:
env
UNIX System V:
printenv
Unsetting Environment Variables

To unset an environment variable, enter the following command:
C shell:
unsetenv ABCD
Bourne shell or
or Korn shell:
unset ABCD
Modifying the Setting of an Environment Variable

Sometimes you must add information to an environment variable that is
already set. For example, the PATH environment variable is always set in
UNIX environments. When you use an Informix product, you must add to the
PATH the name of the directory where the executable files for the Informix
products are stored.
In the following example, the INFORMIXDIR is /usr/informix. (That is,
during installation, the Informix products were installed in the /usr /informix
directory.) The executable files are in the bin subdirectory, /usr/informix/bin.
To add this directory to the C shell PATH environment variable, use the
following command:
setenv PATH /usr/informix/bin:$PATH
Rather than entering an explicit path name, you can use the value of the
INFORMIXDIR environment variable (the $INFORMIXDIR variable), as
shown in the following example,
setenv INFORMIXDIR /usr/informix
setenv PATH $INFORMIXDIR/bin:$PATH
Rules of Precedence
You might prefer to use this version to ensure that your PATH entry does not
contradict the path that was set in INFORMIXDIR and so that you do not have
to reset PATH whenever you change INFORMIXDIR.
If you set the PATH environment variable on the C shell command line, you
might need to include curly braces with the existing INFORMIXDIR and
PATH, as shown in the following command:
setenv PATH ${INFORMIXDIR}/bin:${PATH}
For more information about setting and modifying environment variables,

refer to the manuals for your operating system.
For additional information about the INFORMIXDIR environment variable,
see the INFORMIX-NET/PC Installation and Configuration Guide.
Rules of Precedence
When an Informix product accesses an environment variable, normally the
following rules of precedence apply:
1.
The highest precedence goes to the value as defined in the

environment (shell), either by your login file or by explicitly
setting the value at the shell prompt.
2.
The second-highest precedence goes to the value as defined in the

private environment-configuration file in the users home directory
(~/.informix).
3.
The next-highest precedence goes to the value as defined in the

common environment-configuration file
($INFORMIXDIR/etc/informix.rc).
4.
The lowest precedence goes to the default value.
If NLS is activated, an exception exists to these rules. The setting for any of
the LC_* environment variables (LC_COLLATE, LC_CTYPE, LC_MONETARY,
LC_NUMERIC, LC_TIME) takes precedence over the setting for the LANG
environment variable, no matter where they are set. For more information,
see the discussion beginning on page 4-11.
4-10
NLS Environment Variables
NLS Environment Variables

This chapter alphabetically lists the NLS environment variables (COLLCHAR,
DBAPICODE, DBNLS, LANG, LC_COLLATE, LC_CTYPE, LC_MONETARY,
LC_NUMERIC, LC_TIME) that you can set to use your Informix products in
an environment that supports a European language. The Informix implementation of these environment variables is based on the NLS standards as
specified by X/Open in the XPG3 documents.
These environment variables can take effect only if your application is NLSready. For more information on NLS, see Chapter 1, Informix Databases.
The descriptions of the NLS variables might include references to comparable
Informix environment variables that you can set instead of or in addition to
the NLS variables.
Rules of Precedence for NLS Environment Variables

The following list ranks the order of precedence for NLS environment
variables, from highest to lowest:
1.
Individual LC_* variables set in the shell
2.
Individual LC_* variables set in $HOME/.informix
3.
Individual LC_* variables set in $INFORMIXDIR/etc/informix.rc
4.
The LANG variable set in the shell
5.
The LANG variable set in $HOME/.informix
6.
The LANG variable set in $INFORMIXDIR/etc/informix.rc
7.
If no locale environment variable is set, the default locale, C, is used
UNIX Environment Variables

Informix products rely on the correct setting of certain standard UNIX system
environment variables. The PATH and TERM environment variables must
always be set. You might also have to set the TERMCAP or TERMINFO
environment variable to use some products effectively.
List of Environment Variables

The following table contains an alphabetical list of the environment variables
that you can set for an Informix database server and SQL API products. These
environment variables are described in this chapter on the pages listed in the
last column.
Figure 4-2
Environment Variable
Restrictions
Page
ARC_DEFAULT
OnLine only
4-15
ARC_KEYPAD
OnLine only
4-15
COLLCHAR
4-16
DBANSIWARN
4-18
DBAPICODE
4-19
DBBLOBBUF
OnLine only
4-20
DBDATE
4-21
DBDELIMITER
4-23
DBEDIT
4-23
DBLANG
4-24
DBMONEY
4-25
DBNLS
4-26
DBPATH
4-28
DBPRINT
4-31
DBREMOTECMD
OnLine only
4-32
DBSPACETEMP
OnLine only
4-33
DBTEMP
SE only
4-34
DBTIME
SQL APIs only
4-34
(1 of 3)
4-12
Restrictions
Page
DBUPSPACE
4-37
DELIMIDENT
4-38
ENVIGNORE
4-38
FET_BUF_SIZE
SQL APIs and DB-Access
4-39
INFORMIXC
ESQL/C only
4-40
INFORMIXCOB
ESQL/COBOL only
4-40
INFORMIXCOBDIR
ESQL/COBOL only
4-41
INFORMIXCOBSTORE
ESQL/COBOL only
4-42
INFORMIXCOBTYPE
ESQL/COBOL only
4-43
INFORMIXCONRETRY
4-43
INFORMIXCONTIME
4-44
INFORMIXDIR
4-46
INFORMIXSERVER
4-46
INFORMIXSHMBASE
OnLine only
4-47
INFORMIXSTACKSIZE
OnLine only
4-48
INFORMIXTERM
DB-Access only
4-49
LANG
4-49
LC_COLLATE
4-51
LC_CTYPE
4-53
LC_MONETARY
4-55
LC_NUMERIC
4-56
LC_TIME
4-57
OPTCOMPIND
OnLine only
4-59
ONCONFIG
OnLine only
4-59
(2 of 3)
Restrictions
Page
4-60
PATH
PDQPRIORITY
OnLine only
4-61
PSORT_DBTEMP
OnLine only
4-62
PSORT_NPROCS
OnLine only
4-63
4-64
SQLEXEC
SQLRM
(obsolete)
4-65
SQLRMDIR
(obsolete)
4-65
TERM
4-66
TERMCAP
4-66
TERMINFO
4-67
(3 of 3)
4-14
The following sections discuss the environment variables used by Informix
products.
ARC_DEFAULT
When you use the ON-Archive archive and tape-management system for the
INFORMIX-OnLine Dynamic Server, you can set the ARC_DEFAULT environment variable to indicate where a personal default qualifier file is located.
setenv
pathname
ARC_DEFAULT
pathname
is the full pathname of the personal default qualifier

file.
For example, to set the ARC_DEFAULT environment variable to specify the

file /usr/jane/arcdefault.janeroe enter the following command:
setenv ARC_DEFAULT /usr/jane/arcdefault.janeroe
For more information on archiving, see the INFORMIX-OnLine Dynamic Server

Archive and Backup Guide.
ARC_KEYPAD
If you use the ON-Archive archive and tape-management system for the
INFORMIX-OnLine Dynamic Server, you can set your ARC_KEYPAD environment variable to point to a tctermcap file that is different from the default
tctermcap file. The default is the $INFORMIXDIR/etc/tctermcap file, and it
contains instructions on how to modify the tctermcap file.
COLLCHAR
The tctermcap file serves the following purposes for the ON-Archive menu
interface:
It defines the terminal control attributes that allow ON-Archive to

manipulate the screen and cursor.
It defines the mappings between commands and key presses.
It defines the characters used in drawing menus and borders for an API.
setenv
pathname
pathname
ARC_KEYPAD
is the pathname for a tctermcap file.
For example, to set the ARC_KEYPAD environment variable to specify the file
/usr/jane/tctermcap.janeroe enter the following command:
setenv ARC_KEYPAD /usr/jane/tctermcap.janeroe
For more information on archiving, see the INFORMIX-OnLine Dynamic Server

Archive and Backup Guide.
COLLCHAR
The optional COLLCHAR environment variable allows existing SQL API
programs to take advantage of the NLS collation feature without modification. You must set DBNLS to 1 or 2 if you want to use COLLCHAR.
setenv
COLLCHAR
Set the COLLCHAR environment variable to the value 1 by entering the

following command:
setenv COLLCHAR 1
4-16
COLLCHAR
Using pre-Version 6.0 SQL APIs
When COLLCHAR is set to 1, applications built using pre-Version 6.0 SQL
APIs linked with the Version 6.0 or later libraries can create and sort CHAR
data using the collation sequence set when an NLS database is created (the
NCHAR data type), without changing any code.
During execution, the INFORMIX-OnLine Dynamic Server performs the
following actions:
It maps all NCHAR types in the database to CHAR before sending

them to the SQL API application. The database server also maps all
NVARCHAR types in the database to VARCHAR before sending them
to the SQL API application.
It maps all incoming CHAR references to NCHAR for internal

execution. The database server also maps all incoming VARCHAR
references to NVARCHAR for internal execution.
For example, when COLLCHAR is set, the following statement in an existing

program
EXEC SQL CREATE TABLE mylar (..., col3 CHAR(20), ...)
is executed by the database server, as shown in the following example:

EXEC SQL CREATE TABLE mylar (..., col3 NCHAR(20), ...)
Conversely, after doing a DESCRIBE on a SELECT statement on the table

mylar, which was created in the previous examples, the data type of col3
appears as CHAR (even though it is stored in the database as NCHAR).
DBANSIWARN
Using Version 6.0 or Later SQL APIs
When you use Version 6.0 or later to create an NLS database or to create an
application and access an NLS database using an INFORMIX-ESQL/C or
INFORMIX-ESQL/COBOL application or DB-Access, the following restrictions
apply:
If COLLCHAR is not set, the application or NLS database can contain

both CHAR and NCHAR/NVARCHAR data.
If COLLCHAR is set to 1, you cannot create CHAR columns. However,

the application can access an existing NLS database that contains
CHAR columns, and data in those columns remains as CHAR. If the
column is sorted, it is sorted as as an NCHAR column.
Important: Direct access to the system catalog might result in an error for an
application built with an SQL API prior to Version 6.0 or later because the data types
are not mapped. For example, a SELECT on a system catalog table might show a
column as NCHAR whereas it might otherwise appear as CHAR.
DBANSIWARN
Setting the DBANSIWARN environment variable indicates that you want to
check for Informix extensions to ANSI standard syntax. Unlike most environment variables, you do not need to set DBANSIWARN to a valuesetting it
to any value or to no value, as shown in the following diagram, is sufficient:
setenv
DBANSIWARN
Setting the DBANSIWARN environment variable for DB-Access is

functionally equivalent to including the -ansi flag when invoking the utility
from the command line. If you set DBANSIWARN before you run DB-Access,
warnings are displayed on the screen within the SQL menu.
Set the DBANSIWARN environment variable before you compile an
INFORMIX-ESQL/C or INFORMIX-ESQL/COBOL program to check for Informix extensions to ANSI standard syntax. When Informix extensions to ANSI
standard syntax are encountered in your program at compile time, warning
messages are written to the screen.
4-18
DBAPICODE
At run time, the DBANSIWARN environment variable causes the SQL

Communication Area (SQLCA) variable sqlca.sqlwarn.sqlwarn5 to be set to
W when a statement that is not ANSI-compliant is executed. (For more information on SQLCA, see the INFORMIX-ESQL/C Programmers Manual or the
INFORMIX-ESQL/COBOL Programmers Manual.)
Once you set DBANSIWARN, Informix extension checking is automatic until
you log out or unset DBANSIWARN. To turn off Informix extension checking,
unset the DBANSIWARN environment variable by entering the following
command:
unsetenv DBANSIWARN
DBAPICODE
The DBAPICODE environment variable lets systems that use nonstandard or
rare code sets access databases that store data using a standard code set. Set
DBAPICODE to let applications on different platforms use a different code set
than the one stored in and used by the database server.
With DBAPICODE set, the applications communicate with the database
server using the standard ASCII code set, but interact with the keyboard, terminal display, and program character strings using the code set specified in
DBAPICODE.
codeset_name
setenv
DBAPICODE
codeset_name
specifies the name of a code set mapping file, usually in

the format language_territory.codeset
To use a specific DBAPICODE setting, there must be a mapping file for that
code set in the message directory. For example, for an NLS-ready ESQL/C
application to use the code set specified in the following command with an
NLS database created with the code set FR_fr.646, there must be a mapping
file called mFR_fr.646 in the message directory $INFORMIXDIR/msg, or the
directory must be pointed to by the DBLANG or LANG setting:
setenv DBAPICODE mFR_fr.646
DBBLOBBUF
The recommended setting for DBAPICODE follows a modified version of the

form shown for the other NLS categories (that is, language_territory.codeset).
However, this might not be possible because many terminals or platforms
have unconventional code sets.
DBAPICODE specifies the character-mapping file between itself and the
standard code set. In NLS-ready systems, the standard code set is defined in
the LANG environment variable. In non-NLS systems, the standard code set
is the default 8-bit character set.
Creating Mapping Files

The Informix crtcmap utility helps you create mapping files among
non-standard and standard code sets for use with NLS. It prepends m to the
name of the mapping file it creates. For example, it renames the output file
FR_fr.646 as mFR_fr.646. The crtcmap utility is described on page 5-5.
DBBLOBBUF
The DBBLOBBUF environment variable controls whether a blob is stored
temporarily in memory or in a file while being unloaded with the UNLOAD
statement.
setenv
DBBLOBBUF
represents the maximum size of a blob in kilobytes.
If the blob is smaller than the default of 10 kilogytes or the setting of the
DBBLOBBUF environment variable, it is temporarily stored in memory. If the
blob is larger than the default or the setting of the environment variable, it is
written to a temporary file. This environment variable applies to the
UNLOAD command only.
For instance, to set a buffer size of 15 kilobytes, set the DBBLOBBUF environment variable, as shown in the following example:
setenv DBBLOBBUF 15
In the example, any blobs smaller than 15 kilobytes are stored temporarily in
memory. Blobs larger than 15 kilobytes are stored temporarily in a file.
4-20
DBDATE
DBDATE
The DBDATE environment variable specifies the display formats of date
values. You can specify the following attributes:
setenv
The order of the month, day, and year in a date
Whether the year should be printed with two digits (Y2) or four
digits (Y4)
The separator between the month, day, and year
DBDATE
Y4
Y2
Y4
Y2
/
.
0
-, . /
0
D, M
Y2, Y4
are characters that can be used as separators in a date

format.
indicates that no separator is displayed.
are characters representing day and the month.
are characters that represent the year, and the number
of digits in the year.
The default setting for DBDATE is MDY4/, where M represents the month,
D represents the day, Y4 represents a four-digit year, and slash (/) is a
separator (for example, 10/08/1994).
Other acceptable characters for the separator are a hyphen (-), a period (.), or
a zero (0). Use the zero to indicate no separator.
The slash (/) appears if you attempt to use a character other than a hyphen,
period, or zero as a separator, or if you do not include a separator character
in the DBDATE definition.
DBDATE
The following table shows a few variations of setting the DBDATE

environment variable:
setenv DBDATE
October 8, 1994 appears as:
MDY4/
10/08/1994
DMY2-
08-10-94
MDY4
10/08/1994
Y2DM.
94.08.10
MDY20
100894
Y4MD*
1994/10/08
Notice that the formats Y4MD* (unacceptable separator defined) and MDY4 (no
separator defined) both display the default (slash) as a separator.
Important: Certain routines called by INFORMIX-ESQL/COBOL or

INFORMIX-ESQL/C can use the DBTIME variable, rather than DBDATE, to set
DATETIME formats to international specifications. See the discussion of the DBTIME
environment variable on page 4-34 and the INFORMIX-ESQL/C Programmers
Manual or the INFORMIX-ESQL/COBOL Programmers Manual for more
information.
If you are using NLS, the contents of a declared DBDATE variable take
precedence over the contents of the LC_TIME variable. However, the LC_TIME
setting takes precedence over the default DBDATE format. (An exception is
when the hardware does not support the standard date format or returns a
default format that is too complicated. In those instances, LC_TIME is
ignored, and the DBDATE format is used). See the discussion of the LC_TIME
environment variable on page 4-57 for more information.
4-22
DBDELIMITER
DBDELIMITER
The DBDELIMITER environment variable specifies the field delimiter used
by the dbexport utility and with the LOAD and UNLOAD statements.
setenv
DBDELIMITER
delimiter
'delimiter'
is the field delimiter for unloaded data files.
The delimiter can be any single character, except the characters in the following list:
Hexadecimal numbers (0 through 9, a through f, A through F)
NEWLINE or CTRL-J
The backslash symbol (\)
The vertical bar (|=ASCII 124) is the default. To change the field delimiter to
a plus (+), set the DBDELIMITER environment variable, as shown in the
following example:
setenv DBDELIMITER ' +'
DBEDIT
The DBEDIT environment variable lets you name the text editor you want to
use to work with SQL statements and command files in DB-Access. If DBEDIT
is set, the specified editor is called directly. If DBEDIT is not set, you are
prompted to specify an editor as the default for the rest of the session.
setenv
editor
DBEDIT
editor
is the name of the text editor you want to use.
DBLANG
For most systems, the default editor is vi. If you use another editor, be sure
that it creates flat ASCII files. Some word processors in document mode introduce printer control characters that can interfere with operation of your
Informix product.
To specify the EMACS text editor, set the DBEDIT environment variable by
entering the following command:
setenv DBEDIT emacs
DBLANG
The DBLANG environment variable specifies the subdirectory of
$INFORMIXDIR or the full pathname of the directory that contains the
compiled message files used by your application.
setenv
DBLANG
relative_path
full_path
relative_path
full_path
is the subdirectory of $INFORMIXDIR

the full pathname of the directory that contains the
compiled message files.
The default subdirectory is $INFORMIXDIR/msg and the compiled message

files have the suffix .iem. If you want to use a message directory other than
$INFORMIXDIR/msg, perform the following steps:
4-24
1.
Use the mkdir command to create the appropriate subdirectory in

$INFORMIXDIR.
2.
Set the owner and group of the subdirectory to informix and the
access permission for this directory to 755.
3.
Set the DBLANG environment variable to the new subdirectory,

specifying only the subdirectory name and not the full pathname.
4.
Copy the .iem files to the new message directory specified by

$INFORMIXDIR/$DBLANG. All files in the message directory should
have the owner and group informix and access permission 644.
DBMONEY
To use NLS, you can set DBLANG to indicate the subdirectory under
$INFORMIXDIR/msg in which the message files for each supported native
language reside. For example, set DBLANG for your product to use the
French message files by entering the following command:
setenv DBLANG french
The database server accesses the message files in subdirectories of

$INFORMIXDIR/msg in the following order:
1.
In $INFORMIXDIR/msg/$DBLANG, if DBLANG is set (only if a

relative_path was used with DBLANG).
2.
In $INFORMIXDIR/msg/$LANG, if LANG is set and DBLANG is not

set.
3.
In $INFORMIXDIR/msg, if neither DBLANG nor LANG is set.
See the discussion of the LANG environment variable on page 4-49 for
information on how to select a language environment for your product when
NLS functionality is enabled.
DBMONEY
The DBMONEY environment variable specifies the display format for money
values.
setenv
$
,
.
DBMONEY
'$'
front
back
is the default symbol that precedes the money value.

is an optional symbol (comma) that separates the integral from
the fractional part of the money value.
is the default symbol that separates the integral from the
fractional part of the money value.
DBNLS
back
front
represents the optional symbol that follows the money value. The
back symbol can be up to seven characters and can contain any
character except a comma or a period. If back contains a dollar
sign ($), you must enclose the whole string in single quotes (').
is the optional symbol that precedes the money value. The front
symbol can be up to seven characters and can contain any character except a comma or a period. If front contains a dollar sign
($), you must enclose the whole string in single quotes (').
If you use any character except an alphabetic character for front or back, you
must enclose the character in quotes.
The default setting for DBMONEY is where a dollar sign ($) precedes the
money value, a period (.) separates the integral from the fractional part of the
money value, and no back symbol appears. For example, 10050 is formatted
as $100.50.
Suppose you want to represent money values in DM (Deutsche Mark), which
uses the currency symbol DM and a comma. Set the DBMONEY environment
variable by entering the following command:
setenv DBMONEY DM,
Here, DM is the currency symbol preceding the money value, and a comma
separates the integral from the fractional part of the money value. As a result,
the amount 10050 is displayed as DM100,50.
The contents of a declared DBMONEY environment variable take precedence
over the contents of the LC_MONETARY variable that can be set for NLS.
However, the LC_MONETARY setting takes precedence over the default
DBMONEY format. See the discussion of LC_MONETARY on page 4-55.
DBNLS
Set the DBNLS environment variable to activate NLS functionality in your
Informix products. If DBNLS is not set, the settings for the other NLS
environment variables listed in this section do not take effect.
setenv
DBNLS
1
2
4-26
DBNLS
To enable NLS functionality in Version 6.0 or later products, set the DBNLS
environment variable to the value 1 by entering the following command:
setenv DBNLS 1
Important: A database created after DBNLS is set in an NLS database can be accessed
only by applications running in a correctly set environment.
If you want to use a pre-Version 6.0 Informix product with a Version 6.0 or
later database server, set DBNLS to 2. This allows, for example, existing
INFORMIX-4GL or pre-Version 6.0 INFORMIX-ESQL/C programs to access NLS
databases and obtain proper sorting and collation of character data types
from the database server. Setting DBNLS to 2 also allows Version 6.0 or later
NLS applications with different locales to access an NLS database.
The following table describes what happens if you create or access an NLS
database with Version 6.0 or later ESQL/C, ESQL/COBOL, or DB-Access:
If DBNLS Is Set to 1
If DBNLS Is Set to 2
If you create an NLS

database
The NLS database automatically inherits the locale of the

application.
If you access an NLS

database
The application locale

must match the desired
locale for the NLS database. If not, an error is
returned.
The locale of the application

and the database can differ. The
database server operates in the
locale of the database.
If needed, you can deactivate the DBNLS environment variable with either of
the following commands:
setenv DBNLS
unsetenv DBNLS
When using DB-Access, you can infer whether DBNLS is set through the
Session option of the DB-Access main menu. If DBNLS is set, the screen shows
NLS capabilities and attributes; if DBNLS is not set, no NLS capabilities are
listed. See Chapter 6 in the DB-Access User Manual for details.
DBPATH
DBPATH
Use DBPATH to identify the database servers that contain databases (if you
are using the INFORMIX-OnLine Dynamic Server), or the directories and/or
database servers that contain databases (if you are using INFORMIX-SE ). The
DBPATH environment variable also specifies a list of directories (in addition
to the current directory) in which DB-Access looks for command scripts (.sql
files).
The CONNECT, DATABASE, START DATABASE, and DROP DATABASE
statements use DBPATH to locate the database under two conditions:
If the location of a database is not explicitly stated
If the database cannot be located in the default server or, for

INFORMIX-SE, the default directory.
The CREATE DATABASE statement does not use DBPATH.

To add a new DBPATH entry to existing entries, see Modifying the Setting of
an Environment Variable on page 4-9.
:
setenv
DBPATH
/ full_pathname
// servername / full_pathname
// servername
full_pathname
servername
is a valid full pathname of a directory in which .sql files

are stored or in which INFORMIX-SE databases are
stored.
is the name of an INFORMIX-OnLine Dynamic Server or
INFORMIX-SE database server on which databases are
stored. You cannot reference database files with a
servername.
DBPATH can contain up to 16 entries. Each entry (pathname, or servername, or

servername and full pathname) must be less than 128 characters. In addition,
the maximum length of DBPATH depends on the hardware platform on
which you are setting DBPATH.
4-28
DBPATH
When you access a database using the CONNECT, DATABASE, START

DATABASE, or DROP DATABASE statement, the search for the database is
done first in the directory and/or database server specified in the statement.
If no database server is specified, the default database server as set in the
INFORMIXSERVER environment variable is used. For INFORMIX-SE, if no
directory is specified in the statement, the default directory is searched for the
database. (The default directory is the current working directory if the
database server is on the local computer or your login directory if the database server is on a remote computer.) If a directory is specified but is not a full
path, the directory is considered to be relative to the default directory.
If the database is not located during the initial search, and if DBPATH is set,
the database servers and/or directories in DBPATH are searched for the
indicated database. The entries to DBPATH are considered in order.
Using DBPATH with DB-Access

If you are using DB-Access and you use the Choose option of the SQL menu
without having already selected a database, you see a list of all the .sql files
in the directories listed in your DBPATH. Once you select a database, the
DBPATH is not used to find the .sql files: For INFORMIX-OnLine Dynamic
Server databases, only the .sql files in the current working directory are displayed; for INFORMIX-SE databases, the .sql files in the directory containing
the selected database are displayed.
Searching Local Directories

Use a pathname without a database server name to have the database server
search for databases or .sql scripts on your local computer. If you are using
DB-Access with INFORMIX-SE, you can search for a database and .sql scripts;
with the INFORMIX-OnLine Dynamic Server, you can look only for .sql
scripts.
In the following example, the DBPATH setting causes DB-Access to search for
the database files in your current directory and then in Joachims and Sonjas
directories on the local computer:
setenv DBPATH /usr/joachim:/usr/sonja
As shown in the previous example, if the pathname specifies a directory

name but not a database server name, the directory is sought on the computer
running the default database server as specified by the INFORMIXSERVER
DBPATH
environment variable. (See page 4-46.) For instance, with the previous
example, if INFORMIXSERVER is set to quality, the DBPATH value is
interpreted as shown in the following example, where the double slash
precedes the database server name:
setenv DBPATH //quality/usr/joachim://quality/usr/sonja
Searching Networked Computers for Databases

If you are using more than one database server, you can set DBPATH to
explicitly contain the database server and/or directory names that you want
to search for databases. For example, if INFORMIXSERVER is set to quality but
you also want to search the marketing database server for
/usr/joachim, set DBPATH as shown in the following example:
setenv DBPATH //marketing/usr/joachim:/usr/sonja
Specifying a Servername
You can set DBPATH to contain only database server names. This allows you
to locate only databases and not locate command files.
The OnLine or SE administrator must include each database server
mentioned by DBPATH in the $INFORMIXDIR/etc/sqlhosts file. For information on communication-configuration files and dbservernames, see the
INFORMIX-OnLine Dynamic Server Administrators Guide or the INFORMIX-SE
Administrators Guide.
For example, if INFORMIXSERVER is set to quality, you can search for an
INFORMIX-OnLine Dynamic Server database first on the quality database
server and then on the marketing database server by setting DBPATH shown
in the following example:
setenv DBPATH //marketing
If you are using DB-Access in this example, the names of all the databases on
the quality and marketing database servers are displayed with the Select
option of the Database menu.
4-30
DBPRINT
For INFORMIX-SE, you can set DBPATH to contain only the database server
names (and no directory names) if you want to locate databases and not
command scripts.
If you specify a local SE database server, the current working

directory is searched for databases.
If you specify a remote SE database server, the search for databases is

done in the login directory of the user on the computer where the
database server is running.
DBPRINT
The DBPRINT environment variable specifies the printing program that you
want to use.
setenv
program
DBPRINT
program
names any command, shell script, or UNIX utility that

handles standard ASCII input.
The default program is found in the following list:
For most BSD UNIX systems, the default program is lpr.
For UNIX System V, the default program is usually lp.
Set the DBPRINT environment variable to specify the myprint print program
by entering the following command:
setenv DBPRINT myprint
DBREMOTECMD
DBREMOTECMD
You can set the DBREMOTECMD environment variable to override the
default remote shell used when you perform remote tape operations with the
INFORMIX-OnLine Dynamic Server. Set it using either a simple command or
the full pathname. If you use the full pathname, the database server searches
your PATH for the specified command.
setenv
DBREMOTECMD
command
pathname
command
pathname
is the command to override the default remote shell.

is the pathname to override the default remote shell.
Informix highly recommends the use of the full pathname syntax on the
interactive UNIX platform to avoid problems with similar-named programs
in other directories and possible confusion with the restricted shell
(/usr/bin/rsh).
Set the DBREMOTECMD environment variable for a simple command name
setenv DBREMOTECMD rcmd
Set the DBREMOTECMD environment variable to specify the full pathname

setenv DBREMOTECMD /usr/bin/remsh
For more information on DBREMOTECMD, see the discussion in the

INFORMIX-OnLine Dynamic Server Archive and Backup Guide about using
remote tape devices with the INFORMIX-OnLine Dynamic Server for archives,
restores, and logical log backups.
4-32
DBSPACETEMP
DBSPACETEMP
If you are using OnLine, you can set your DBSPACETEMP environment
variable to specify dbspaces for building temporary tables and for holding
the temporary files used for sorting. You can specify multiple dbspaces to
spread temporary space across any number of disks.
punct
setenv
DBSPACETEMP
punct
temp_dbspace
temp_dbspace
can be either colons or commas.

is a valid existing temporary dbspace.
The DBSPACETEMP environment variable overrides the default dbspaces

specified by the DBSPACETEMP configuration parameter in the
INFORMIX-OnLine Dynamic Server configuration file. For example, you
might set DBSPACETEMP by entering the following command:
setenv DBSPACETEMP sorttmp1:sorttmp2:sorttmp3
Separate the dbspace entries with either colons or commas. The number of
dbspaces is limited by the maximum size of the environment variable, as
defined by the UNIX shell.
If you do not set the DBSPACETEMP environment variable, the default is the
root dbspace unless you create your temporary table with the CREATE TEMP
TABLE statement, in which case the default is the dbspace that contains the
database for the temporary table. If the dbspace named by the environment
variable not exist, OnLine uses the root dbspace. OnLine does not create a
new dbspace with the given name.
For sorting space, OnLine uses the following disk space for writing
temporary information, in the following order:
1.
The operating system directory or directories specified by the

environment variable PSORT_DBTEMP, if set
2.
The dbspace or dbspaces specified by the environment variable

DBSPACETEMP, if set
DBTEMP
3.
The dbspace or dbspaces specified by the ONCONFIG parameter

DBSPACETEMP
4.
The operating system file space in /tmp
DBTEMP
Set the DBTEMP environment variable to specify the full pathname of the
directory into which you want INFORMIX-SE or INFORMIX-Gateway
products to place its temporary files and temporary tables.
setenv
pathname
DBTEMP
pathname
is the full pathname of the directory for temporary files

and temporary tables.
Set the DBTEMP environment variable to specify the pathname

usr/magda/mytemp by entering the following command:
setenv DBTEMP usr/magda/mytemp
If you do not set DBTEMP, temporary files are created in /tmp. If DBTEMP is
not set, temporary tables are created in the directory of the database (that is,
the .dbs directory).
OnLine uses DBSPACETEMP to specify the location of temporary files.
DBTIME
You can set the DBTIME environment variable to manipulate DATETIME
formats so the formats conform more closely to various international or local
TIME conventions. DBTIME takes effect only when you call certain
INFORMIX-ESQL/C or INFORMIX-ESQL/COBOL DATETIME routines;
otherwise, use the DBDATE environment variable. (See the
INFORMIX-ESQL/C Programmers Manual or the INFORMIX-ESQL/COBOL
Programmers Manual for details.)
4-34
DBTIME
You can set DBTIME to specify the exact format of an input/output (I/O)
DATETIME string field by using the formatting directives described in the following list. Otherwise, the behavior of the DATETIME formatting routine is
undefined.
setenv
string
DBTIME
'string'
the formatting directives that you can use to create the formatting
are described in the following list:
%b
is replaced by the abbreviated month name.
%B
is replaced by the full month name.
%d
is replaced by the day of the month as a decimal number

[01,31].
%Fn
is replaced by the value of the fraction with precision specified by the integer n. The default value of n is 2; the range
of n is 0 n 5.
%H
is replaced by the hour (24-hour clock).
%I
is replaced by the hour (12-hour clock).
%M
is replaced by the minute as a decimal number [00,59].
%m
is replaced by the month as a decimal number [01,12].
%p
is replaced by A.M. or P.M. (or the equivalent in the local

standards).
%S
is replaced by the second as a decimal number [00,59].
%y
is replaced by the year as a 2-digit decimal number [00,99].

The format for this value is taken literally: 88 means
0088, not 1988.
%Y
is replaced by the year as a 4-digit decimal number.
%%
is replaced by % (to allow % in the format string).
DBTIME
For example, to convert a DATETIME year TO second to the ASCII string format
Mar 21, 1994 at 16 h 30 m 28 s
You set DBTIME as shown in the following list:

setenv DBTIME '%b %d, %Y at %H h %M m %S s'
The default DBTIME produces the conventional ANSI SQL string format
shown in the following line:
1994-03-21 16:30:28
is set as shown in the following example:

setenv DBTIME '%Y-%m-%d %H:%M:%S'
An optional field width and precision specification can immediately follow

the percent (%) character; it is interpreted as described in the following list:
[|0]w
where w is a decimal digit string specifying the minimum

field width. By default, the value is right justified with spaces
on the left.
If - is specified, it is left-justified with spaces on the right.
If 0 is specified, it is right-justified and padded with zeroes
on the left.
where p is a decimal digit string specifying the number of digits to
appear for d, H, I, m, M, S, y, and Y conversions, and the maximum
number of characters to be used for b and B conversions. A precision specification is significant only when converting a DATETIME
value to an ASCII string and not vice versa.
.p
When you use field width and precision specifications, the following
limitations apply:
4-36
If a conversion specification supplies fewer digits than specified by a

precision, it is padded with leading zeroes.
If a conversion specification supplies more characters than specified

by a precision, excess characters are truncated on the right.
If no field width or precision is specified for d, H, I, m, M, S, or y

conversions, a default of 0.2 is used. A default of 0.4 is used for Y
conversions.
DBUPSPACE
The F conversion does not follow the field width and precision format
conversions described earlier.
See the discussion of DBDATE and LC_TIME on pages 4-21 and 4-57,
respectively, for related information.
DBUPSPACE
The DBUPSPACE environment variable lets you specify and constrain the
amount of system disk space that the UPDATE STATISTICS statement can use
when trying to simultaneously construct multiple column distributions.
setenv
value
DBUPSPACE
value
represents a disk space amount in kilobytes
For example, to set DBUPSPACE to 2,500 kilobytes enter the following

command:
setenv DBUPSPACE 2500
Then no more than 2,500 kilobytes of disk space can be used during the
execution of an UPDATE STATISTICS statement. If a table requires 5 megabytes of disk space for sorting, then UPDATE STATISTICS accomplishes the
task in two passes; the distributions for one half of the columns are constructed with each pass.
If you try to set DBUPSPACE to any value less than 1,024 kilobytes, it is
automatically set to 1,024 kilobytes, but no error message is returned. If this
value is not large enough to allow more than one distribution to be constructed at a time, at least one distribution is done, even if the amount of disk
space required for the one is greater than specified in DBUPSPACE.
DELIMIDENT
DELIMIDENT
The DELIMIDENT environment variable specifies that strings set off by
double quotes are delimited identifiers.
setenv
DELIMIDENT
You can use delimited identifiers to specify identifiers that are identical to
reserved keywords, such as TABLE or USAGE. You can also use them to specify database identifiers that contain nonalpha characters, but you cannot use
them to specify storage identifiers that contain non-alpha characters. Note
that database identifiers are names for database objects such as tables and
columns, and storage identifiers are names for storage objects such as
dbspaces and blobspaces.
Delimited identifiers are case-sensitive.
To use delimited identifiers, applications in ESQL /C and ESQL /COBOL must
set the DELIMIDENT environment variable at compile time and execute time.
ENVIGNORE
Use the ENVIGNORE environment variable to deactivate specified
environment variable entries in the common (shared) and private
environment-configuration files, informix.rc and .informix respectively.
:
setenv
variable
4-38
ENVIGNORE
variable
is the list of environment variables that you want to deactivate.
FET_BUF_SIZE
For example, to ignore the DBPATH and DBMONEY entries in the

environment-configuration files, enter the following command:
setenv ENVIGNORE DBPATH:DBMONEY
The common environment-configuration file is stored in

$INFORMIXDIR/etc/informix.rc. The private environment-configuration file
is stored in the users home directory as .informix. See Where to Set
Environment Variables on page 4-6 for information on creating or
modifying an environment-configuration file.
ENVIGNORE cannot be set in an environment-configuration file.
FET_BUF_SIZE
The FET_BUF_SIZE environment variable lets you override the default setting
for the size of the fetch buffer for all data except blobs. When set,
FET_BUF_SIZE is effective for the entire environment.
setenv
FET_BUF_SIZE
represents the size of the buffer in bytes.
When set to a valid value, the environment variable overrides the previously
set value. The default setting for the fetch buffer is dependent on row size.
If the buffer size is set to less than the default size or is out of the range of the
small integer value, no error is raised. The new buffer size is ignored.
For example, to set a buffer size to 5,000, set the FET_BUF_SIZE environment
setenv FET_BUF_SIZE 5000
INFORMIXC
INFORMIXC
The INFORMIXC environment variable specifies the name or pathname of the
C compiler to be used to compile files generated by INFORMIX-ESQL/C. If
INFORMIXC is not set, the default compiler is cc.
setenv
compiler
INFORMIXC
pathname
compiler
pathname
is the name of the C compiler.

is the full pathname of the C compiler.
For example, to specify the GNU C compiler, enter the following command:
setenv INFORMIXC gcc
The setting is required only during the C compilation stage.
INFORMIXCOB
The INFORMIXCOB environment variable specifies the program name of the
COBOL compiler that you use with INFORMIX-ESQL/COBOL. It identifies the
command that calls up the compiler environment. You must set this environment variable before you compile your ESQL/COBOL program.
setenv
program
INFORMIXCOB
program
is the program name of the COBOL compiler.
The program name depends on the manufacturer of the COBOL compiler, as

shown in the following list:
4-40
Compiler manufacturer
Enter the command:
Micro Focus
setenv INFORMIXCOB cob
Ryan-McFarland (Liant)
setenv INFORMIXCOB rmcobol
INFORMIXCOBDIR
Your COBOL compiler might require you to set additional (UNIX)

environment variables as listed in the compiler documentation. See the
product manuals and the INFORMIX-ESQL/COBOL Programmers Manual for
compiler-specific information.
Refer to the INFORMIX-ESQL/COBOL Programmers Manual for more
information about INFORMIXCOB.
INFORMIXCOBDIR
The INFORMIXCOBDIR environment variable specifies the directory where
the COBOL compiler resides. You must set this environment variable before
you compile your INFORMIX-ESQL/COBOL program and create the run-time
product.
setenv
dirname
INFORMIXCOBDIR
dirname
is the full directory pathname of the directory where the

COBOL compiler, run-time library, and objects reside.

information about INFORMIXCOBDIR.
INFORMIXCOBSTORE
INFORMIXCOBSTORE
The INFORMIXCOBSTORE environment variable applies only to the Micro
Focus (MF) COBOL/2 environment. It specifies the type of storage to use during compilation. You must set INFORMIXCOBSTORE before you compile
your INFORMIX-ESQL/COBOL program and create the run-time product.
setenv
INFORMIXCOBSTORE
byte
word
byte
word
specifies byte storage.

specifies word storage.
The number of bytes needed to store BINARY or COMPUTATIONAL data is

based on the size (maximum number of digits) specified in the PICTURE
clause. The MF COBOL/2 compiler also considers whether byte or word storage is specified when determining the number of bytes needed to store
BINARY and COMPUTATIONAL data. (MF COBOL/2 uses only byte storage.)
If INFORMIXCOBSTORE is not set, the default storage mode is byte, which is
more restrictive of available data type choices. If you are using byte storage,
the only legal PIC sizes are 3, 4, 7, 8, and 9. If you are using word storage, PIC
sizes can range from 1 through 9.
For a table showing the storage allocation for MF compilers, see the
INFORMIX-ESQL/COBOL Programmers Manual.
4-42
INFORMIXCOBTYPE
INFORMIXCOBTYPE
The INFORMIXCOBTYPE environment variable specifies a code that
identifies the manufacturer of your COBOL compiler. You must set
INFORMIXCOBTYPE before you compile an INFORMIX-ESQL/COBOL
program and create the run-time product.
setenv
type
INFORMIXCOBTYPE
type
indicates the manufacturer of the COBOL compiler that

you use with ESQL/COBOL, as shown in the following list:
mf2
Micro Focus
rm85
Ryan-McFarland (Liant)

information about INFORMIXCOBTYPE.
INFORMIXCONRETRY
The INFORMIXCONRETRY environment variable specifies the maximum
number of additional connection attempts that should be made to each server
by the client during the time limit specified by the INFORMIXCONTIME
environment variable.
Set the INFORMIXCONRETRY environment variable as shown in the
following syntax:
setenv
value
INFORMIXCONRETRY
value
represents the number of connection attempts to each server.
INFORMIXCONTIME
For example, set INFORMIXCONRETRY to three additional connection

attempts (after the initial attempt) by entering the following command:
setenv INFORMIXCONRETRY 3
The default value for INFORMIXCONRETRY is one retry after the initial
connection attempt. The INFORMIXCONTIME setting, described in the
following section, takes precedence over the INFORMIXCONRETRY setting.
INFORMIXCONTIME
The INFORMIXCONTIME environment variable lets you specify that an SQL
CONNECT statement should keep trying for at least the given number of seconds before returning an error.
You might encounter connection difficulties related to system or network
load problems. For instance, if the database server is busy establishing new
SQL client threads, some clients might fail because the server cannot issue a
network function call fast enough. The INFORMIXCONTIME and
INFORMIXCONRETRY environment variables let you configure your clientside connection capability to retry the connection instead of returning an
error.
Set the INFORMIXCONTIME environment variable as shown in the following
syntax:
setenv
value
INFORMIXCONTIME
value
represents the minimum number of seconds spent in attempts

to establish a connection to a server.
For example, set INFORMIXCONTIME to 60 seconds by entering the

following command:
setenv INFORMIXCONTIME 60
4-44
INFORMIXCONTIME
If INFORMIXCONTIME is set to 60 and INFORMIXCONRETRY is set to 3, as

shown in these examples, attempts to connect to the server (after the initial
attempt at 0 seconds) will be made at 20, 40, and 60 seconds, if necessary,
before aborting. This 20-second interval is the result of INFORMIXCONTIME
divided by INFORMIXCONRETRY.
If execution of the CONNECT statement involves searching DBPATH, the
following rules apply:
All appropriate servers in the DBPATH setting are accessed at least

once, even though the INFORMIXCONTIME value might be
exceeded. Thus, the CONNECT statement might take longer than the
INFORMIXCONTIME time limit to return an error indicating
connection failure or that the database was not found.
The INFORMIXCONRETRY value specifies the number of additional

connections that should be attempted for each server entry in
DBPATH.
The INFORMIXCONTIME value is divided among the number of

server entries specified in DBPATH. Thus, if DBPATH contains
numerous servers, you should increase the INFORMIXCONTIME
value accordingly. For example, if DBPATH contains three entries, to
spend at least 30 seconds attempting each connection, set
INFORMIXCONTIME to 90.
The default value for INFORMIXCONTIME is 15 seconds. The INFORMIXCONTIME setting takes precedence over the INFORMIXCONRETRY setting;
retry efforts could end after the INFORMIXCONTIME value has been
exceeded, but before the INFORMIXCONRETRY value has been reached.
INFORMIXDIR
INFORMIXDIR
The INFORMIXDIR environment variable specifies the directory that
contains the subdirectories in which your product files are installed.
You must always set INFORMIXDIR. If you have multiple versions of the
INFORMIX-OnLine Dynamic Server or INFORMIX-SE database server, set
INFORMIXDIR to the appropriate directory name for the version that you
want to access. For information about when to set the INFORMIXDIR
environment variable, see the UNIX Products Installation Guide.
setenv
pathname
INFORMIXDIR
pathname
is the directory path where the product files are

installed.
Set the INFORMIXDIR environment variable to the desired installation

directory by entering the following command:
setenv INFORMIXDIR /usr/informix
INFORMIXSERVER
The INFORMIXSERVER environment variable specifies the default database
server to which an explicit or implicit connection is made by an SQL API client
or the DB-Access utility. The database server can be either INFORMIX-OnLine
Dynamic Server or INFORMIX-SE and can be either local or remote. You must
always set INFORMIXSERVER before using an Informix product.
setenv
dbservername
INFORMIXSERVER
dbservername
is the name of the default database server.
The value of INFORMIXSERVER must correspond to a valid dbservername

entry in the $INFORMIXDIR/etc/sqlhosts file on the computer running the
application. The dbservername must be specified using lowercase characters
4-46
INFORMIXSHMBASE
and cannot exceed 18 characters for the INFORMIX-OnLine Dynamic Server

and cannot exceed 10 characters for the INFORMIX-SE database server. For
example, specify the coral database server as the default for connection, by
setenv INFORMIXSERVER coral
INFORMIXSERVER specifies the database server to which an application
connects if the CONNECT DEFAULT statement is executed. It also defines the
database server to which an initial implicit connection is established if the

first statement in an application is not a CONNECT statement.
Important: INFORMIXSERVER must be set even if the application or DB-Access

does not use implicit or explicit default connections.
INFORMIXSHMBASE
The INFORMIXSHMBASE environment variable affects only client
applications connected to an INFORMIX-OnLine Dynamic Server using the
IPC shared-memory (ipcshm) communication protocol.
Important: Resetting INFORMIXSHMBASE requires a thorough understanding of

how the application uses memory. Normally you do not reset INFORMIXSHMBASE.
You use INFORMIXSHMBASE to specify where shared-memory
communication segments are attached to the client process so that client
applications can avoid collisions with other memory segments used by the
application. If you do not set INFORMIXSHMBASE, the memory address of
the communication segments defaults to an implementation-specific value
such as 0x800000.
value
setenv
INFORMIXSHMBASE
value
is used to calculate the memory address.
INFORMIXSTACKSIZE
The INFORMIX-OnLine Dynamic Server calculates the memory address

where segments are attached by multiplying the value of
INFORMIXSHMBASE by 1,024. For example, to set the memory address to the
value 0x800000, set the INFORMIXSHMBASE environment variable by
setenv INFORMIXSHMBASE 8192
For more information, see the INFORMIX-OnLine Dynamic Server

INFORMIXSTACKSIZE
INFORMIXSTACKSIZE specifies the stack size (in kilobytes) that OnLine uses
for a particular client session. Use INFORMIXSTACKSIZE to override the
value of the ONCONFIG parameter STACKSIZE for a particular application or
user.
setenv
value
INFORMIXSTACKSIZE
value
is the stack size for SQL client threads in kilobytes.
For example, decrease the INFORMIXSTACKSIZE to 20 kilobytes, by entering

the following command:
setenv INFORMIXSTACKSIZE 20
If INFORMIXSTACKSIZE is not set, the stack size is taken from the OnLine
configuration parameter STACKSIZE, or it defaults to a platform-specific
value. The default stack size value for the primary thread for an SQL client is
32 kilobytes for nonrecursive database activity.
Warning: See the INFORMIX-OnLine Dynamic Server Administrators Guide for

specific instructions for setting this value. If you incorrectly set the value of
INFORMIXSTACKSIZE, it can cause the INFORMIX-OnLine Dynamic Server to
crash.
4-48
INFORMIXTERM
INFORMIXTERM
The INFORMIXTERM environment variable specifies whether DB-Access
should use the information in the termcap file or the terminfo directory. The
termcap and terminfo files determine terminal-dependent keyboard and
screen capabilities such as the operation of function keys, color and intensity
attributes in screen displays, and the definition of window border and
graphics characters.
setenv
INFORMIXTERM
termcap
terminfo
If INFORMIXTERM is not set, the default setting is termcap. When DB-Access

is installed on your system, a termcap file is placed in the etc subdirectory of
$INFORMIXDIR. This file is a superset of an operating system termcap file.
You can use the termcap file supplied by Informix, the system termcap file,
or a termcap file that you create. You must set the TERMCAP environment
variable if you do not use the default termcap file.
The terminfo directory contains a file for each terminal name that has been
defined. The terminfo setting for INFORMIXTERM is supported only on computers that provide full support for the UNIX System V terminfo library. For
details, see the online Version 7.1 Machine Notes for your product.
LANG
Set the UNIX LANG environment variable to select the specific language
environment (or locale) for your Informix products. The LANG setting implies
certain default values for the language environment that you can modify or
override by setting various LC_* environment variables. The setting for the
LC_* environment variables always takes precedence over the LANG setting.
For example, if a LANG setting for French is specified in the shell and
LC_COLLATE is set for German in an environment-configuration file, the
LC_COLLATE setting takes precedence. If LANG is not set, the default value
LANG
is C. (Most UNIX systems include, as part of the basic operating system, a

locale whose name is C. This locale is used unless you explicitly change to
some other locale.)
setenv
language
LANG
_territory
.codeset
@modifier
_territory
language
.codeset
@modifier
modifies the default cultural convention settings

implied in the language setting. For instance, the default
International Standards Organization (ISO) code set
might be 8859/1, but a user might prefer to use the ISO
646 code set or the ISO 6937:1983 code set instead.
implied in the language setting. For example, you can set
@modifier to specify the dictionary or telephone-book
sorting order for a locale.
_territory to specify the Swiss version of the French,
German, or Italian language.
is the name representing the language and cultural
conventions for a specific locale, such as France,
Germany, or Italy. The locale specified implies default
settings for the _territory and .codeset.
Valid settings for the .codeset, language, @modifier, and _territory fields might
vary among operating systems. They are not standardized and thus might
not be supported by individual X/Open systems. Example settings in this
section use a particular implementation for consistency but do not imply a
specific naming convention.
The LANG information is transmitted with the request for database service
when the database connection is established. The database server uses the
information to set up the proper environment or to reject the service request
if a potential exists for data inconsistency when a database connection is
established with another database server.
4-50
LC_COLLATE
The setting for the LANG environment variable identifies the active language
and code set of the database application when the NLS functionality is
enabled. This value is used throughout the life of the database to ensure the
proper use of code sets.
Set the LANG environment variable to French by entering the following
command:
setenv LANG FR
You also can set the Informix environment variable DBLANG to indicate the
subdirectory under $INFORMIXDIR/msg in which the message files for each
supported native language reside. See the discussion of the DBLANG environment variable on page 4-24 for more information.
When using DB-Access, you can see the LANG setting and the mode (NLS or
non-NLS) through the Session option on the DB-Access main menu. See
Chapter 6 in the DB-Access User Manual for details.
LC_COLLATE
Set the LC_COLLATE environment variable to specify the collation sequence
for regular expressions and character string comparison operations and to
ensure the proper use of code sets.
setenv
LC_COLLATE
language
_territory
.codeset
@modifier
.codeset
@modifier

ISO code set might be 8859/1, whereas a user might
prefer to use the ISO 646 code set or the ISO 6937:1983
code set instead.
LC_COLLATE
_territory
language

conventions for a specific locale, such as France,
Germany, or Italy. The locale specified implies default
The database server saves the LC_COLLATE setting when you create a
database. The LC_COLLATE setting is used throughout the lifetime of the
database. If LC_COLLATE is not set, the default is the value set for the LANG
environment variable. If LANG is not set, the default value is C. If
LC_COLLATE is set, this value has the following consequences:
4-52
It affects the evaluation of regular expressions involving the NCHAR

and NVARCHAR native-character fields. For example, the comparison of the regular expression [A-P] uses country-specific values
instead of ASCII values. The range might thus include characters
outside of the A-P range.
It affects the use of the native-character fields NCHAR and

NVARCHAR in character-string handling, in the following ways:
Indexes built on NCHAR and NVARCHAR are sorted using a

country-specific comparison operator. For example, in Spanish,
the double character ll might be treated as a single unique
character.
Logical predicates containing the NCHAR and NVARCHAR

character fields in the WHERE clause of a SELECT statement are
evaluated using the comparison operator.
The character fields NCHAR and NVARCHAR in an ORDER BY

clause are evaluated by applying the comparison operator.
LC_CTYPE
For example, you can set the LC_COLLATE environment variable to specify
the dictionary order as implemented in the Swiss version (CH) of the German
language (DE) by entering the following command:
setenv LC_COLLATE DE_ch@dict
You can set the LC_COLLATE environment variable to specify the German
telephone-book sorting order by entering the following command:
setenv LC_COLLATE DE@telephone
When using DB-Access, you can see the LC_COLLATE setting and the mode
(NLS or non-NLS) for the application through the Session option of the
DB-Access main menu. In addition, the Nls option of the DATABASE INFO
menu shows the LC_COLLATE information stored in the active database. See
Chapters 4 and 6 in the DB-Access User Manual for details.
LC_CTYPE
Set the LC_CTYPE environment variable to specify various character
attributes such as the character classification and case conversion of regular
expressions and character-evaluation functions, and to ensure the proper use
of code sets. The LC_CTYPE setting determines character attributes such as
spaces, punctuation, uppercase letters, and so on.
setenv
LC_CTYPE
language
_territory
.codeset
@modifier
.codeset
@modifier

ISO code set might be 8859/1, whereas a user might
prefer to use the ISO 646 code set or the ISO 6937:1983
code set instead.
LC_CTYPE
_territory
language

conventions for a specific locale, such as France, Germany, or Italy. The locale specified implies default settings for the _territory and .codeset.
varyamong operating systems. They are not standardized and thus might not
be supported by individual X/Open systems. Example settings in this section
use a particular implementation for consistency but do not imply a specific
naming convention.
The database server saves the LC_CTYPE setting when you create the database. The LC_CTYPE setting is used throughout the lifetime of the database.
For example, set the LC_CTYPE environment variable to specify the Swiss cultural conventions and the ISO 6937:1983 code set by entering the following
command:
setenv LC_CTYPE FR_ch.6937
If LC_CTYPE is not set, the default is the value set for the LANG environment
variable. If LANG is not set, the default value is C.
When using DB-Access, you can see the LC_CTYPE setting and the mode
(NLS or non-NLS) through the Session option of the DB-Access main menu. In
addition, the Nls option on the DATABASE INFO menu shows the LC_CTYPE
information stored in the active database. See Chapters 4 and 6 in the
DB-Access User Manual for details.
4-54
LC_MONETARY
LC_MONETARY
The LC_MONETARY environment variable defines the rules and symbols
used to format monetary values. Use it to specify the format for the national
currency symbol, including its position within a numeric value, and the
money format.
setenv
LC_MONETARY
language
_territory
.codeset
@modifier
_territory
language
.codeset
@modifier

ISO code set might be 8859/1, whereas a user might prefer to use the ISO 646 code set or the ISO 6937:1983 code
set instead.
conventions for a specific locale, such as France, Germany, or Italy. The locale specified implies default
If LC_MONETARY is not set, the default is the value set for the LANG
environment variable. If LANG is not set, the default value is C.
LC_NUMERIC
Set LC_MONETARY to the language whose currency symbol and format you
want. For example, specify the French currency symbol and format inherent
in the ISO 8859/1 code set, by entering the following command:
setenv LC_MONETARY FR_Fr.88591
Specify the British currency symbol and format, by entering the following
command:
setenv LC_MONETARY EN_Uk.646
The currency symbol can be located in front of, after, or within the numeric
value. For example, in Germany, Switzerland, and France, respectively, the
monetary value 120.50 can be represented as shown in the following list:
120,50DM or DM120,50
Fr120,50 or sFr120.50
120,50FF or 120,50F
The contents of a declared DBMONEY variable take precedence over the

contents of the LC_MONETARY variable. However, LC_MONETARY takes
precedence over the default DBMONEY format. See the discussion of
DBMONEY on page 4-25.
LC_NUMERIC
Set the LC_NUMERIC environment variable to specify the default format and
decimal separator for numeric values. The LC_NUMERIC setting takes effect
only at the application level; it has no effect on the database server unless the
value passed to the database server is in a quoted string. In that case, the
conversion is based on the format set in LC_NUMERIC.
setenv
LC_NUMERIC
language
_territory
4-56
.codeset
@modifier
LC_TIME
The application must convert the numeric data specified in the local format
to the standard ANSI SQL format, where a period is the decimal separator.
For example, set the LC_NUMERIC environment variable to specify German
usage by entering the following command:
setenv LC_NUMERIC DE_De.88591
Here, DE means Deutsch, De represents Deutschland, and 88591 represents

the German variant of the 8-bit character set ISO 88591:1983.
If LC_NUMERIC is not set, the default is the value set for the LANG
environment variable. If LANG is not set, the default value is C.
LC_TIME
Set the LC_TIME environment variable to define the format for the national
date and time. This category includes the country-specific names and
abbreviations for the days of the week and for months.
setenv
LC_TIME
language
_territory
.codeset
@modifier
.codeset
@modifier

ISO code set might be 8859/1, whereas a user at a locale
might prefer to use the ISO 646 code set or the ISO
6937:1983 code set instead.
LC_TIME
_territory
language

conventions for a specific locale, such as France, Germany, or Italy. The locale specified implies default settings for the _territory and .codeset.
The LC_TIME setting takes effect at the application level. It also has an effect
on the database server: it affects the DBDATE environment variable setting
for date values (but not DATETIME or INTERVAL formats) that the database
server accepts. The application must convert the date and time specified in
the local format to the standard ANSI SQL format. In addition, the database
server accepts only the string representation of DATETIME and INTERVAL in
the standard ANSI SQL format.
For example, you might set the LC_TIME environment variable to specify
Italian usage by entering the following command:
setenv LC_TIME IT_It.88591
If LC_TIME is not set, the default is the value set for the LANG environment
variable. If LANG is not set, the default value is C.
The contents of a declared DBDATE variable take precedence over the
contents of the LC_TIME variable. However, LC_TIME takes precedence over
the default DBDATE format, except in those instances when the computer
does not support the standard date format, or returns a default format that is
too complicated. If the LC_TIME format (month, day, year, and separator) is
not compatible with or accepted by DBDATE, the default DBDATE format
is used. See the discussion of DBDATE on page 4-21.
4-58
ONCONFIG
ONCONFIG
The ONCONFIG environment variable specifies a file that holds
configuration parameters for INFORMIX-OnLine Dynamic Server. This
file is read as input during the initialization procedure.
filename
setenv
ONCONFIG
filename
is the name of a file in $INFORMIXDIR/etc that contains

the OnLine configuration parameters.
Prepare the ONCONFIG file by making a copy of the onconfig.std file and
modifying the copy. Informix recommends that you name the ONCONFIG
file so it can easily be related to a specific OnLine database server. If you have
multiple instances of OnLine, each instance must have its own uniquely
named ONCONFIG file.
If you do not set ONCONFIG, the default filename is onconfig.
For more information, see the INFORMIX-OnLine Dynamic Server
OPTCOMPIND
You can set the OPTCOMPIND environment variable to indicate the preferred
join method, thus assisting the optimizer in selecting the appropriate join
method. The OPTCOMPIND environment variable applies only to the
INFORMIX-OnLine Dynamic Server.
setenv
OPTCOMPIND
0
1
2
PATH
0
1
The default. It indicates that a nested-loop join is preferred, where

possible, over a sort-merge join or a hash join.
When the transaction isolation mode is not repeatable read, the
optimizer behaves as in setting (2); otherwise, the optimizer behaves
as in setting (0).
Nested-loop joins are not necessarily preferred. The optimizer bases
it decision purely on costs regardless of transaction isolation mode.
When the OPTCOMPIND environment variable is not set, OnLine uses the
value specified for the ONCONFIG configuration parameter OPTCOMPIND.
When neither the environment variable nor the configuration parameter is
set, the default value is 0 (zero).
For more information on the ONCONFIG configuration parameter
OPTCOMPIND, see the INFORMIX-OnLine Dynamic Server Administrators
Guide.
PATH
The UNIX PATH environment variable tells the shell which directories to
search for executable programs. You must add the directory that contains
your Informix product to your PATH environment variable before you can
use the product.
:
setenv
pathname
PATH
$PATH:
pathname
specifies the search path for the executables.
You can specify the correct search path in various ways. Be sure to include a
colon between the directory names.
For additional information about how to modify your path, see Modifying
the Setting of an Environment Variable on page 4-9.
4-60
PDQPRIORITY
PDQPRIORITY
The PDQPRIORITY environment variable determines the degree of
parallelism used by the INFORMIX-OnLine Dynamic Server. PDQPRIORITY
affects how OnLine allocates resources, including memory, processors, and
disk reads.
setenv
PDQPRIORITY
HIGH
LOW
OFF
percent-of-resources
HIGH
LOW
OFF
percent-ofresources
When OnLine allocates resources among all users, it gives

as many resources as possible to the query.
Data is fetched from fragmented tables in parallel, but no
other parallelism is used.
PDQ processing is turned off.
Represents an integer between 0 and 100. This number
indicates a query priority level. The higher the number, the
more resources OnLine uses.
Three values have special meaning, described in the
following list:
0 is equivalent to the symbolic value of OFF
1 is equivalent to the symbolic value of LOW
100 is equivalent to the symbolic value of HIGH
The PDQPRIORITY environment variable serves the same purpose as the

ONCONFIG configuration parameter PDQPRIORITY, but it supersedes the
configuration parameter. While the ONCONFIG configuration parameter
PDQPRIORITY controls the parallelism of all applications, the PDQPRIORITY
environment variable controls the parallelism of individual applications
independently.
PSORT_DBTEMP
Note that although usually the more resources OnLine uses, the better
the performance for a given query; using too many resources can cause
contention among the resources and also take away resources from other
queries, resulting in degraded performance.
Set the PDQPRIORITY environment variable to specify high priority by
setenv PDQPRIORITY HIGH
When the PDQPRIORITY environment variable is not set, OnLine uses the
value specified for the ONCONFIG configuration parameter PDQPRIORITY.
When neither the environment variable nor the configuration parameter is
set, the default value is OFF.
An application can override the setting of both the environment variable or
the configuration parameter when it issues the SQL statement
SET PDQPRIORITY, which is described in the Informix Guide to SQL: Syntax.
For more information on the ONCONFIG configuration parameter
PDQPRIORITY, see the INFORMIX-OnLine Dynamic Server Administrators
Guide.
PSORT_DBTEMP
The PSORT_DBTEMP environment variable specifies a directory or
directories where the INFORMIX-OnLine Dynamic Server writes the
temporary files it uses when performing a sort.
OnLine uses the directory specified by PSORT_DBTEMP even if the
environment variable PSORT_NPROCS is not set.
:
setenv
pathname
4-62
PSORT_DBTEMP
pathname
is the name of the UNIX directory used for intermediate

writes during a sort.
PSORT_NPROCS
Set the PSORT_DBTEMP environment variable to specify the directory (for

example, /usr/leif/tempsort) by entering the following command:
setenv PSORT_DBTEMP /usr/leif/tempsort
For maximum performance, specify directories that reside in file systems on

different disks.
You also might want to consider setting the environment variable
DBSPACETEMP to place temporary files used in sorting in dbspaces rather
than operating system files. See the discussion of the DBSPACETEMP
environment variable on page 4-33.
PSORT_NPROCS
The PSORT_NPROCS environment variable enables the INFORMIX-OnLine
Dynamic Server to improve the performance of the parallel-process sorting
package by allocating more threads for sorting.
setenv
threads
PSORT_NPROCS
threads
specifies the maximum number of threads to be used to sort a

query. The maximum value of threads is 10.
Use the following command to set the PSORT_NPROCS environment

variable to 4:
setenv PSORT_NPROCS 4
To maximize the effectiveness of the parallel sort, set PSORT_NPROCS to the

number of available processors in the hardware. If PSORT_NPROCS is not set
or set to zero, OnLine uses three threads.
You can disable parallel sorting by entering the following command:
unsetenv PSORT_NPROCS
For additional information about the PSORT_NPROCS environment variable,

see INFORMIX-OnLine Administrators Guide.
SQLEXEC
SQLEXEC
Important: This environment variable functions differently in Version 5.0 and
Version 6.0 and later Informix products. For details of Version 5.0 functionality,
refer to Chapter 4 of the December 1991 release of this manual.
The SQLEXEC environment variable specifies the location of the Version 6.0
or later relay module executable that allows a Version 5.0 or earlier client to
communicate with a local Version 6.0 or later INFORMIX-OnLine Dynamic
Server or INFORMIX-SE database server. You must, therefore, set SQLEXEC
only if you want to establish communication between a Version 5.0 or earlier
client and a Version 6.0 or later database server.
setenv
pathname
SQLEXEC
pathname
specifies the pathname for the relay module.
Set SQLEXEC to specify the full pathname of the relay module, which is in the
lib subdirectory of your $INFORMIXDIR directory by entering the following
command:
setenv SQLEXEC $INFORMIXDIR/lib/sqlrm
If you set the SQLEXEC environment variable on the C shell command line,
you must include curly braces around the existing INFORMIXDIR, as shown
in the following command:
setenv SQLEXEC ${INFORMIXDIR}/lib/sqlrm
For information on the relay module, see the INFORMIX-OnLine Dynamic

Server Administrators Guide or the INFORMIX-SE Administrators Guide.
4-64
SQLRM
SQLRM
Version 6.0 or later Informix products. For details of Version 5.0 functionality, refer
to Chapter 4 of the December 1991 release of this manual.
In Version 6.0 and later, if the system administrator is configuring a client/
server environment in which a Version 5.0 SQL API client accesses a local
Version 6.0 or later database server, the SQLRM environment variable must
be unset before SQLEXEC can be used to spawn a Version 6.0 or later relay
module.
You can unset SQLRM by entering the following command:
unsetenv SQLRM
For information on the relay module, see the INFORMIX-OnLine Dynamic

Server Administrators Guide or the INFORMIX-SE Administrators Guide.
SQLRMDIR
Version 6.0 and later Informix products. For details of Version 5.0 functionality,
refer to Chapter 4 of the December 1991 release of this manual.
In Version 6.0 and later, if the database administrator is configuring a client/
server environment in which a Version 5.0 SQL API client accesses a local
Version 6.0 or later database server, the SQLRM environment variable must
be unset.
Unset SQLRMDIR by entering the following command:
unsetenv SQLRMDIR
TERM
TERM
The UNIX TERM environment variable is used for terminal handling. It
enables DB-Access to recognize and communicate with the terminal you are
using.
setenv
type
TERM
type
specifies the terminal type.
The terminal type specified in the TERM setting must correspond to an entry
in the termcap file or terminfo directory. Before you can set the TERM environment variable, you must obtain the code for your terminal from the
INFORMIX-OnLine Dynamic Server or INFORMIX-SE administrator.
For example, to specify the vt100 terminal, set the TERM environment
setenv TERM vt100
TERMCAP
The TERMCAP environment variable is used for terminal handling. It tells
DB-Access to communicate with the termcap file instead of the terminfo
directory.
setenv
pathname
TERMCAP
pathname
specifies the location of the termcap file.
The termcap file contains a list of various types of terminals and their characteristics. Set TERMCAP by entering the following command:
setenv TERMCAP /usr/informix/etc/termcap
4-66
TERMINFO
If you set the TERMCAP environment variable, be sure that the

INFORMIXTERM environment variable is set to the default, termcap.
TERMINFO
The TERMINFO environment variable is used for terminal handling. It is
supported only on platforms that provide full support for the terminfo
libraries provided by System V and Solaris UNIX systems.
setenv
TERMINFO
/usr/lib/terminfo
TERMINFO tells DB-Access to communicate with the terminfo directory

instead of the termcap file. The terminfo directory has subdirectories that
contain files pertaining to terminals and their characteristics.
Set TERMINFO by entering the following command:

setenv TERMINFO /usr/lib/terminfo
If you set the TERMINFO environment variable, you must also set the
INFORMIXTERM environment variable to terminfo.
Index of Environment Variables

The table in Figure 4-3 provides an overview or cross-reference of the uses for
the various Informix, NLS, and UNIX environment variables supported in
Version 7.1. It serves as an index to general topics, the related environment
variables, and the page where the environment variable is introduced.
Figure 4-3
Environment variables used with Informix products
Topic
Page
ANSI compliance
DBANSIWARN
4-18
BLOB buffer
DBBLOBBUF
4-20
C compiler
INFORMIXC
4-40
Client/server
INFORMIXSERVER
4-46
INFORMIXSHMBASE
4-47
INFORMIXSTACKSIZE
4-48
SQLEXEC
4-64
SQLRM
4-65
SQLRMDIR
4-65
INFORMIXCOB
4-40
INFORMIXCOBDIR
4-41
INFORMIXCOBSTORE
4-42
INFORMIXCOBTYPE
4-43
COLLCHAR
4-16
LC_COLLATE
4-51
COBOL compiler
Collation (NLS)
(1 of 7)
4-68
Topic
Page
Compiler
INFORMIXC
4-40
INFORMIXCOB
4-40
INFORMIXCOBDIR
4-41
INFORMIXCOBSTORE
4-42
INFORMIXCOBTYPE
4-43
Configuration file: ON-Archive
ARC_DEFAULT
4-15
Configuration file: tctermcap
ARC_KEYPAD
4-15
Configuration file: OnLine
ONCONFIG
4-59
Configuration file: ignore variables
ENVIGNORE
4-38
Connecting
INFORMIXCONRETRY
4-43
INFORMIXCONTIME
4-44
INFORMIXSERVER
4-46
SQLEXEC
4-64
SQLRM
4-65
SQLRMDIR
4-65
Data distributions
DBUPSPACE
4-37
Date and time values
DBDATE
4-21
DBTIME
4-34
LC_TIME
4-57
Delimited Identifiers
DELIMIDENT
4-38
Disk space
DBUPSPACE
4-37
Editor
DBEDIT
4-23
Executable programs
PATH
4-60
Fetch buffer size
FET_BUF_SIZE
4-39
Database server
(2 of 7)
Topic
Page
Files: field delimiter
DBDELIMITER
4-23
Files: installation
INFORMIXDIR
4-46
Files: mapping
COLLCHAR
4-16
DBAPICODE
4-19
DBLANG
4-24
LANG
4-49
Files: temporary (OnLine)
DBSPACETEMP
4-33
Files: temporary (SE)
DBTEMP
4-34
Files: temporary sorting
PSORT_DBTEMP
4-62
Files: termcap, terminfo
INFORMIXTERM
4-49
TERM
4-66
TERMCAP
4-66
TERMINFO
4-67
Installation
INFORMIXDIR
4-46
Language environment
DBLANG
4-24
LANG
4-49
DBLANG
4-24
LANG
4-49
DBMONEY
4-25
LC_MONETARY
4-55
NLS: activating
DBNLS
4-26
NLS: character attributes
LC_CTYPE
4-53
NLS: code sets
DBAPICODE
4-19
Files: message
Message files
Money values
(3 of 7)
4-70
Topic
Page
NLS: collation
COLLCHAR
4-16
LC_COLLATE
4-51
NLS: date and time
LC_TIME
4-57
NLS: environment variables
LC_COLLATE
4-51
LC_CTYPE
4-53
LC_MONETARY
4-55
LC_NUMERIC
4-56
LC_TIME
4-57
NLS: language, locale
LANG
4-49
NLS: money values
LC_MONETARY
4-55
Numeric values
LC_NUMERIC
4-56
OnLine: archiving
ARC_DEFAULT
4-15
ARC_KEYPAD
4-15
DBREMOTECMD
4-32
OnLine: configuration parameters
ONCONFIG
4-59
OnLine: parallel sorting
PSORT_DBTEMP
4-62
PSORT_NPROCS
4-63
OnLine: shared memory
INFORMIXSHMBASE
4-47
OnLine: stacksize
INFORMIXSTACKSIZE
4-48
OnLine: tape management
ARC_DEFAULT
4-15
ARC_KEYPAD
4-15
DBREMOTECMD
4-32
OnLine: temporary tables, sort files
DBSPACETEMP
4-33
Pathname: for C compiler
INFORMIXC
4-40
(4 of 7)
Topic
Page
Pathname: for COBOL run times
INFORMIXCOBDIR
4-41
Pathname: for database files
DBPATH
4-28
Pathname: for executable programs
PATH
4-60
Pathname: for installation
INFORMIXDIR
4-46
Pathname: for message files
DBLANG
4-24
Pathname: for parallel sorting
PSORT_DBTEMP
4-62
Pathname: for relay module
SQLEXEC
4-64
Pathname: for remote shell
DBREMOTECMD
4-32
Pathname: for temporary files (SE)
DBTEMP
4-34
Printing
DBPRINT
4-31
Program: COBOL compiler
INFORMIXCOB
4-40
Program: printing
DBPRINT
4-31
Relay module
SQLEXEC
4-64
SQLRM
4-65
SQLRMDIR
4-65
Remote shell
DBREMOTECMD
4-32
Routine: DATETIME formatting
DBTIME
4-34
SE: temporary files
DBTEMP
4-34
Server
See Database server.
Shared memory
INFORMIXSHMBASE
4-47
Shell: remote
DBREMOTECMD
4-32
Shell: search path
PATH
4-60
Sorting
PSORT_DBTEMP
4-62
PSORT_NPROCS
4-63
(5 of 7)
Topic
Page
DBSPACETEMP
4-33
SQL statement: CONNECT
INFORMIXSERVER
4-46
SQL statement: editing
DBEDIT
4-23
SQL statement: LOAD, UNLOAD
DBDELIMITER
4-23
SQL statement: UPDATE STATISTICS
DBUPSPACE
4-37
Stacksize
INFORMIXSTACKSIZE
4-48
Tables: temporary (OnLine)
DBSPACETEMP
4-33
Temporary files
DBTEMP
4-34
PSORT_DBTEMP
4-62
Temporary tables
DBSPACETEMP
4-33
Terminal handling
INFORMIXTERM
4-49
TERM
4-66
TERMCAP
4-66
TERMINFO
4-67
DBDELIMITER
4-23
DBEDIT
4-23
INFORMIXTERM
4-49
Utilities: dbexport
DBDELIMITER
4-23
Utilities: ON-Archive
ARC_DEFAULT
4-15
ARC_KEYPAD
4-15
DBREMOTECMD
4-32
DBDATE
4-21
DBTIME
4-34
LC_TIME
4-57
Utilities: dbaccess
Values: date and time
(6 of 7)
Topic
Page
Values: money
DBMONEY
4-25
LC_MONETARY
4-55
Values: numeric
LC_NUMERIC
4-56
Variables: overriding
ENVIGNORE
4-38
(7 of 7)
4-74
Chapter
SQL Utilities
The chkenv Utility .
5
.
5-4
The crtcmap Utility . . . . . . .

Creating Mapping Files for NLS .
Mapping-File Formats . . .
Error Messages and Warnings
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
5-5
5-5
5-7
5-8
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
5-9
5-10
5-12
5-13
5-14
The dbexport Utility . . . . . . . . .

Unloading a Database and Its Schema File
Destination Options . . . . . . .
The Contents of the Schema File . .
Using dbexport with NLS . . . . . .
The dbimport Utility . . . . . . . . . . . . . . .

Building a Database from ASCII Files Created by dbexport
Database Logging Mode . . . . . . . . . . .
Input File Location Options . . . . . . . . . .
Create Options . . . . . . . . . . . . . .
Changing the Database Name. . . . . . . . . . .
Using dbimport with NLS . . . . . . . . . . . .
Changing a non-NLS Database to an NLS Database . .
Changing the Locale of an NLA Database . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
5-15
5-16
5-17
5-18
5-20
5-21
5-22
5-22
5-23
The dbload Utility . . . . . . . . . . . . . . . .

Loading Data from a Command File into a Table . . . .
Command-File Syntax Check . . . . . . . . .
Load Start Point . . . . . . . . . . . . . .
Batch Size . . . . . . . . . . . . . . . .
Bad-Row Limits . . . . . . . . . . . . . .
Creating a dbload Command File . . . . . . . . .
FILE and INSERT Statements: Delimiter Form. . . .
FILE and INSERT Statements: Character-Position Form
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
5-23
5-25
5-27
5-27
5-28
5-28
5-29
5-30
5-35
The dbschema Utility . . . . . . . . . . . . .

Creating the Schema for a Database . . . . . . .
Creating Schemas for Databases Across a Network
Owner Naming with dbschema . . . . . . .
Obtaining the Synonym Schema . . . . . .
Obtaining the Privilege Schema . . . . . . .
Specifying a Table, View, or Procedure . . . .
Using the -ss Option to Obtain Table Information.
Displaying the Distribution Information for Tables .
Example Output . . . . . . . . . . . .
Distribution Description . . . . . . . . .
The Distribution Information. . . . . . . .
The Overflow Information. . . . . . . . .
5-2
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
5-40
5-42
5-43
5-43
5-44
5-44
5-46
5-47
5-47
5-48
5-49
5-49
5-50
his chapter contains the syntax and usage of the following utilities
which can be used with INFORMIX-OnLine Dynamic Server and
INFORMIX-SE:
The chkenv utility checks the validity of common or private

environment-configuration files.
The crtcmap utility creates mapping files between nonstandard and

standard code sets for use with NLS.
The dbexport utility unloads a database into ASCII files for later
import into another database environment.
The dbimport utility creates and populates a database from ASCII

files.
The dbload utility loads ASCII data into databases or tables created
with Informix products.
The dbschema utility creates a file containing the SQL statements

necessary to replicate a specified table, view, or database. It also
shows the distributions created by UPDATE STATISTICS.
Before you use any of these utilities, you must set your PATH, INFORMIXDIR,
and INFORMIXSERVER environment variables.
Tip: If you are using INFORMIX-SE, Informix recommends that you not use the
.dbs directory as your current directory when using a database-related utility. This
keeps the .dbs directory free from file clutter and prevents multiple users from
overwriting files that belong to other users.
For information about system administration utilities, see the
INFORMIX-OnLine Dynamic Server Administrators Guide or the INFORMIX-SE
SQL Utilities
5-3
The chkenv Utility
The chkenv Utility

The chkenv utility checks the validity of common (shared) or private
environment-configuration files. Use it to provide debugging information
when you define, in an environment-configuration file, all the environment
variables that are used by your Informix products.
chkenv
filename
filename
specifies the name of the environment-configuration

file that you want to debug.
The common environment-configuration file is stored in

$INFORMIXDIR/etc/informix.rc. A private environment-configuration file is
stored in the users home directory as .informix.
Issue the following command to perform a sanity check on the contents of the
shared environment-configuration file:
chkenv informix.rc
The chkenv utility returns an error message if a bad environment variable

entry is in the file or if the file is too large. You can modify the file and rerun
the utility to check the modified environment variable settings.
If the chkenv utility returns the following error,
-33500
filename: Bad environment variable on line number.
Informix products ignore all lines in the environment-configuration file,

starting at the point of the error.
You can also set the ENVIGNORE environment variable if you want the
product to ignore specified environment variable settings in the file.
For a discussion of the use and format of environment-configuration files and
the ENVIGNORE environment variable, see Chapter 4, Environment
Variables.
5-4
The crtcmap Utility
The crtcmap Utility

The crtcmap utility helps create mapping files between nonstandard and
standard code sets for use with NLS. The mapping of character code sets to a
standard form lets SQL APIs on different platforms, including distributed
queries, access and share data by using a common character set representation of data in the database. You probably need this utility only if you use
non-ISO-standard character code sets or NLS functionality.
When you set the DBAPICODE environment variable, you can specify the
output files you create with the crtcmap utility. Your SQL APIs then communicate with the database server using the standard ASCII code set but interface with the keyboard, terminal display, and program character strings
using the code set in the file specified in DBAPICODE, which was created
with the crtcmap utility.
Creating Mapping Files for NLS

crtcmap
input_file
output_file
input_file
output_file
specifies the name of the text file, in ASCII or the

equivalent, where nonstandard characters are mapped
to standard characters. Both the mapped and target
character sets are represented in the file by hexadecimal
values.
specifies the name of the binary file where the output
from the file mapping is stored. The crtcmap utility
automatically prepends m (for mapping) to the name
of the Informix output file.
The crtcmap utility reads the text file specified in input_file and produces a
binary output_file of mapped values for a code set. You must put the
output_file in the correct $INFORMIXDIR/msg directory, as specified by the
setting of the LANG or the DBLANG environment variable. See MappingFile Formats on page 5-7 for information on creating an input_file.
SQL Utilities
5-5
The following sample command specifies the fr_FR646.src input_file and the
fr_FR646 output_file:
crtcmap fr_FR646.src fr_FR646
The crtcmap utility names the resulting binary output file mfr_FR646. The
file name indicates the ISO 646 code set for the French language as used in
France.
After you create and correctly place your output files in a message directory,
you can set the DBAPICODE environment variable to specify the name of the
mapping file you want to use to work with SQL or to access a database when
NLS has been enabled in your Version 6.0 Informix product. To specify the
mapping file created in the preceding command example, you set
DBAPICODE as shown in the following example:
setenv DBAPICODE mfr_FR.646
Change the DBAPICODE setting as needed to refer to the different mapping

file that you created with crtcmap.
The DBAPICODE, LANG, and DBLANG environment variables are discussed
in Chapter 4, Environment Variables.
Important: Code sets, valid NLS environment variable settings, and NLS functionality might differ from system to system. You should use any existing standard
naming conventions for your system whenever possible. Examples shown in this
discussion are intended as guidelines but do not imply specific naming or mapping
conventions. Therefore, examples of settings and files might not be supported by
individual systems or hardware.
5-6

Mapping-File Formats
The text file for the character-mapping table can consist of any number of
lines. A line can be a comment or a one-to-one map of a nonstandard
character code to the equivalent character in the target code set.
A comment line starts with the # symbol and ends with a new-line
character.
A one-to-one map has the format (hex_value, hex_value) where

hex_value is the hexadecimal representation of a character code.
The hex_value begins with 0x and is limited to a single byte. The first
hex_value in a line represents the nonstandard character code; the
second represents the desired code set that is eventually stored in the
database.
The input text file should be written in ASCII or a code set that has the equivalent representation of ASCII for the significant characters and the new-line
character. Significant characters include #, (, ), x, a, b, c, d, e, f, A, B, C, D, E, F,
the comma, and numeric characters.
The following two examples of input files cause errors due to inconsistency
and ambiguity. In the first example, the character represented by 0x21 is
mapped to both target characters 0x12 and 0x13:
# Example input file 1
# (produces an error)
#
(0x20,0x30)
(0x21,0x12)
(0x21,0x13)
...
In the second example, the two characters represented by 0x21 and 0x22 are
mapped to the same target character, 0x12:
# (produces a warning)
#
(0x20,0x30)
(0x21,0x12)
(0x22,0x12)
...
SQL Utilities
5-7
The following sample input file shows an example of correct one-to-one mapping. Each character value is mapped to a different target character:
# (correctly indicates one-to-one mapping)
#
(0x20,0x30)
(0x21,0x12)
(0x33,0x18)
...
Error Messages and Warnings

When more than one character is mapped to the same target character,
reverse mapping selects an arbitrary code for that set of characters. The
results might still be inconsistent, and you are warned of duplication.
Incorrect mapping might result in duplication and ambiguity. After a
database statement is executed and the results are returned, it warns you of
potential unexpected behavior.
When an error message or warning appears, the crtcmap utility returns messages such as the following examples to standard output:
Error: Cannot create mapping file 'name'
Error: Syntax error on line number
Warning: Duplicate mapping entry on line number
Error messages are also returned to the message file.
5-8
The dbexport Utility
The dbexport Utility

The dbexport utility unloads a database into ASCII files. The dbexport utility
also creates an ASCII schema file which can be used by dbimport to re-create
the database schema in another Informix environment. You can edit the
schema file to modify the database created by dbimport.
The dbexport utility supports the following three destination options:
Unloading a database and its schema file to disk
Unloading a database and its schema file to tape
Unloading the schema file to disk, where it can be examined and

modified, and unloading the data files to tape
You must have DBA privilege or log in as user informix to export a database.
When the NLS environment variables are set correctly, as described in
Chapter 4, Environment Variables, dbexport can handle foreign characters
in data and export the data from NLS databases. Refer to Using dbexport
with NLS on page 5-14.
You can use delimited identifiers with the dbexport utility. The utility detects
database objects that are keywords, mixed case, or have special characters
and places double quotes around them.
SQL Utilities
5-9
database
dbexport
-c
OL
-d
-q
Destination
Options p. 5-12
-ss
-X
-V
-c
-d
database
-q
5-10
makes dbexport complete exporting unless a fatal error

occurs.
makes dbexport export blob descriptors only, not blob
data. (Refer to the INFORMIX-OnLine/Optical User
Manual.)
specifies the name of the database you want to export.
If you want to use more than the simple name of the
database, refer to the Database Name segment in
suppresses the display (to the standard output) of error
messages, warnings, and generated SQL data-definition
statements.
-ss
-X
-V
generates database server-specific information for all

tables in the specified database. For INFORMIX-OnLine
Dynamic Server databases, the -ss option specifies initial and next extent sizes, fragmentation information if
the table is fragmented, the locking mode, the dbspace
for a table, and the blobspace for any blobs. For
INFORMIX-SE databases, the -ss option generates the
pathname where each table was created if the table is in
a path other than the database directory.
recognizes HEX binary data in character fields.
displays product version information.
In addition to the data files and the schema file, dbexport creates a file of
messages in the current directory called dbexport.out. This file contains any
error messages and warnings as well as a display of the SQL data definition
statements it generates. The same material is also written to the standard output unless you specify the -q option.
During the export, the database is locked in exclusive mode. If an exclusive
lock cannot be obtained, the program ends and displays a diagnostic
message.
You can cancel dbexport at any time by pressing the Interrupt key. The
dbexport utility asks for confirmation before terminating.
SQL Utilities
5-11

Destination Options
Destination
Options
-o directory name
-t device -b blocksize -s tapesize
-f pathname
-b blocksize
-f pathname
-o directory name
-s tapesize
-t device
specifies, in kilobytes, the block size of the tape device.

specifies the pathname on disk where you want the
schema file stored, if you are storing the data files on
tape. The -f pathname can be an complete pathname or
simply a file name. If only a file name is given, the file is
stored in the currentdirectory.
names the directory on disk where you want both the
data files and the schema file stored. The directory
specified as directory name must already exist.
specifies, in kilobytes, the amount of data that can be
stored on the tape. The tape size is limited to 2,097,151
kilobytes. The limit is required because of the way
dbexport and dbimport track their positions into the
tape.
names the pathname of the tape device where you want
the ASCII data files and, possibly, the schema file
stored. The -t option does not allow you to specify a
remote tape device.
When you write to disk, dbexport creates a subdirectory, database.exp, in the

directory specified by the -o option. The dbexport utility creates a file,
tablename.unl, for each table in the database. The schema file is written to the
file database.sql. The .unl and .sql files are stored in the database.exp directory.
If you do not specify a destination for the data and schema files, the subdirectory database.exp is placed in the current working directory.
5-12
When you write the data files to tape, you can use the -f option to store the
schema file to disk. You are not required to name the schema file database.sql.
You can give it any name.
The following command creates a reports.exp subdirectory in the current
directory. It then unloads the reports database in the turku directory on the
SE database server called finland and places the resulting files in the
reports.exp directory.
dbexport //finland/turku/reports
The following command exports the OnLine database stores7 to tape with a
block size of 16 kilobytes and a tape capacity of 24,000 kilobytes. The schema
file is written to /tmp/stores7.imp.
dbexport -t /dev/rmt0 -b 16 -s 24000 -f /tmp/stores7.imp
stores7
The following command exports the same stores7 database to the directory
named /work/exports/stores7.exp. The resulting schema file is
/work/exports/stores7.exp/stores7.sql.
dbexport -o /work/exports stores7
The Contents of the Schema File

The schema file contains the SQL statements needed to re-create the exported
database. You can edit the schema file to add or modify information.
Important: Do not put comments into the schema file. Comments cause unpredictable results when read by the dbimport utility.
If you use the -ss option, the schema file contains all the server-specific
information used to create the database and tables, such as initial and next
extent sizes, fragmentation information if the table is fragmented, lock mode,
the dbspace where each table resides, and the blobspace where each blob
column resides. The following information is not retained:
Logging mode of the database (see Database Logging Mode on

page 5-17)
The starting value of a SERIAL column
SQL Utilities
5-13
Using dbexport with NLS
The statements in the schema file that create tables, views, and indexes and
grant privileges do so using the name of the user who originally created the
database. In this way, the original owner retains the DBA privileges for the
database and is the owner of all the tables, indexes, and views. In addition,
whoever executes the dbimport command also has the DBA privileges for the
database.
Using dbexport with NLS

You can use dbexport to unload ASCII data from a non-NLS database, set NLS
environment variables, and then use dbimport to turn it into an NLS database. You also can use dbexport and then dbimport to change the locale of an
NLS database. See the discussion of using dbimport with an NLS database on
Using dbimport with NLS on page 5-22.
When you run dbexport on an NLS database, you must set the DBNLS and
LANG environment variables to match the settings of the database. Use one
of the following methods:
You can check the current LC_COLLATE and LC_CTYPE settings,

which represent the locale and take precedence over the LANG setting, by issuing the following statement on the INFORMIX-OnLine
Dynamic Server:
SELECT tabname, site FROM systables WHERE tabid IN (90,91)
You can also check the LC_COLLATE and LC_CTYPE settings by

choosing the Nls option from the DATABASE INFO menu in
DB-Access.
You can use the SMI database to check the NLS status of all databases
on your server with the following command:
SELECT name, is_nls FROM sysmaster:sysdatabases
For information about the SMI database refer to the INFORMIX-OnLine

Dynamic Server Administrators Guide.
5-14
The dbimport Utility
The dbimport Utility

The dbimport utility creates a database and loads it with data from ASCII
input files. The input files consist of a schema file that is used to re-create the
database and data files that contain the database data. Normally, you generate the input files with the dbexport utility, but you can use any properly
formatted input files.
The dbimport utility can use files from the following location options:
All input files are located on disk.
All input files are located on tape.
The schema file is located on disk and the data files are located on
tape.
Important: Do not put comments into your input file. Comments cause
unpredictable results when read by the dbimport utility.
The dbimport utility supports the following options for the new database:
For INFORMIX-OnLine Dynamic Server:
Create an ANSI-compliant database (includes unbuffered logging).
Establish transaction logging for a database (unbuffered or buffered

logging).
Specify the dbspace where the database will reside.
For INFORMIX-SE:
Create an ANSI-compliant database (ANSI-compliant logging).
Establish transaction logging for a database (unbuffered logging).
The user who runs dbimport is granted the DBA privilege on the newly
created database. The dbimport process locks each table as it is being loaded
and unlocks the table when the loading is completed.
Chapter 4, Environment Variables, dbimport can import the data into NLS
databases.
SQL Utilities
5-15
You can use delimited identifiers with the dbimport utility. The utility detects
Input File
Location
p. 5-18
dbimport
Create
Options
p. 5-20
database
-c
-q
-X
-V
-c
instructs dbimport to complete importing even though

it encounters certain non-fatal errors.
specifies the name of the database you intend to create.
If you want to use more than the simple name of the
database, refer to the Database Name segment in
suppresses display (to the standard output) of error
messages and warnings.
database
-q
-X
-V
If you specify -c, dbimport ignores the following errors:
5-16
A data row that contains too many columns
Inability to put a lock on a table
Inability to release a lock
Even if you use the -c option, dbimport interrupts processing if one of the
following fatal errors occurs:
Unable to open the tape device specified
Bad writes to the tape or disk
Invalid command parameters
Cannot open database or no system permission
The dbimport utility creates a file of messages called dbimport.out in the

current directory. This file contains any error messages and warnings related
to dbimport processing. The same material is also written to the standard
output unless you specify the -q option.
You can cancel dbimport at any time by pressing the Interrupt key. The
dbimport program asks for confirmation before terminating.
The user who runs dbimport is granted the DBA privilege on the newly
created database.
Database Logging Mode

The logging mode is not retained in the schema file. You can specify any of
the following options when you import the database using dbimport:
ANSI-compliant database with unbuffered logging
Unbuffered logging
Buffered logging
Refer to Create Options on page 5-20.
SQL Utilities
5-17

Input File Location Options
Input
File
Location
-i directory name
-t device -b blocksize -s tapesize
-f pathname
-b
-f pathname
-i directory name
5-18
specifies, in kilobytes, the block size of the tape device.

If you are importing from tape, you must use the same
block size that you used to export the database.
specifies the pathname on disk where dbimport can
find the schema file to use as input to create the database when the data files are read from tape. If you
use -f, you typically use the same command filename
that you specified in the dbexport command. If you
specify only a filename, dbimport looks for the file in
the .exp subdirectory of your current directory. If you
used the -f option when you exported the database, you
usually use the -f option when you import the database
(you can always change the name of the schema file).
names the complete pathname of the directory on disk
where dbimport can find the database.exp directory that
contains the input data files and schema file. This directory should be the same directory that you specified
with the dbexport -o option. If you omit the -i option,
the dbimport utility looks for the database.exp directory
under the current directory.
-s tapesize
-t device
specifies, in kilobytes, the amount of data that can be

stored on the tape. If you are importing from tape, you
must use the same tape size that you used to export the
database.
specifies the pathname of the tape device where the
tape containing the input files is mounted. The -t option
does not allow you to specify a remote tape device.
If you do not specify an input file location, dbimport looks for data files in
the directory database.exp under the current directory and the schema file in
database.exp/database.sql.
The following command imports the stores7 database from a tape with a
block size of 16 kilobytes and a capacity of 24,000 kilobytes. The schema file
is read from /tmp/stores7.imp.
dbimport -c
-t /dev/rmt0 -b 16 -s 24000 -f /tmp/stores7.imp stores7
The following command imports the stores7 database from the stores7.exp
directory under the /work/exports directory. The schema file is assumed to be
/work/exports/stores7.exp/stores7.sql.
dbimport -c -i /usr/informix/port stores7
SQL Utilities
5-19

Create Options
Create
Options
OL
-d dbspace
-l
buffered
-ansi
SE
-l logfile
-ansi
-ansi
-d dbspace
-l
5-20
creates an ANSI-compliant database in which the ANSI

rules for transaction logging are enabled. For more
information about ANSI-compliant databases, see
Chapter 1, Informix Databases.
names the INFORMIX-OnLine Dynamic Server dbspace
where the database is created. If no dbspace is specified,
the database is created in the rootdbs.
establishes unbuffered transaction logging for the
imported database. The -l option is equivalent to the
WITH LOG IN clause of the CREATE DATABASE statement.
For more information about the CREATE DATABASE statement, see Chapter 1 in the Informix Guide to SQL: Syntax.
Changing the Database Name
-l buffered
-l logfile
establishes buffered transaction logging for the

imported database.
establishes transaction logging for the imported database and specifies the name of the transaction-log file.
The logfile filename must be an absolute pathname. The
-l logfile option is equivalent to the WITH LOG IN clause of
the CREATE DATABASE statement. For more information
about the CREATE DATABASE statement, see Chapter 1 in
the Informix Guide to SQL: Syntax.
For INFORMIX-OnLine Dynamic Server, if you do not specify a dbspace name,

the dbimport utility creates the database in the root dbspace by default.
For INFORMIX-SE, the dbimport utility always creates the database in the
current directory.
The following command imports the stores7 database from the
/usr/informix/port/stores7.exp directory to the current directory. The new
database is ANSI-compliant and the transaction-log file is specified as
stores7.log in /usr/work.
dbimport -c stores7 -i /usr/informix/port -l /usr/work/stores7.log -ansi
Changing the Database Name

The dbimport utility assumes that the new database has the same name as
the database which you exported. If you export a database to tape, you
cannot change its name when you import it with dbimport.
If you export a database to disk, you can change the database name. For the
purpose of the following example, assume that dbexport unloaded the database stores7 into the to the directory /work/exports/stores7.exp. Thus, the
data files (the .unl files) are stored in /work/exports/stores7.exp and the
schema file is /work/exports/stores7.exp/stores7.sql.
SQL Utilities
5-21
Using dbimport with NLS
To change the database name to newname, perform the following steps:

1.
Change the name of the .exp directory. That is, change

/work/exports/stores7.exp to /work/exports/newname.exp.
2.
Change the name of the schema file. That is, change

/work/exports/stores7.exp/stores7.sql to
/work/exports/stores7.exp/newname.sql. Do not change the names
of the .unl files.
3.
Import the database with the following command:
dbimport -i /work/exports newname
Using dbimport with NLS

You can use dbimport to create and populate an NLS database. Use the
dbexport utility to unload ASCII data from a non-NLS database. Set the
appropriate NLS environment variables and then use dbimport to change the
non-NLS database into an NLS database. See the discussion of dbexport and
NLS on Using dbexport with NLS on page 5-14.
Changing a non-NLS Database to an NLS Database

To change a non-NLS database to an NLS database, perform the following
steps:
1.
Run dbexport on the non-NLS database, as described in this chapter.
2.
Set the DBNLS environment variable to 2.
3.
Set the LANG environment variable to the desired locale for the NLS
database.
4.
Set the COLLCHAR environment variable to 1.
5.
Run dbimport for the NLS database, as described in this chapter.
All table columns of the CHAR data type in the non-NLS database are
converted to NCHAR, and VARCHAR columns are converted to NVARCHAR,
in the NLS database. If you want the NCHAR (or NVARCHAR) data type in a
CREATE PROCEDURE statement, however, you must set the COLLCHAR
environment variable when the procedure is executed.
5-22
The dbload Utility
You can also use dbimport to change the locale of a database. For example,
use dbexport to unload the schema as well as the data from a French database
and set the appropriate NLS environment variables for a German database.
You then use dbimport to create a German database and load the exported
French data.
Changing the Locale of an NLA Database

To change the locale of an NLS database, perform the following steps:
1.
Set the DBNLS environment variable to 2.

Set the LANG environment variable to the current locale for the
database.
2.
Run dbexport on the original database, as described in this chapter.
3.
Set LANG to the new locale.
4.
Run dbimport for the new database, as described in this chapter.
If you run dbexport on an NLS database and then try to convert it to a

non-NLS database with dbimport, you will probably encounter an error such
as illegal character.
The dbload Utility

The dbload utility transfers data from one or more ASCII or NLS files into one
or more existing tables. The dbload utility offers the following advantages
over using the LOAD statement:
You can use dbload to load data from input files that have been created with a variety of format arrangements. The dbload command
file can accommodate data from entirely different database management systems.
You can specify a starting point in the load by directing dbload to

read but ignore x number of rows.
SQL Utilities
5-23
The dbload Utility
You can specify a batch size so that after every x number of rows are
inserted, the insert is committed.
You can limit the number of bad rows read, beyond which dbload
ends.
The cost of dbload flexibility is the time and effort spent creating the dbload
command file, which is required for dbload operation. The ASCII input files
are not specified as part of the dbload command line, and neither are the
tables into which the data is inserted. This information is contained within
the command file.
You can load blobs with the dbload utility as long as the blobs are in ASCII
format.
The presence of indexes greatly affects the speed with which the dbload
utility loads data. For best performance, drop any indexes on the tables
receiving the data before you run dbload. You can create new indexes after
dbload has finished.
Chapter 4, Environment Variables, dbload can load the data into NLS
databases.
You can use delimited identifiers with the dbload utility. The utility detects
The dbload syntax and use information is described in the following
sections. The dbload command file structure and instructions for creating a
command file are found in Creating a dbload Command File on page 5-29.
5-24
Loading Data from a Command File into a Table
dbload
-d database
-c command file
-r
-l error log file
Load Start
Point
p. 5-27
-V
Command-File
Syntax Check
p. 5-27
Batch Size
p. 5-28
Bad-Row
Limits
p. 5-28
-X
-c command file
-d database
-l error log file
specifies the filename or pathname of a dbload

command file.
specifies the name of the database to receive the data. If
you want to use more than the simple name of the database, refer to the Database Name segment in Chapter 1
of the Informix Guide to SQL: Syntax.
specifies the filename or pathname of an error log file.
The error log file specified by the -l flag stores any input
file rows that dbload cannot insert into the database as
well as diagnostic information. If you specify an existing file, its contents are overwritten. If you specify a file
that does not exist, it is created.
SQL Utilities
5-25
instructs dbload not to lock the tables during loading,

enabling other users to update data in the table during
the load. If you do not specify -r, the tables specified in
the command file are locked during loading so that
other users cannot update data in the table. Table locking reduces the number of locks needed during the load
but reduces concurrency. If you are planning to load a
large number of rows, use table locking and load during
nonpeak hours.
-r
-X
-V
Tip: If you specify part (but not all) of the required information, dbload prompts
you for additional specifications. If you are missing all three options, you receive an
error message.
If you are on a network, you can specify a database on another database
server by including the database server name and directory path with the
database name.
The following command loads data into the stores7 database in the turku
directory on the finland database server (finland is an SE database server):
dbload -d //finland/turku/stores7 -c commands -l errlog
If your database supports transactions, dbload commits a transaction after

every 100 rows are inserted. To modify this default value, specify a batch size.
(See Batch Size on page 5-28.)
If your most recent dbload session ended prematurely, you can resume
loading with the next record in the file by specifying the starting line number
in the command-line syntax.
If you press the Interrupt key, dbload terminates and discards any new rows
that were inserted but not yet committed to the database (if the database has
transactions).
5-26

Command-File Syntax Check
Command-File
Syntax Check
-s
-s
instructs dbload to check the syntax of the statements in

the command file without inserting data. The -s option
performs a syntax check on the FILE and INSERT statements in the specified dbload command file. The screen
displays the command file with any errors marked
where they are found.
Load Start Point

Load
Start
Point
-i number rows ignore
-i number rows
ignore
instructs dbload to ignore the specified number of newline characters. The -i option instructs dbload to read
and ignore the specified number of new-line characters
in the input file before it begins processing. This option
is useful if your most recent dbload session ended prematurely. For example, if dbload ends after inserting
240 lines of input, you can resume loading at line 241 by
setting number rows ignore to 240. It is also useful if
header information in the input file precedes the data
records.
SQL Utilities
5-27

Batch Size
Batch
Size
-n number inserted rows
-n number
inserted rows
instructs dbload to commit the transaction after the

specified number of new rows are inserted. If your
database supports transactions, dbload commits a
transaction after every specified number of new rows is
read and inserted. A message appears after each commit. (For information about transactions, see Chapter 4
of the Informix Guide to SQL: Tutorial.) If you do not specify the -n option, dbload commits a transaction after
every 100 rows are inserted.
Bad-Row Limits
Bad-Row
Limits
-e number errors read
-p
5-28
Creating a dbload Command File
-e number errors
read
-p
specifies the number of bad rows that dbload reads

before terminating. If you set -e number errors read to a
positive integer, dbload terminates when it reads
number errors read + 1 bad rows. If you set the value of
number errors read to zero, dbload terminates when it
reads the first bad row. If you do not specify a bad-row
limit, the default is 10. This means that dbload terminates after it reads the eleventh bad row. In a database
with transactions, unless you specify otherwise, dbload
commits any new rows that were inserted since the last
transaction.
prompts for instructions if the number of bad rows
exceeds the limit. If dbload exceeds the bad-row limit
and the -p option is specified, dbload prompts you for
instructions before it terminates. The prompt asks
whether you want to roll back or to commit all rows
inserted since the last transaction. If dbload exceeds the
bad-row limit and the -p option is not specified, dbload
commits all rows inserted since the last transaction.

Before you use dbload, create an ASCII command file that names the input
data files and the tables that receive the data. The command file maps fields
from one or more input files into columns of one or more tables within your
database.
The command file contains only FILE and INSERT statements. Each FILE
statement names an input data file. The FILE statement also defines the data
fields from the input file that are inserted into the table. Each INSERT statement names a table to receive the data. The INSERT statement also defines
how dbload places the data described in the FILE statement into the table
columns.
Within the command file, the FILE statement can appear in the following
forms:
Delimiter form
Character-position form
SQL Utilities
5-29
The FILE statement has a size limit of 4,096 bytes.

Use the delimiter form of the FILE statement when every field in the input
data row uses the same delimiter and every row ends with a new-line character. This format is typical of data rows with variable-length fields. You can
also use the delimiter form of the FILE statement with fixed-length fields as
long as the data rows meet the delimiter and new-line requirements. The
delimiter form of the FILE and INSERT statements is easier to use than the
character-position form.
Use the character-position form of the FILE statement when you cannot rely
on delimiters and you need to identify the input data fields by character position within the input row. For example, use this form to indicate that the first
input data field begins at character position 1 and continues until character
position 20. You can also use this form if you must translate a character string
into a null value. For example, if your input data file uses a sequence of
blanks to indicate a null value, you must use this form if you want to instruct
dbload to substitute null at every occurrence of the blank-character string.
You can use both forms of the FILE statement in a single command file.
However, for clarity, the two forms are described separately in the following
sections.
FILE and INSERT Statements: Delimiter Form

The following example of a dbload command file illustrates a simple
delimiter form of the FILE and INSERT statements. The example is based on
the stores7 database. The three input data files, stock.unl, customer.unl, and
manufact.unl, were created by an UNLOAD statement. (To see the .unl input
data files, refer to the directory $INFORMIXDIR/demo/prod_name.)
FILE stock.unl DELIMITER '|' 6;
INSERT INTO stock;
FILE customer.unl DELIMITER '|' 10;
INSERT INTO customer;
FILE manufact.unl DELIMITER '|' 3;
INSERT INTO manufact;
5-30

Syntax for the Delimiter Form
The following syntax shows an example of the delimiter FILE statement:
FILE
c
filename
nfields
filename
DELIMITER
'c'
nfields
defines the field delimiter for the specific input file specified as filename.
specifies the input file.
is an integer indicating the number of fields in each data
row contained in filename.
If the delimiter specified by c appears as a literal character anywhere in the

input file, it must be preceded with a backslash in the input file. For example,
if the value of c is specified as [ , you need to place a backslash before any literal [ that appeared in the input file. Similarly, you must precede any
backslash that appears in the input file with an additional backslash.
The dbload utility assigns the sequential names f01, f02, f03, and so on to
fields in the input file. You cannot see these names, but if you refer to these
fields to specify a value list in an associated INSERT statement, you must use
the f01, f02, f03 format. Refer to How to Write a dbload Command File in
Delimiter Form on page 5-33 for details.
Two consecutive delimiters define a null field. As a precaution, you can place
a delimiter immediately before the new-line character that marks the end of
each data row. If you omit this delimiter, an error results whenever the last
field of a data row is empty. If you are certain that none of the input data rows
ends with an empty field, you can omit this step.
Inserted data types correspond to the explicit or default column list. If the
data field width is different from its corresponding character column width,
the data is made to fit. That is, inserted values are padded with blanks if the
data is not wide enough for the column or truncated if the data is too wide
for the column.
SQL Utilities
5-31
If the number of columns named is fewer than the number of columns in the
table, dbload inserts the default value specified when the table was created
for the unnamed columns. If no default value is specified, dbload attempts to
insert a null value. If the attempt violates a NOT NULL restriction or a unique
constraint, the insert fails and an error message is returned.
If the INSERT statement omits the column names, the default INSERT
specification is every column in the named table. If the INSERT statement
omits the VALUES clause, the default INSERT specification is every field of the
previous FILE statement.
An error results if the number of column names listed (or implied by default)
does not match the number of values listed (or implied by default).
The syntax of dbload INSERT statements resembles INSERT statements in
SQL, except that in dbload, INSERT statements cannot incorporate SELECT
statements. The following diagram shows the syntax of the dbload INSERT
statement for delimiter form:
INSERT INTO
table name
(
owner.
column name
table name
owner.
,
column
name
INSERT
statement
VALUES
Clause.
See SQL:S.
specifies the column that receives the new data.

specifies the table that receives the new data.
is the user name of the owner of the table.
Users who execute dbload with this command file must have the Insert
privilege on the named table.
5-32

How to Write a dbload Command File in Delimiter Form
The first FILE and INSERT statement set in the delimiter example on page 5-30
is repeated in the following example:
INSERT INTO stock;
The FILE statement describes the stock.unl data rows as composed of six
fields, each separated by a vertical bar (|) as the delimiter. Compare the FILE
statement with the data row shown in the following example, which appear
in the input file stock.unl. (Because the last field is not followed by a delimiter, an error results if any data row ends with an empty field.)
1|SMT|baseball gloves|450.00|case|10 gloves/case
2|HRO|baseball|126.00|case|24/case
3|SHK|baseball bat|240.00|case|12/case
The example INSERT statement contains only the required elements. Because
the column list is omitted, the INSERT statement implies that values are to be
inserted into every field in the stock table. Because the VALUES clause is
omitted, the INSERT statement implies that the input values for every field
are defined in the most recent FILE statement. This INSERT statement is valid
because the stock table contains six fields, which is the same number of values defined by the FILE statement. The first data row inserted into stock from
this INSERT statement is shown in the following example:
Column
Value
f01
stock_num
f02
manu_code
SMT
f03
description
baseball gloves
f04
unit_price
450.00
f05
unit
case
f06
unit_descr
10 gloves/case
SQL Utilities
5-33
The FILE and INSERT statement shown in the following example set
illustrates a more complex INSERT statement syntax:
INSERT INTO new_stock (col1, col2, col3, col5, col6)
VALUES (f01, f03, f02, f05, 'autographed');
In this example, the VALUES clause uses the field names automatically
assigned by dbload. You must reference the automatically assigned field
names with the letter f followed by a number: f01, f02, f10, f100, f999, f1000,
and so on. All other formats are incorrect.
Tip: The first nine fields must include a zero: f01, f02, ..., f09.
The user changed the column names, the order of the data, and the meaning
of col6 in the new stock table. Because the fourth column in new_stock (col4)
is not named in the column list, the new data row contains a null in the col4
position (assuming that the column permits nulls). If no default is specified
for col4, the inserted value is null.
The first data row inserted into new_stock from this INSERT statement is
5-34
Column
Value
col1
col2
baseball gloves
col3
SMT
col4
null
col5
case
col6
autographed

FILE and INSERT Statements: Character-Position Form
The examples in this section are based on an input data file, cust_loc_data,
that contains the last four fields (city, state, zipcode, and phone) of the
customer table. Fields in the input file are padded with blanks to create data
rows in which the location of data fields and the number of characters are the
same across all rows. The definitions for these fields are CHAR(15), CHAR(2),
CHAR(5), and CHAR(12), respectively. For your reference, Figure 5-1 displays
the character positions and five example data rows from the cust_loc_data
file:
Figure 5-1
A sample data file
1
2
3
1234567890123456789012345678901234
Sunnyvale
Denver
Blue Island
Brighton
Tempe
CA94086408-789-8075
CO80219303-936-7731
NY60406312-944-5691
MA02135617-232-4159
AZ85253xxx-xxx-xxxx
The following example of a dbload command file illustrates the characterposition form of the FILE and INSERT statements. The example includes two
new tables, cust_address and cust_sort, to receive the data. For the purpose
of this example, cust_address contains four columns, the second of which is
omitted from the column list. The cust_sort table contains two columns.
FILE cust_loc_data
(city 1-15,
state 16-17,
area_cd 23-25 NULL = 'xxx',
phone 23-34 NULL = 'xxx-xxx-xxxx',
zip 18-22,
state_area 16-17 : 23-25);
INSERT INTO cust_address (col1, col3, col4)
VALUES (city, state, zip);
INSERT INTO cust_sort
VALUES (area_cd, zip);
SQL Utilities
5-35

Syntax for the Character-Position Form
The character-position FILE statement is shown in the following diagram:
,
FILE
filename
fieldn
);
:
NULL = 'null string'
start
-end
-end
fieldn
filename
null string
start
is a hyphen followed by an integer that indicates the

character position within a data row that ends a range
of character positions.
is a name that you assign to the data field that you are
defining with the range of character positions.
is the name of the input file.
is a quoted string that specifies the data value for which
dbload should substitute a null.
is an integer that indicates the character position within
a data row that starts a range of character positions. If
you use start without end, it represents a single
character.
The same character position can be repeated in a data-field definition or in

different fields.
The null string scope of reference is the data field for which you define it. You
can define an explicit null string for each field that allows null entries.
Inserted data types correspond to the explicit or default column list. If the
data field width is different from its corresponding character column,
inserted values are padded with blanks if the column is wider or are
truncated if the field is wider.
5-36
If the number of columns named is fewer than the number of columns in the
table, dbload inserts the default value specified for the unnamed columns. If
no default value is specified, dbload attempts to insert a null value. If the
attempt violates a NOT NULL restriction or a unique constraint, the insert fails
and an error message is returned.
If the INSERT statement omits the column names, the default INSERT
specification is every column in the named table. If the INSERT statement
omits the VALUES clause, the default INSERT specification is every field of the
previous FILE statement.
An error results if the number of column names listed (or implied by default)
does not match the number of values listed (or implied by default).
The syntax of dbload INSERT statements resembles INSERT statements in
SQL, except that in dbload, INSERT statements cannot incorporate SELECT
statements. The following diagram shows the syntax of the dbload INSERT
statement for character-position form:
INSERT INTO
table name
(
owner.
column name
table name
owner.
,
column
name
INSERT
statement
VALUES clause.
See SQL:S.
is the column that receives the new data.

is the table that receives the new data.
is the user name of the table owner.
The syntax for character-position form is identical to the syntax for delimiter
form.
The user who executes dbload with this command file must have the Insert
privilege on the named table. In INFORMIX-SE, the dbload utility recognizes
valid SE table references, including owner designations. That is, the table
name can be preceded by owner name but not by database server name or
database name. Valid table-name syntax is defined in detail in the Informix
Guide to SQL: Syntax.
SQL Utilities
5-37

How to Write a dbload Command File in Character-Position Form
The first FILE and INSERT statement set in the character-position example on
page 5-35 is repeated in the following example:
FILE cust_loc_data
(city 1-15,
state 16-17,
area_cd 23-25 NULL = 'xxx',
phone 23-34 NULL = 'xxx-xxx-xxxx',
zip 18-22,
state_area 16-17 : 23-25);
The FILE statement defines six data fields from the cust_loc_data table data
rows. The statement names the fields and defines the length of each field
using character positions. Compare the FILE statement in the preceding
example with the data rows in the Figure 5-2.
Figure 5-2
A sample data file
1
2
3
1234567890123456789012345678901234
Sunnyvale++++++CA94086408-789-8075
Tempe++++++++++AZ85253xxx-xxx-xxxx
Data row 1
Data row 2
The FILE statement defines the following data fields, which are derived from
the data rows in Figure 5-2.
5-38
Column
Values from Data Row 1
city
Sunnyvale++++++
Tempe++++++++++
state
CA
AZ
area_cd
408
null
phone
408-789-8075
null
zip
94086
85253
state_area
CA408
AZxxx
The null strings defined for the phone and area_cd fields generate the null
values in those columns but do not affect the values stored in the state_area
column.
The INSERT statement uses the field names and values derived from the FILE
statement as the value-list input. Consider the following INSERT statement:
Using the the FILE statement on page 5-38 and the data shown in Figure 5-2,
the INSERT statement puts the following information into the cust_address
table:
Column
col1
Sunnyvale++++++
Tempe++++++++++
col2
null
null
col3
CA
AZ
col4
94086
85253
Because the second column in cust_address (col2) is not named, the new data
row contains a null (assuming that the column permits nulls).
Consider the following INSERT statement:
INSERT INTO cust_sort
VALUES (area_cd, zip);
SQL Utilities
5-39
The dbschema Utility
This INSERT statement inserts the following data rows into the cust_sort
table:
Column
col1
408
null
col2
94086
85253
Because no column list is provided, dbload reads the names of all the
columns in cust_sort from the system catalog. (You cannot insert data into a
temporary table because temporary tables are not entered into the system
catalog.) Values to load into each column are specified by field names from
the previous FILE statement. You do not need one FILE statement for each
INSERT statement.

You can use the dbschema utility for the following purposes:
5-40
To display the SQL statements (the schema) required to replicate a

database or a specific table, view, or procedure
To display the schema for the Information Schema views
To display the distribution information stored for one or more tables

in the database
dbschema
Synonyms
p. 5-44
Privileges
p. 5-44
Tables, Views, or
Procedures
p. 5-46
Table Name.
See SQL:S.
-hd
all
-d database
filename
-ss
-V
all
-d database
filename
-hd
directs dbschema to include all the tables in the database in the display of distributions.
specifies the database to which the schema applies. The
database can be on a remote database server. If you
want to use more than the simple name of the database,
refer to the Database Name segment in Chapter 1 of the
specifies the filename to contain the dbschema output.
If you do not supply a filename, dbschema sends output
to the screen. If you do supply a filename, dbschema creates a file to contain the dbschema output and gives it
the name you specify.
displays the distribution as data values. See Displaying the Distribution Information for Tables on
page 5-47.
SQL Utilities
5-41
Creating the Schema for a Database
generates server-specific information for a table specified in previous options. This option is ignored if no
table schema is generated. In INFORMIX-SE, the -ss
option generates the pathname where the table was created if the table is not in the database directory. In
INFORMIX-OnLine Dynamic Server, the -ss option
always generates the lock mode, extent sizes, and the
dbspace name if the dbspace name is different from the
database dbspace. In addition, if tables are fragmented,
the -ss option displays information about the fragmentation strategy.
-ss
-V
You must be the DBA or have the Connect or Resource privilege to the
database before you can run dbschema on it. If you are using INFORMIX-SE,
the database must exist in your current directory or in a directory cited in
your DBPATH environment variable.
Chapter 4, Environment Variables, dbschema can handle foreign
characters and NLS databases.
You can use delimited identifiers with the dbschema utility. The utility
detects database objects that are keywords, mixed case, or have special
characters and places double quotes around them.

You can create the schema for an entire database or for a portion of the
database. The options for dbschema allow you to perform the following
actions:
5-42
Display CREATE SYNONYM statements by owner, for a specific table,

or for the entire database.
Display the CREATE TABLE, CREATE VIEW, or CREATE PROCEDURE

statements for a specific table or for the entire database.
Display all GRANT privilege statements that affect a specified user or

that affect all users for a database or a specific table.
Using dbschema and specifying only the database name is equivalent to

using dbschema with all its options (except for the -hd and -ss options). In
addition, if Information Schema views have been created for the database,
this schema is shown. For example, the following two statements are
equivalent:
dbschema -d stores7
dbschema -s all -p all -t all -f all -d stores7
The SERIAL fields included in CREATE TABLE statements displayed by

dbschema do not specify a starting value. New SERIAL fields created using
the schema file have a starting value of one, regardless of their starting value
in the original database. If this is not acceptable, you must modify the schema
file.
Creating Schemas for Databases Across a Network

You can specify a database on any accessible OnLine database server using
the syntax in the database name. You can specify a database on another SE
database server by including the database server name and directory path
with the database name.
The command shown in the following example displays the schema for the
stores7 database in the turku directory on the finland database server:
dbschema -d //finland/turku/stores7
Owner Naming with dbschema

The dbschema utility uses the owner.object convention when it generates any
CREATE TABLE, CREATE INDEX, CREATE SYNONYM, CREATE VIEW, CREATE
PROCEDURE, or GRANT statements, and when it reproduces any unique, referential, or check constraints. As a result, if you use the dbschema output to
create a new object (table, index, view, procedure, constraint, or synonym),
the new object is owned by the owner of the original object. If you want to
change the owner of the new object, you must edit the dbschema output
before you run it as an SQL script.
For more information about the CREATE TABLE, CREATE INDEX, CREATE
SYNONYM, CREATE VIEW, CREATE PROCEDURE, and GRANT statements, see
the Informix Guide to SQL: Syntax.
SQL Utilities
5-43

Obtaining the Synonym Schema
Synonyms
-s
ownername
all
-s ownername
-s all
directs dbschema to display the CREATE SYNONYM

statements owned by ownername.
directs dbschema to display all CREATE SYNONYM
statements for the database, table, or view specified.
Output from dbschema that is executed with the specified option -s alice
might appear, as shown in the following example:
CREATE SYNONYM 'alice'.cust FOR 'alice'.customer
For more information about the CREATE SYNONYM statement, see the
Obtaining the Privilege Schema

Privileges
-p
user
all
-p user
-p all
directs dbschema to display the GRANT statements that

grant privileges to user. You specify only one user.
directs dbschema to display the GRANT statements for
all users for the database, table, or view specified.
You cannot specify a specific list of users with the -p option. You can specify
either one user or all users.
5-44
In the dbschema output, the AS keyword indicates the grantor of a GRANT

statement. The following example output indicates that norma issued the
GRANT statement:
GRANT ALL ON 'tom'.customer TO 'claire' AS 'norma'
When the GRANT and AS keywords appear in the dbschema output, you
might need to grant privileges before you run the dbschema output as an
SQL script. Referring to the previous example output line, the following conditions must be true before you can run the statement as part of a script:
norma must have the Connect privilege to the database.
norma must have all privileges WITH GRANT OPTION for the table
tom.customer.
For more information about the GRANT statement, see the Informix Guide to
SQL: Syntax.
SQL Utilities
5-45

Specifying a Table, View, or Procedure
Tables,
Views, or
Procedures
-t
table name
-f
procedure name
all
view name
all
-f all
-f procedure name
-t table name
-t view name
-t all
directs dbschema to limit the SQL statement output to

those statements that are needed to replicate all
procedures.
only those statements that are needed to replicate the
specified procedure.
specified table.
specified view.
directs dbschema to include in the SQL statement
output all statements that are needed to replicate all
tables and views.
For more information about the CREATE PROCEDURE statement, see the
5-46
Displaying the Distribution Information for Tables

Using the -ss Option to Obtain Table Information
When you use the -ss option, you can retrieve information about fragmented
tables, the lock mode, and extent sizes.
The following dbschema output shows the expressions specified for
fragmented table:
DBSCHEMA Schema Utility
INFORMIX-SQL Version 7.1.UC1
Copyright (C) Informix Software, Inc., 1984-1994
{ TABLE sallyc.t1 row size = 8 number of columns = 1 index size = 0 }
create table sallyc.t1
(
c1 integer
) fragment by expression
(c1 < 100 ) in db1 ,
((c1 >= 100 ) AND (c1 < 200 ) ) in db2 ,
remainder in db4
extent size 16 next size 16 lock mode page;
revoke all on sallyc.t1 from public;

To display the distribution information stored for a table in a database, use
the -hd option with the name of the table. If you specify the ALL keyword for
the tablename, the distributions for all the tables in the database are
displayed.
Distribution information is stored only if the UPDATE STATISTICS...MEDIUM
or HIGH statement has been run for one or more columns of a table.
The output of dbschema for distributions is provided in the following parts:
Distribution description
Distribution information
Overflow information
Each section provided by dbschema is explained in the following sections. As

an example, the discussion uses the following distribution for the fictional
table called invoices. This table contains 165 rows, including duplicates.
SQL Utilities
5-47
The output for this discussion can be generated with a call to dbschema that
is similar to the following example:
dbschema -hd invoices -d pubs_stores7
Example Output
DBSCHEMA Schema Utility
INFORMIX-SQL Version 7.1.UC1
Copyright (C) Informix Software, Inc., 1984-1994
{
Distribution for cathl.invoices.invoice_num
Constructed on 03/10/1994
High Mode, 10.000000 Resolution
--- DISTRIBUTION --1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
(
(
(
(
(
(
(
(
(
(
(
16,
16,
16,
16,
16,
16,
16,
16,
16,
10,
7,
6,
8,
8,
7,
8,
12,
12,
11,
5,
5)
11)
17)
25)
38)
52)
73)
95)
139)
182)
200)
--- OVERFLOW --1: (

2: (
}
5-48
5,
6,
56)
63)

Distribution Description
The first part of the dbschema output describes which data distributions
have been created for the specified table. The name of the table is stated in the
following example:
Distribution for cathl.invoices.invoice_num
The output is for the invoices table, which is owned by the user cathl. The
particular column being described by this data distribution is invoice_num.
If a table has distributions built on more than one column, dbschema lists the
distributions for each column separately.
The date on which the distributions are constructed is listed. In this example,
it is 03/10/1994, which is the date when the UPDATE STATISTICS statement
that generated the distributions was executed. You can use this date to tell
how outdated your distributions are. Although the system records the date,
it does not record the time.
The last line of the description portion of the output describes the mode
(medium or high) in which the distributions were created, and the resolution.
If you create the distributions with medium mode, the confidence of the sample is also listed. For example, if the UPDATE STATISTICS statement is executed with HIGH mode with a resolution of 10, the last line appears as shown
in the following example:
High Mode, 10.000000 Resolution
The Distribution Information

The distribution information describes the bins created for the distribution,
the range of values in the table and in each bin, and the number of distinct
values in each bin. Consider the following example:
1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
(
(
(
(
(
(
(
(
(
(
(
16,
16,
16,
16,
16,
16,
16,
16,
16,
10,
7,
6,
8,
8,
7,
8,
12,
12,
11,
5,
5)
11)
17)
25)
38)
52)
73)
95)
139)
182)
200)
SQL Utilities
5-49
The first value shown in the rightmost column is the smallest value in the
table in this column. In this example, it is 5.
The column on the left shows the bin number, in this case 1 through 10. The
first number in the parenthesis shows how many values are in the bin. For
this table, 10 percent of the total number of rows (165) is, rounded down, 16.
The first number is the same for all the bins except for the last. The last row
might have a smaller value, indicating that it does not have as many row values. In this example, all the bins contain 16 rows except the last one, which
contains 10.
The middle column within the parenthesis indicates how many distinct values are contained in this bin. Thus, if there are 11 distinct values for a 16-value
bin, it implies that 1 or more of those values are duplicated at least once.
The right column within the parenthesis is the highest value in the bin. The
highest value in the last bin is also the highest value in the table. For this
example, the highest value in the last bin is 200.
The Overflow Information

The last portion of the dbschema output shows values that have many duplicates. The number of duplicates of indicated values must be greater than a
critical amount that is determined as approximately 25 percent of the resolution times the number of rows. If left in the general distribution data, they
would skew the distribution, so they are moved from the distribution to a
separate list, as shown in the following example:
--- OVERFLOW --1: (
2: (
5,
6,
56)
63)
For this example, the critical amount is 0.25 0.10 165, or 4.125. Therefore,
any value that is duplicated five or more times is listed in the overflow
section. Two values in this distribution are duplicated five or more times in
the table: The value 56 is duplicated five times and the value 63 is duplicated
six times.
5-50
Appendix
The stores7 database contains a set of tables that describe an imaginary

business. The examples in the Informix Guide to SQL: Syntax and Informix
Guide to SQL: Tutorial are based on this database. The stores7 database is
not ANSI-compliant. Information on creating the stores7 database
appears in the section Creating the Demonstration Database in the
Introduction of this manual.
This appendix contains the following sections:
The first section describes the structure of the tables in the stores7
database. It identifies the primary key of each table, lists the name
and data type of each column, and indicates whether the column
has a default value or check constraint. Indexes on columns are
also identified and classified as unique or if they allow duplicate
values.
The second section shows a graphic map of the tables in the

stores7 database and indicates the relationships between
columns.
The third section describes the primary-foreign key relationships

between columns in tables.
The final section shows the data contained in each table of the
stores7 database.
Structure of the Tables
Structure of the Tables

The stores7 database contains information about a fictitious sporting-goods
distributor that services stores in the western United States. This database
includes the following tables:
customer
orders
items
stock
catalog
cust_calls
call_type
manufact
state
The following sections describe each table. The unique identifier for each
table (primary key) is shaded and indicated by a key symbol.
The customer Table

The customer table contains information about the retail stores that place
orders from the distributor. The columns of the customer table are shown in
Figure A-1.
A-2
The orders Table
The zipcode column in Figure A-1 is indexed and allows duplicate values.
Figure A-1
The customer table
Column
Name
customer_num
fname
lname
company
address1
address2
city
state
zipcode
phone
Data
Type
SERIAL(101)
CHAR(15)
CHAR(15)
CHAR(20)
CHAR(20)
CHAR(20)
CHAR(15)
CHAR(18)
CHAR(2)
CHAR(5)
Description
system-generated customer number
first name of store representative
last name of store representative
name of store
first line of store address
second line of store address
city
state (foreign key to state table
zipcode
telephone number
The orders Table

The orders table contains information about orders placed by the customers
of the distributor. The columns of the orders table are shown in
Figure A-1.
Figure A-2
The orders table
Column
Name
order_num
order_date
customer_num
Data
Type
ship_instruct
backlog
CHAR(40)
CHAR(1)
po_num
ship_date
ship_weight
ship_charge
paid_date
CHAR(10)
DATE
DECIMAL(8,2)
MONEY(6)
DATE
SERIAL(1001)
DATE
INTEGER
Description
system-generated order number
date order entered
customer number (foreign key to customer
table)
special shipping instructions
indicates order cannot be filled because the item
is backlogged:
y = yes
n = no
customer purchase order number
shipping date
shipping weight
shipping charge
date order paid
A-3
The items Table
The items Table

An order can include one or more items. One row exists in the items table for
each item in an order. The columns of the items table are shown in
Figure A-3.
Figure A-3
The items table
Column
Name
item_num
order_num
stock_num
manu_code
Data
Type
quantity
total_price
SMALLINT
MONEY(8)
SMALLINT
INTEGER
SMALLINT
CHAR(3)
Description
sequentially assigned item number for an order
order number (foreign key to orders table)
stock number for item (foreign key to stock table)
manufacturer code for item ordered (foreign key
to manufact table)
quantity ordered (value must be > 1)
quantity ordered unit price = total price of item
The stock Table

The distributor carries 41 types of sporting goods from various manufacturers. More than one manufacturer can supply an item. For example, the
distributor offers racer goggles from two manufacturers and running shoes
from six manufacturers.
A-4
The catalog Table
The stock table is a catalog of the items sold by the distributor. The columns
of the stock table are shown in Figure A-4.
Figure A-4
The stock table
Column
Name
stock_num
manu_code
Data
Type
description
unit_price
unit
CHAR(15)
MONEY(6,2)
CHAR(4)
unit_descr
CHAR(15)
SMALLINT
CHAR(3)
Description
stock number that identifies type of item
manufacturer code (foreign key to manufact
table)
description of item
unit price
unit by which item is ordered:
each
pair
case
box
description of unit
The catalog Table

The catalog table describes each item in stock. Retail stores use this table
when placing orders with the distributor. The columns of the catalog table
are shown in Figure A-5.
Figure A-5
The catalog table
Column
Name
catalog_num
stock_num
Data
Type
manu_code
CHAR(3)
cat_descr
cat_picture
cat_advert
TEXT
BYTE
VARCHAR(255, 65)
SERIAL(10001)
SMALLINT
Description
system-generated catalog number
distributor stock number (foreign key to
stock table)
manufacturer code (foreign key to
manufact table)
description of item
picture of item (binary data)
tag line underneath picture
The catalog table appears only if you are using an OnLine database server.
A-5
The cust_calls Table
The cust_calls Table

All customer calls for information on orders, shipments, or complaints are
logged. The cust_calls table contains information about these types of
customer calls. The columns of the cust_calls table are shown in Figure A-6.
Column
Name
customer_num
call_dtime
user_id
call_code
call_descr
res_dtime
res_descr
Data
Type
Description
INTEGER
customer number (foreign
key to customer table)
DATETIME YEAR TO MINUTE date and time call received
CHAR(18)
name of person logging call
(default is user login name)
CHAR(1)
type of call (foreign key to
call_type table)
CHAR(240)
description of call
DATETIME YEAR TO MINUTE date and time call resolved
CHAR(240)
description of how call was
resolved
Figure A-6
The cust_calls table
The call_type Table

The call codes associated with customer calls are stored in the call_type table.
The columns of the call_type table are shown in Figure A-7.
Column
Name
call_code
code_descr
A-6
Data
Type
CHAR(1)
CHAR (30)
Description
call code
description of call type
Figure A-7
The call_type table
The manufact Table
The manufact Table

Information about the nine manufacturers whose sporting goods are handled
by the distributor is stored in the manufact table. The columns of the
manufact table are shown in Figure A-8.
Column
Name
manu_code
manu_name
lead_time
Data
Type
CHAR(3)
CHAR(15)
INTERVAL DAY(3) TO DAY
Description
manufacturer code
name of manufacturer
lead time for shipment
of orders
Figure A-8
The manufact table
The state Table

The state table contains the names and postal abbreviations for the 50 states
of the United States. The columns of the state table are shown in
Figure A-9.
Column
Name
code
sname
Data
Type
CHAR(2)
CHAR(15)
Description
state code
state name
Figure A-9
The state table

Figure A-10 displays the joins in the stores7 database. The lines connecting
a column in one table to the same column in another table indicate the
relationships, or joins, between tables.
A-7
A-8

ship_charge
paid_date
lname
address1
address2
city
state
zipcode
phone
user_id
call_code
call_descr
res_dtime
res_descr
state
code
sname
call_type
call_code
call_descr
company
fname
call_dtime
ship_weight
ship_date
po_num
backlog
ship_instruct
customer_num
customer_num
customer_num
total_price
quantity
manu_code
stock_num
order_date
customer
order_num
order_num
cust_calls
item_num
orders
items
unit_descr
unit
unit_price
description
manu_code
stock_num
stock
cat_advert
cat_picture
cat_descr
manu_code
stock_num
catalog_num
catalog
lead_time
manu_name
manu_code
manufact
Figure A-10
Joins in the stores7 database
Primary-Foreign Key Relationships
Primary-Foreign Key Relationships

The tables of the stores7 database are linked by the primary-foreign key
relationships shown in Figure A-10 and identified in this section. This type of
relationship is called a referential constraint because a foreign key in one table
references the primary key in another table. Figure A-11 through Figure A-18
show the relationships among tables and how information stored in one table
supplements information stored in others.
The customer and orders Tables

The customer table contains a customer_num column that holds a number
identifying a customer, along with columns for the customer name, company,
address, and telephone number. For example, the row with information
about Anthony Higgins contains the number 104 in the customer_num column. The orders table also contains a customer_num column that stores the
number of the customer who placed a particular order. In the orders table, the
customer_num column is a foreign key that references the customer_num
column in the customer table. This relationship is shown in Figure A-11.
customer Table (detail)
customer_num
101
102
103
104
fname
lname
Ludwig
Carole
Philip
Anthony
Pauli
Sadler
Currie
Higgins
Figure A-11
Tables joined by the
customer_num
column
orders Table (detail)

order_num
1001
1002
1003
1004
order_date
05/20/1994
05/21/1994
05/22/1994
05/22/1994
customer_num
104
101
104
106
A-9
The orders and items Tables
According to Figure A-11, customer 104 (Anthony Higgins) has placed two
orders, as his customer number appears in two rows of the orders table.
Because the customer number is a foreign key in the orders table, you can
retrieve Anthony Higgins name, address, and information about his orders
at the same time.
The orders and items Tables

The orders and items tables are linked by an order_num column that contains an identification number for each order. If an order includes several
items, the same order number appears in several rows of the items table. In
the items table, the order_num column is a foreign key that references the
order_num column in the orders table. Figure A-12 shows this relationship.
orders Table (detail)
order_num
order_date
1001
1002
1003
customer_num
05/20/1994
05/21/1994
05/22/1994
104
101
104
items Table (detail)
A-10
item_num
order_num
stock_num
manu_code
1
1
2
1
2
3
1001
1002
1002
1003
1003
1003
1
4
3
9
8
5
HRO
HSK
HSK
ANZ
ANZ
ANZ
Figure A-12
order_num column
The items and stock Tables
The items and stock Tables

The items table and the stock table are joined by two columns: the
stock_num column, which stores a stock number for an item, and the
manu_code column, which stores a code that identifies the manufacturer.
You need both the stock number and the manufacturer code to uniquely
identify an item. For example, the item with the stock number 1 and the manufacturer code HRO is a Hero baseball glove; the item with the stock number
1 and the manufacturer code HSK is a Husky baseball glove. The same stock
number and manufacturer code can appear in more than one row of the
items table, if the same item belongs to separate orders. In the items table, the
stock_num and manu_code columns are foreign keys that reference the
stock_num and manu_code columns in the stock table. This is illustrated in
Figure A-13.
items Table (detail)
item_num
order_num
stock_num
manu_code
1
1
2
1
2
3
1
1001
1002
1002
1003
1003
1003
1004
1
4
3
9
8
5
1
HRO
HSK
HSK
ANZ
ANZ
ANZ
HRO
Figure A-13
stock_num and
manu_code
columns
stock Table (detail)

stock_num
manu_code
1
1
1
HRO
HSK
SMT
description
baseball gloves
baseball gloves
baseball gloves
A-11
The stock and catalog Tables
The stock and catalog Tables

The stock table and catalog table are joined by two columns: the stock_num
column, which stores a stock number for an item, and the manu_code
column, which stores a code that identifies the manufacturer. You need both
columns to uniquely identify an item. In the catalog table, the stock_num
and manu_code columns are foreign keys that reference the stock_num and
manu_code columns in the stock table. Figure A-14 shows this relationship.
stock_num
manu_code
1
1
1
HRO
HSK
SMT
description
baseball gloves
baseball gloves
baseball gloves
catalog Table (detail)
A-12
catalog_num
stock_num
manu_code
10001
10002
10003
10004
1
1
1
2
HRO
HSK
SMT
HRO
Figure A-14
stock_num and
manu_code
columns
The stock and manufact Tables
The stock and manufact Tables

The stock table and the manufact table are joined by the manu_code column.
The same manufacturer code can appear in more than one row of the stock
table if the manufacturer produces more than one piece of equipment. In the
stock table, the manu_code column is a foreign key that references the
manu_code column in the manufact table. This relationship is illustrated in
Figure A-15.
stock_num
manu_code
1
1
1
HRO
HSK
SMT
description
Figure A-15
manu_code column
baseball gloves
baseball gloves
baseball gloves
manufact Table (detail)

manu_code
manu_name
NRG
HSK
HRO
Norge
Husky
Hero
A-13

The cust_calls table and the customer table are joined by the customer_num
column. The same customer number can appear in more than one row of the
cust_calls table if the customer calls the distributor more than once with a
problem or question. In the cust_calls table, the customer_num column is a
foreign key that references the customer_num column in the customer table.
This relationship is illustrated in Figure A-16.
customer_num
101
102
103
104
105
106
fname
lname
Ludwig
Carole
Philip
Anthony
Raymond
George
Pauli
Sadler
Currie
Higgins
Vector
Watson
cust_calls Table (detail)

customer_num
106
127
116
116
A-14
call_dtime
user_id
1994-06-12 08:20
1994-07-31 14:30
1993-11-28 13:34
1993-12-21 11:24
maryj
maryj
mannyh
mannyh
Figure A-16
customer_num
column

The call_type and cust_calls tables are joined by the call_code column. The
same call code can appear in more than one row of the cust_calls table
because many customers can have the same type of problem. In the cust_calls
table, the call_code column is a foreign key that references the call_code column in the call_type table. This relationship is illustrated in Figure A-17.
Figure A-17
call_code column
call_type Table (detail)

call_code
B
D
I
L
O
code_descr
billing error
damaged goods
incorrect merchandise sent
late shipment
other
cust_calls Table (detail)

customer_num
106
127
116
116
call_dtime
1994-06-12 08:20
1994-07-31 14:30
1993-11-28 13:34
1993-12-21 11:24
call_code
D
I
I
I
A-15
The state and customer Tables
The state and customer Tables

The state table and the customer table are joined by a column that contains
the state code. This column is called code in the state table and state in the
customer table. If several customers live in the same state, the same state
code appears in several rows of the table. In the customer table, the state column is a foreign key that references the code column in the state table. This
is shown in Figure A-18.
customer_num
101
102
103
fname
lname
---
state
Ludwig
Carole
Philip
Pauli
Sadler
Currie
-------
CA
CA
CA
Figure A-18
state/code column
state Table (detail)

code
sname
AK
AL
AR
AZ
CA
Alaska
Alabama
Arkansas
Arizona
California
Data in the stores7 Database

The following tables display the data in the stores7 database.
A-16
Pauli
Ludwig
Carole
Philip
Anthony
Raymond Vector
George
Charles
Donald
Jane
Roy
101
102
103
104
105
106
107
108
109
110
Margaret Lawson
Lana
Frank
112
113
114
address1
Sportstown
Runners & Others
Sports Center
AA Athletics
Sport Stuff
Quinns Sports
Athletic Supplies
Watson & Son
Los Altos Sports
Play Ball!
Phils Sports
Sports Spot
P. O. Box
3498
address2
CA
Palo Alto
CA
947 Waverly Place
654 Oak Grove
234 Wyandotte Way
3199 Sterling Court
520 Topaz Way
Mayfair Mart
587 Alvarado
41 Jordan Avenue
1143 Carver Place
1899 La Loma Drive
7345 Ross
Blvd.
CA
CA
CA
CA
CA
CA
CA
Redwood City CA
Menlo Park
Los Altos
Sunnyvale
Redwood City CA
Sunnyvale
Redwood City CA
Palo Alto
Mountain
View
Los Altos
94062
94025
94022
94085
94062
94086
94063
94304
94063
94022
94026
94303
94117
94086
(1 of 3)
415-886-6677
415-356-9982
415-887-7235
408-277-7245
415-743-3611
408-723-8789
415-544-8729
415-356-9876
415-389-8789
415-776-3249
415-368-1100
415-328-4543
415-822-1289
408-789-8075
state zipcode phone
San Francisco CA
Sunnyvale
city
East Shopping Cntr. 422 Bay Road Redwood City CA
654 Poplar
785 Geary St
All Sports Supplies 213 Erstwild Court
company
Albertson Sporting Place
Beatty
Frances
111
Keyes
Jaeger
Miller
Quinn
Ream
Watson
Higgins
Currie
Sadler
lname
customer_num fname
customer Table
A-17
A-18
Grant
Alfred
Jean
Arnold
Dick
Bob
Fred
Jason
Cathy
Marvin
Chris
James
Eileen
115
116
117
118
119
120
121
122
123
124
125
126
Gold Medal Sports
company

Neelie
Henry
Putnum
Hanlon
OBrian
Wallack
Jewell
Shorter
Baxter
Sipes
850 Lytton Court
1104 Spinosa Drive
776 Gary Avenue
address1
Neelies Discount
Sports
address2
4715 S.E. Adams

Blvd
2539 South Utica St
Suite 909C
10100 Bay Meadows Suite 1020

Rd
543 Nassau Street
Lake Biltmore Mall 350 W. 23rd

Street
6627 N. 17th Way
Total Fitness Sports 1450 Commonwealth Ave.
Putnums Putters
Bay Sports
The Sporting Life
City Sports
Century Pro Shop
The Triathletes Club 2405 Kings Highway
Blue Ribbon Sports 5427 College
Kids Korner
Parmelee Olympic City
lname
customer_num fname
CA
CA
Denver
Brighton
Bartlesville
Jacksonville
Princeton
Wilmington
Phoenix
Cherry Hill
Oakland
CO
MA
OK
FL
NJ
DE
AZ
NJ
CA
80219
02135
74006
32256
08540
19898
85016
08002
94609
94063
94040
94025
(2 of 3)
303-936-7731
617-232-4159
918-355-2074
904-823-4239
609-342-0054
302-366-7511
602-265-8754
609-663-6079
415-655-0011
415-245-4578
415-534-8822
415-356-1123
state zipcode phone
Redwood City CA
Mountain
View
Menlo Park
city
Satifer
Kim
Frank
127
128
Lessor
lname
customer_num fname
Blue Island Square
address1
Phoenix University Athletic Department
Big Blue Bike Shop
company
city
1817 N. Tho- Phoenix

mas Road
12222 Grego- Blue Island

ry Street
address2
AZ
NY
85008
60406
(3 of 3)
602-533-1817
312-944-5691
state zipcode phone
A-19

items Table
item_num
order_num
stock_num
manu_code
quantity
total_price
1001
HRO
250.00
1002
HSK
960.00
1002
HSK
240.00
1003
ANZ
20.00
1003
ANZ
840.00
1003
ANZ
99.00
1004
HRO
250.00
1004
HRO
126.00
1004
HSK
240.00
1004
HSK
800.00
1005
NRG
10
280.00
1005
ANZ
10
198.00
1005
SMT
36.00
1005
ANZ
48.00
1006
SMT
125.00
1006
NRG
140.00
1006
ANZ
99.00
1006
SMT
36.00
1006
ANZ
48.00
1007
HRO
250.00
1007
HRO
126.00
1007
HSK
240.00
1007
HRO
480.00
(1 of 3)
A-20
item_num
order_num
stock_num
manu_code
quantity
total_price
1007
HRO
600.00
1008
ANZ
840.00
1008
ANZ
100.00
1009
SMT
450.00
1010
SMT
36.00
1010
ANZ
48.00
1011
ANZ
99.00
1012
ANZ
840.00
1012
ANZ
10
200.00
1013
ANZ
19.80
1013
SMT
36.00
1013
ANZ
48.00
1013
ANZ
40.00
1014
HSK
960.00
1014
HRO
480.00
1015
SMT
450.00
1016
101
SHM
136.00
1016
109
PRC
90.00
1016
110
HSK
308.00
1016
114
PRC
120.00
1017
201
NKL
150.00
1017
202
KAR
230.00
1017
301
SHM
204.00
1018
307
PRC
500.00
(2 of 3)
A-21
item_num
order_num
stock_num
manu_code
quantity
total_price
1018
302
KAR
15.00
1018
110
PRC
236.00
1018
SMT
100.00
1018
304
HRO
280.00
1019
111
SHM
1499.97
1020
204
KAR
90.00
1020
301
KAR
348.00
1021
201
NKL
75.00
1021
201
ANZ
225.00
1021
202
KAR
690.00
1021
205
ANZ
624.00
1022
309
HRO
40.00
1022
303
PRC
96.00
1022
ANZ
96.00
1023
103
PRC
40.00
1023
104
PRC
116.00
1023
105
SHM
80.00
1023
110
SHM
228.00
1023
304
ANZ
170.00
1023
306
SHM
190.00
(3 of 3)
A-22
call_type Table
call_code
code_descr
billing error
damaged goods
incorrect merchandise sent
late shipment
other
A-23
A-24
05/21/1994
05/22/1994
05/22/1994
05/24/1994
05/30/1994
05/31/1994
06/07/1994
06/14/1994
06/17/1994
06/18/1994
06/18/1994
06/22/1994
06/25/1994
06/27/1994
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
110
106
104
117
104
115
111
110
117
112
116
106
104
101
104
05/20/1994
1001
closed Mondays
ring bell, kick door n

loudly
express
express
deliver 776 King St. n

if no answer
door next to
grocery
closed Monday
after 10AM
call before delivery n
ring bell twice
express
ship_date
05/26/1994 50.60
06/29/1994 40.60
06/21/1994 20.40
07/06/1994 45.60
06/05/1994 125.90
70.80
06/09/1994 80.80
05/30/1994 95.80
06/29/1994 70.80
07/03/1994 40.60
MA003 07/16/1994 20.60
8052
B77930 07/10/1994 60.80
278701
B77897 07/03/1994 10.40
429Q
4745
LZ230
278693
Q13557
2865
8006
B77890 05/23/1994 35.60
9270
6.30
12.30
12.20
14.20
5.00
12.30
10.00
13.80
25.20
14.20
16.20
19.20
10.80
15.30
10.00
(1 of 2)
08/31/1994
07/10/1994
07/31/1994
08/29/1994
08/22/1994
08/21/1994
07/21/1994
06/21/1994
06/14/1994
06/03/1994
07/22/1994
ship_weight ship_charge paid_date
B77836 06/01/1994 20.40
backlog po_num
PO on box; deliver n
back door only
express
customer_num ship_instruct
order_num order_date
orders Table
07/09/1994
07/10/1994
07/11/1994
07/11/1994
07/23/1994
07/24/1994
07/24/1994
1017
1018
1019
1020
1021
1022
1023
127
126
124
123
122
121
120
119
06/29/1994
1016
no deliveries after
3 p.m.
express
ask for Elaine
express
closed til noon

Mondays
SW corner of Biltmore Mall
ship_date
07/13/1994 70.50
07/30/1994 15.00
07/25/1994 40.00
07/16/1994 14.00
KF2961 07/30/1994 60.00
W9925
C3288
W2286
Z55709 07/16/1994 90.00
S22942
DM3543 07/13/1994 60.00

31
18.00
13.00
12.00
8.50
23.00
20.00
18.00
11.80
(2 of 2)
08/22/1994
09/02/1994
08/22/1994
09/20/1994
08/06/1994
08/06/1994
ship_weight ship_charge paid_date
PC6782 07/12/1994 35.00
backlog po_num
North side of club- n

house
delivery entrance
off Camp St.
customer_num ship_instruct
order_num order_date
A-25

stock Table
stock_num
manu_code
description
unit_price
unit
unit_descr
HRO
baseball gloves
250.00
case
10 gloves/case
HSK
baseball gloves
800.00
case
10 gloves/case
SMT
baseball gloves
450.00
case
10 gloves/case
HRO
baseball
126.00
case
24/case
HSK
baseball bat
240.00
case
12/case
SHM
baseball bat
280.00
case
12/case
HSK
football
960.00
case
24/case
HRO
football
480.00
case
24/case
NRG
tennis racquet
28.00
each
each
SMT
tennis racquet
25.00
each
each
ANZ
tennis racquet
19.80
each
each
SMT
tennis ball
36.00
case
24 cans/case
ANZ
tennis ball
48.00
case
24 cans/case
HRO
basketball
600.00
case
24/case
ANZ
volleyball
840.00
case
24/case
ANZ
volleyball net
20.00
each
each
101
PRC
bicycle tires
88.00
box
4/box
101
SHM
bicycle tires
68.00
box
4/box
102
SHM
bicycle brakes
220.00
case
4 sets/case
102
PRC
bicycle brakes
480.00
case
4 sets/case
103
PRC
front derailleur
20.00
each
each
104
PRC
rear derailleur
58.00
each
each
105
PRC
bicycle wheels
53.00
pair
pair
(1 of 4)
A-26
stock_num
manu_code
description
unit_price
unit
unit_descr
105
SHM
bicycle wheels
80.00
pair
pair
106
PRC
bicycle stem
23.00
each
each
107
PRC
bicycle saddle
70.00
pair
pair
108
SHM
crankset
45.00
each
each
109
PRC
pedal binding
30.00
case
6 pairs/case
109
SHM
pedal binding
200.00
case
4 pairs/case
110
PRC
helmet
236.00
case
4/case
110
ANZ
helmet
244.00
case
4/case
110
SHM
helmet
228.00
case
4/case
110
HRO
helmet
260.00
case
4/case
110
HSK
helmet
308.00
case
4/case
111
SHM
10-spd, assmbld 499.99
each
each
112
SHM
each
each
113
SHM
each
each
114
PRC
bicycle gloves
120.00
case
10 pairs/case
201
NKL
golf shoes
37.50
each
each
201
ANZ
golf shoes
75.00
each
each
201
KAR
golf shoes
90.00
each
each
202
NKL
metal woods
174.00
case
2 sets/case
202
KAR
std woods
230.00
case
2 sets/case
203
NKL
irons/wedges
670.00
case
2 sets/case
204
KAR
putter
45.00
each
each
205
NKL
3 golf balls
312.00
case
24/case
205
ANZ
3 golf balls
312.00
case
24/case
(2 of 4)
A-27
stock_num
manu_code
description
unit_price
unit
unit_descr
205
HRO
3 golf balls
312.00
case
24/case
301
NKL
running shoes
97.00
each
each
301
HRO
running shoes
42.50
each
each
301
SHM
running shoes
102.00
each
each
301
PRC
running shoes
75.00
each
each
301
KAR
running shoes
87.00
each
each
301
ANZ
running shoes
95.00
each
each
302
HRO
ice pack
4.50
each
each
302
KAR
ice pack
5.00
each
each
303
PRC
socks
48.00
box
24 pairs/box
303
KAR
socks
36.00
box
24 pair/box
304
ANZ
watch
170.00
box
10/box
304
HRO
watch
280.00
box
10/box
305
HRO
first-aid kit
48.00
case
4/case
306
PRC
tandem adapter
160.00
each
each
306
SHM
tandem adapter
190.00
each
each
307
PRC
infant jogger
250.00
each
each
308
PRC
twin jogger
280.00
each
each
309
HRO
ear drops
40.00
case
20/case
309
SHM
ear drops
40.00
case
20/case
310
SHM
kick board
80.00
case
10/case
310
ANZ
kick board
89.00
case
12/case
311
SHM
water gloves
48.00
box
4 pairs/box
312
SHM
racer goggles
96.00
box
12/box
(3 of 4)
A-28
stock_num
manu_code
description
unit_price
unit
unit_descr
312
HRO
racer goggles
72.00
box
12/box
313
SHM
swim cap
72.00
box
12/box
313
ANZ
swim cap
60.00
box
12/box
(4 of 4)
A-29
A-30

1
1
2
3
3
4
4
10002
10003
10004
10005
10006
10007
10008
HRO
HSK
SHM
HSK
HRO
SMT
HSK
HRO
10001
NFL-Style pigskin.
Norm Van Brocklin signature style.
Aluminum. Blue with black tape. 31",

20 oz or 22 oz; 32", 21 oz or 23 oz; 33",
22 oz or 24 oz.
Pro-style wood. Available in sizes: 31,

32, 33, 34, 35.
Jackie Robinson signature glove.

Highest Professional quality, used by
National League.
Catchers mitt. Brown leather.

Specify right- or left-handed.
Babe Ruth signature glove. Black

leather. Infield/outfield style. Specify
right- or left-handed.
Brown leather. Specify first basemans or infield/outfield style.

Specify right- or left-handed.
manu_code cat_descr
catalog_num stock_num
catalog Table
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
cat_picture
(1 of 12)
Highest Quality Football for High

School and Collegiate
Competitions
Quality Pigskin with Norm Van

Brocklin Signature
Durable Aluminum for High

School and Collegiate Athletes
High-Technology Design Expands the Sweet Spot
Highest Quality Ball Available,

from the Hand-Stitching to the
Robinson Signature
A Sturdy Catchers Mitt With the

Perfect Pocket
All-Leather, Hand-Stitched,
Deep-Pockets, Sturdy Webbing
that Wont Let Go
Your First Seasons Baseball

Glove
cat_advert
6
6
7
8
10012
10013
10014
10015
9
10011
10016
10010
ANZ
ANZ
HRO
ANZ
SMT
ANZ
SMT
NRG
10009
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
cat_picture
Steel eyelets. Nylon cording. Double- <BYTE value>

stitched. Sanctioned by the National
Athletic Congress.
Indoor. Finest leather. Professional

quality.
Indoor. Classic NBA style. Brown

leather.
Pro-core. Available in neon yellow,

green, and pink.
Soft yellow color for easy visibility in

sunlight or artificial light.
Wood frame, cat-gut strings.
Aluminum frame. Synthetic strings.
Graphite frame. Synthetic strings.
manu_code cat_descr
(2 of 12)
Sanctioned Volleyball Netting

for Indoor Professional and
Collegiate Competition
Professional Volleyballs for

Indoor Competitions
Long-Life Basketballs for Indoor

Gymnasiums
Durable Construction Coupled

with the Brightest Colors
Available
High-Visibility Tennis, Day or

Night
Antique Replica of Classic Wooden Racquet Built with Cat-Gut

Strings
Mid-Sized Racquet For the

Improving Player
Wide Body Amplifies Your Natural Abilities by Providing More

Power Through Aerodynamic
Design
cat_advert
A-31
A-32

101
102
102
103
104
10018
10019
10020
10021
10022
PRC
PRC
PRC
SHM
SHM
PRC
101
10017
<BYTE value>
<BYTE value>
cat_picture
<BYTE value>
<BYTE value>
Floating trapezoid geometry with ex- <BYTE value>

tra thick parallelogram arms. 100tooth capacity. Optimum alignment
with any freewheel.
Compact leading-action design

enhances shifting. Deep cage for super-small granny gears. Extra strong
construction to resist off-road abuse.
Computer-aided design with lowprofile pads. Cold-forged alloy calipers and beefy caliper bushing. Aero
levers. Set includes calipers, levers,
and cables.
Thrust bearing and coated pivot

<BYTE value>
washer/ spring sleeve for smooth action. Slotted levers with soft gum
hoods. Two-tone paint treatment. Set
includes calipers, levers, and cables.
Durable nylon casing with butyl tube

for superior air retention. Centerribbed tread with herringbone side.
Coated sidewalls resist abrasion.
Reinforced, hand-finished tubular.

Polyurethane belted. Effective
against punctures. Mixed tread for
super wear and road grip.
manu_code cat_descr
(3 of 12)
Computer-Aided Design Engineers 100-Tooth Capacity Into

ProCycles Rear Derailleur
Climb Any Mountain: ProCycles

Front Derailleur Adds Finesse to
Your ATB
Computer Design Delivers Rigid

Yet Vibration-Free Brakes
Thrust-Bearing and SpringSleeve Brake Set Guarantees

Smooth Action
The Perfect Tire for Club Rides or

Training
Ultimate in Puncture Protection,

Tires Designed for In-City Riding
cat_advert
107
108
10026
10027
109
106
10025
10028
105
10024
PRC
SHM
PRC
PRC
SHM
PRC
105
10023
<BYTE value>
cat_picture
Steel toe clips with nylon strap. Extra

wide at buckle to reduce pressure.
Double or triple crankset with choice

of chainrings. For double crankset,
chainrings from 38-54 teeth. For triple crankset, chainrings from 24-48
teeth.
Available in three styles: Mens

racing; Mens touring; and Womens.
Anatomical gel construction with
lycra cover. Black or black/hot pink.
Hard anodized alloy with pearl

finish. 6mm hex bolt hardware.
Available in lengths of 90-140mm in
10mm increments.
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
Polished alloy. Sealed-bearing, quick- <BYTE value>

release hubs. Double-butted. Front
wheels are laced 15g/2-cross. Rear
wheels are laced 15g/3-cross.
Front wheels laced with 15g spokes

in a 3-cross pattern. Rear wheels
laced with 14g spikes in a 3-cross
pattern.
manu_code cat_descr
(4 of 12)
Classic Toeclip Improved To

Prevent Soreness At Clip Buckle
Customize Your Mountain Bike

With Extra-Durable Crankset
The Ultimate In Riding Comfort,

Lightweight With Anatomical
Support
ProCycle Stem with Pearl Finish
Extra Lightweight Wheels for

Training or High-Performance
Touring
Durable Training Wheels That

Hold True Under Toughest
Conditions
cat_advert
A-33
A-34

110
110
110
110
10030
10031
10032
10033
HRO
SHM
ANZ
PRC
SHM
109
10029
Newest ultralight helmet uses plastic

shell. Largest ventilation channels of
any helmet on the market. 8.5 oz.
Dense outer layer combines with

softer inner layer to eliminate the
mesh cover, no snagging on brush.
Meets both ANSI and Snell standards
for impact protection. 8.0 oz.
No buckle so no plastic touches your

chin. Meets both ANSI and Snell
standards for impact protection. 7.5
oz. Lycra cover.
Super-lightweight. Meets both ANSI

and Snell standards for impact protection. 7.5 oz. Quick-release shadow
buckle.
Ingenious new design combines

button on sole of shoe with slot on a
pedal plate to give riders new options in riding efficiency. Choose full
or partial locking. Four plates mean
both top and bottom of pedals are
slottedno fishing around when you
want to engage full power. Fast
unlocking ensures safety when
maneuverability is paramount.
manu_code cat_descr
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
cat_picture
(5 of 12)
Lightweight Plastic with Vents

Assures Cool Comfort Without
Sacrificing Protection
Mountain Bike Helmet: Smooth

Cover Eliminates the Worry of
Brush Snags But Delivers
Maximum Protection
Minimum Chin Contact, FeatherLight, Maximum Protection Helmet
Feather-Light, Quick-Release,
Maximum Protection Helmet
Ingenious Pedal/Clip Design

Delivers Maximum Power And
Fast Unlocking
cat_advert
113
10037
114
112
10036
10038
111
10035
PRC
SHM
SHM
SHM
HSK
110
10034
cat_picture
Padded leather palm and stretch

mesh merged with terry back; Available in tan, black, and cream. Sizes S,
M, L, XL.
Ultra-lightweight. Racing frame

geometry built for aerodynamic
handlebars. Cantilever brakes. Index
shifting. High-performance gearing.
Quick-release hubs. Disk wheels.
Bladed spokes.
Created for the beginner enthusiast.

Ideal for club rides and light touring.
Sophisticated triple-butted frame
construction. Precise index shifting.
28 lbs.
Light-action shifting 10 speed.

Designed for the city commuter with
shock-absorbing front fork and
drilled eyelets for carry-all racks or
bicycle trailers. Internal wiring for
generator lights. 33 lbs.
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
Aerodynamic (teardrop) helmet

<BYTE value>
covered with anti-drag fabric. Credited with shaving 2 seconds/mile from
winners time in Tour de France
time-trial. 7.5 oz.
manu_code cat_descr
(6 of 12)
Riding Gloves For Comfort and

Protection
Designed for the Serious Competitor, The Complete Racing

Machine
We Selected the Ideal Combination of Touring Bike Equipment,

Then Turned It Into This Package
Deal: High-Performance on the
Roads, Maximum Pleasure
Everywhere
Fully Equipped Bicycle Designed

for the Serious Commuter Who
Mixes Business With Pleasure
Teardrop Design Used by Yellow

Jerseys, You Can Time the
Difference
cat_advert
A-35
A-36

201
201
202
202
203
204
205
10040
10041
10042
10043
10044
10045
10046
NKL
KAR
NKL
KAR
NKL
KAR
ANZ
NKL
201
10039
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
cat_picture
Fluorescent yellow.
Ideally balanced for optimum

control. Nylon-covered shaft.
Set of eight irons includes 3 through

9 irons and pitching wedge.
Originally priced at $489.00.
<BYTE value>
<BYTE value>
<BYTE value>
Full set of woods designed for preci- <BYTE value>

sion control and power performance.
Complete starter set utilizes gold

shafts. Balanced for power.
Leather and leather mesh for maximum ventilation. Waterproof lining

to keep feet dry. Available in white &
gray or white & ivory. Specify size.
Guaranteed waterproof. Full leather

upper. Available in white, bone,
brown, green, and blue. Specify size.
Designed for comfort and stability.

Available in white & blue or white &
brown. Specify size.
manu_code cat_descr
Long Drive Golf Balls:

Fluorescent Yellow
(7 of 12)
High-Quality Beginning Set of

Irons Appropriate for High
School Competitions
Set of Irons Available From

Factory at Tremendous Savings:
Discontinued Line
High-Quality Woods Appropriate for High School Competitions

or Serious Amateurs
Starter Set of Woods, Ideal for

High School and Collegiate
Classes
Karstens Top Quality Shoe

Combines Leather and Leather
Mesh
Waterproof Protection Ensures

Maximum Comfort and
Durability In All Climates
Full-Comfort, Long-Wearing Golf

Shoes for Men and Women
cat_advert
301
301
10050
10051
301
301
10049
10052
205
10048
PRC
SHM
HRO
NKL
HRO
ANZ
205
10047
Supportive, stable racing flat. Plenty

of forefoot cushioning with added
motion control. Womens only. D
widths available. Specify size.
For runners who log heavy miles and

need a durable, supportive, stable
platform. Mesh/synthetic upper
gives excellent moisture dissipation.
Stability system uses rear antipronation platform and forefoot control
plate for extended protection during
high-intensity training. Specify
mens/womens size.
Engineered for serious training with

exceptional stability. Fabulous shock
absorption. Great durability. Specify
mens/womens, size.
Super shock-absorbing gel pads

disperse vertical energy into a horizontal plane for extraordinary
cushioned comfort. Great motion
control. Mens only. Specify size.
Combination fluorescent yellow and

standard white.
White only.
manu_code cat_descr
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
cat_picture
(8 of 12)
A Womans Racing Flat That

Combines Extra Forefoot
Protection With a Slender Heel
The Training Shoe Engineered for

Marathoners and Ultra-Distance
Runners
Pronators and Supinators Take

Heart: A Serious Training Shoe
For Runners Who Need Motion
Control
Maximum Protection For HighMileage Runners
HiFlier Golf Balls: Case Includes

Fluorescent Yellow and Standard
White
Long Drive Golf Balls: White
cat_advert
A-37
A-38

301
302
303
303
10054
10055
10056
10057
KAR
PRC
KAR
ANZ
KAR
301
10053
100% nylon blend for optimal

wicking and comfort. Weve taken
out the cotton to eliminate the risk of
blisters and reduce the opportunity
for infection. Specify mens or
womens.
Neon nylon. Perfect for running or

aerobics. Indicate color: Fluorescent
pink, yellow, green, and orange.
Reusable ice pack with velcro strap.

For general use. Velcro strap allows
easy application to arms or legs.
Cantilever sole provides shock absorption and energy rebound. Positive traction shoe with ample toe box.
Ideal for runners who need a wide
shoe. Available in mens and womens. Specify size.
Anatomical last holds your foot

firmly in place. Feather-weight
cushioning delivers the responsiveness of a racing flat. Specify
mens/womens size.
manu_code cat_descr
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
cat_picture
(9 of 12)
100% Nylon Blend Socks - No

Cotton
Knock Their Socks Off With

YOUR Socks
Finally, An Ice Pack for Achilles

Injuries and Shin Splints that You
Can Take to the Office
Motion Control, Protection, and

Extra Toebox Room
Durable Training Flat That Can

Carry You Through Marathon
Miles
cat_advert
308
306
10062
10064
306
10061
307
305
10060
10063
304
10059
PRC
PRC
SHM
PRC
HRO
HRO
ANZ
304
10058
Allows mom or dad to take both

children! Rated for children up to 18
pounds.
Allows mom or dad to take the baby

out too. Fits children up to 21
pounds. Navy blue with black trim.
Converts a standard tandem bike

into an adult/child bike. Lightweight
model.
Converts a standard tandem bike

into an adult/child bike. User-tested
assembly instructions
Contains ace bandage, anti-bacterial

cream, alcohol cleansing pads, adhesive bandages of assorted sizes, and
instant-cold pack.
Split timer, waterproof to 50m. Indicate color: Hot pink, mint green,
space black.
Provides time, date, dual display of

lap/cumulative splits, 4-lap memory,
10 hr count-down timer, event timer,
alarm, hour chime, waterproof to
50m, velcro band.
manu_code cat_descr
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
cat_picture
(10 of 12)
As Your Family Grows, Infant

Jogger Grows With You
Infant Jogger Keeps A Running

Family Together
Consider a Touring Vacation For

the Entire Family: A Lightweight,
Touring Tandem for Parent and
Child
Enjoy Bicycling With Your Child

On a Tandem; Make Your Family
Outing Safer
Comprehensive First-Aid Kit

Essential for Team Practices,
Team Traveling
Waterproof Triathlete Watch In

Competition Colors
Athletic Watch w/4-Lap Memory
cat_advert
A-39
A-40
309
310
310
311
312
312
313
314
10066
10067
10068
10069
10070
10071
10072
10073
ANZ
SHM
HRO
SHM
SHM
ANZ
SHM
SHM
HRO
309
10065
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
cat_picture
Silicone swim cap. Squared-off top.

One size. White
Silicone swim cap. One size. Available in white, silver, or navy. Team
Logo Imprinting Available.
Durable competition-style goggles.

Available in blue, grey, or white.
Hydrodynamic egg-shaped lens.

Ground-in anti-fog elements; Available in blue or smoke.
<BYTE value>
<BYTE value>
<BYTE value>
<BYTE value>
Swim gloves. Webbing between

<BYTE value>
fingers promotes strengthening of
arms. Cannot be used in competition.
White. Standard size.
Blue heavy-duty foam board with

Shimara or team logo.
Extra-gentle formula. Can be used

every day for prevention or
treatment of swimmers ear.
Prevents swimmers ear.
manu_code cat_descr
(11 of 12)
Durable Squared-off Silicone

Swim Cap
Team Logo Silicone Swim Cap
Swim Goggles: Traditional

Rounded Lens For Greater
Comfort
Anti-Fog Swimmers Goggles:

Quantity Discount
Hot Training Tool - Webbed Swim

Gloves Build Arm Strength and
Endurance
High-Quality Kickboard
Exceptionally Durable, Compact

Kickboard for Team Practice
Swimmers Ear Drops Specially

Formulated for Children
Swimmers Can Prevent Ear Infection All Season Long
cat_advert
Re-usable ice pack. Store in the

freezer for instant first-aid. Extra
capacity to accommodate water and
ice.
HRO
10074
315
manu_code cat_descr
<BYTE value>
cat_picture
(12 of 12)
Water Compartment Combines

With Ice to Provide Optimal
Orthopedic Treatment
cat_advert
A-41
A-42

1994-07-01 15:00
1994-07-10 14:05
1994-07-31 14:30
119
121
127
maryj
maryj
richc
richc
1994-07-07 10:24
110
res_dtime
Received Hero watches

(item # 304) instead of
ANZ watches.
Customer likes our mer- 1994-07-10 14:06

chandise. Requests that
we stock more types of
infant joggers. Will call
back to place order.
Bill does not reflect cred- 1994-07-02 8:21

it from previous order.
Order placed one month 1994-07-07 10:30

ago (6/7) not received.
Order was received, but 1994-06-12 8:25

two of the cans of ANZ
tennis balls within the
case were empty.
maryj
1994-06-12 8:20
106
user_id call_code call_descr
customer_num call_dtime
cust_calls Table
(1 of 2)
Sent memo to shipping to send

ANZ item 304 to customer and
pickup HRO watches. Should be
done tomorrow, 8/1.
Sent note to marketing group of

interest in infant joggers.
Spoke with Jane Akant in Finance. She found the error and is
sending new bill to customer.
Checked with shipping (Ed

Smith). Order sent yesterday- we
were waiting for goods from
ANZ. Next time will call with
delay if necessary.
Authorized credit for two cans to

customer, issued apology. Called
ANZ buyer to report the QA
problem.
res_descr
mannyn
1993-12-21 11:24
116
res_dtime
Second complaint from 1993-12-27 08:19

this customer! Received
two cases right-handed
outfielder gloves
(1 HRO) instead of one
case lefties.
Received plain white

1993-11-28 16:47
swim caps (313 ANZ) instead of navy with team
logo (313 SHM).
mannyn
1993-11-28 13:34
116
user_id call_code call_descr
customer_num call_dtime
(2 of 2)
Memo to shipping (Ava Brown) to

send case of left-handed gloves,
pick up wrong case; memo to billing requesting 5% discount to placate customer due to second
offense and lateness of resolution
because of holiday.
Shipping found correct case in

warehouse and express mailed it
in time for swim meet.
res_descr
A-43

manufact Table
manu_code
manu_name
lead_time
ANZ
Anza
HSK
Husky
HRO
Hero
NRG
Norge
SMT
Smith
SHM
Shimara
30
KAR
Karsten
21
NKL
Nikolus
PRC
ProCycle
state Table
code
sname
code
sname
AK
Alaska
MT
Montana
AL
Alabama
NE
Nebraska
AR
Arkansas
NC
North Carolina
AZ
Arizona
ND
North Dakota
CA
California
NH
New Hampshire
CT
Connecticut
NJ
New Jersey
CO
Colorado
NM
New Mexico
DC
D.C.
NV
Nevada
DE
Delaware
NY
New York
FL
Florida
OH
Ohio
(1 of 2)
A-44
code
sname
code
sname
GA
Georgia
OK
Oklahoma
HI
Hawaii
OR
Oregon
IA
Iowa
PA
Pennsylvania
ID
Idaho
PR
Puerto Rico
IL
Illinois
RI
Rhode Island
IN
Indiana
SC
South Carolina
KY
Kentucky
TN
Tennessee
LA
Louisiana
TX
Texas
MA
Massachusetts
UT
Utah
MD
Maryland
VA
Virginia
ME
Maine
VT
Vermont
MI
Michigan
WA
Washington
MN
Minnesota
WI
Wisconsin
MO
Missouri
WV
West Virginia
MS
Mississippi
WY
Wyoming
(2 of 2)
A-45
Glossary
Glossary
access method
A procedure that is used to retrieve rows from or insert

rows into a storage location. In the SET EXPLAIN statement, access method refers to the type of table access in
a query (for example, SEQUENTIAL SCAN as opposed
to INDEX PATH).
access
privileges
The types of operations that a user has permission to

perform in a specific database, table, or column. Informix maintains its own set of database and table access
privileges, which are independent of the operating system access privileges for operating system files.
active set
The collection of rows that satisfies a query associated

with a cursor.
aggregate
functions
The functions that return a single value based on the

values of columns in one or more rows of a table (for
example, the total number, sum, average, and maximum or minimum of an expression in a query or
report). Aggregate functions are sometimes referred to
as set functions or math functions.
alias
A temporary alternative name for a table in a query;

usually used in complex subqueries and required for
self-joins. In a form-specification file or any SQL query,
alias refers to a single-word alternative name used in
place of a more complex table name (for example, t1 as
an alias for owner.table_name).
ANSI
ANSIcompliant
Refers to a database that conforms to certain ANSI performance standards. Informix databases can be created
either as ANSI-compliant or not ANSI-compliant. An
ANSI-compliant database enforces certain ANSI requirements, such as implicit transactions, required ownernaming, and unbuffered logging (unbuffered logging
only when using INFORMIX-OnLine Dynamic Server), that
are not enforced in databases that are not
ANSI-compliant.
application
development
tool
Software, such as INFORMIX-4GL, that you can use to create and maintain a database. The software allows a user to
send instructions and data to and receive information
from the database server.
application
process
The process that manages an ESQL, 4GL, or other program

at run time. It executes the program logic and initiates
SQL requests. Memory that is allocated for program variables, program data, and the fetch buffer is part of this
process. See also database server process.
application
program
An executable file or logically related set of files that

perform one or more database management tasks.
arbitrary rule
Acronym for the American National Standards Institute.

This group sets standards in many areas, including the
computer industry and standards for SQL languages.
A series of expressions that you define using SQL

relational and logical operators. Unlike the range rule, the
arbitrary rule allows you to use any relational operator
and any logical operator to define the expressions.
Typically includes the use of the OR logical operator to
group data.
archiving
Copying all the data and indexes of a database onto a new

medium, usually a tape or a different physical device
from the one that stores the database. Archiving is used
for recovering from a failure and is usually performed by
a database administrator. See backup.
argument
A value passed to a function, routine, stored procedure,

or command.
array
A set of items of the same type. Individual members of

the array are referred to as elements and are usually distinguished by an integer argument that gives the position of
the element in the array. Informix arrays can have up to
three dimensions.
attached index
An index that is created without a fragmentation strategy.

An attached index can also be an index created on a
fragmented table.
audit event
Any OnLine activity or operation that could potentially

access and alter data, which should be recorded and monitored by the OnLine secure auditing facility. Examples of
audit events include accessing tables, altering indexes,
dropping chunks, granting database access, updating the
current row, running OnLine utilities, and so on. (For a
complete list of audit events, see Appendix A in the
INFORMIX-OnLine Dynamic Server Trusted Facility Manual.)
audit file
A file that contains records of audit events and resides in

the specified audit directory. Audit files form an audit
trail of information that can be extracted by the OnLine
secure auditing facility for analysis by the OnLine
administrator.
Glossary
audit mask
A structure that specifies which events should be audited

by (or excluded from auditing by) the OnLine secure
auditing facility.
audit trail
A history of all changes to a table in SE database servers.
audit trail log
A file that contains a history of all changes to a table.

Starting from an archived database, an audit trail log can
reconstruct all subsequent changes to the table in
INFORMIX-SE database servers.
auxiliary
statements
The SQL statements that you use to obtain auxiliary

information about tables and databases. These statements
include INFO, OUTPUT, WHENEVER, and GET
DIAGNOSTICS.
B+ tree
A method of organizing an index into a binary tree for

efficient record retrieval.
backup
To make a duplicate of a computer file on another device

or tape to preserve existing work, in case of a computer
failure or other mishap. In INFORMIX-OnLine Dynamic
Server, backup refers to duplicating logical log files and
archiving refers to duplicating data.
before-image
blobpage
The image of a row, page, or other item before any

changes are made to it.
The unit of disk allocation within a blobspace under
INFORMIX-OnLine Dynamic Server. The OnLine
administrator determines the size of a blobpage; the size
can vary from blobspace to blobspace.
blobs
Acronym for binary large objects. Blobs are data objects

that effectively have no maximum size (theoretically as
large as 231 bytes).
blobspace
A logical collection of chunks that is used to store TEXT

and BYTE data in INFORMIX-OnLine Dynamic Server.
buffer
A portion of computer memory where a program

temporarily stores data. Data typically is read into or
written out from buffers to disk.
buffered
logging
A type of logging that holds transactions in a memory

buffer until the buffer is full, regardless of when the transaction is committed or rolled back. INFORMIX-OnLine
Dynamic Server provides this option to speed up
operations by reducing the number of disk writes.
byte
A unit of storage that corresponds approximately to one

character. It is the smallest addressable computer memory
unit. A kilobyte is 1,024 bytes. A megabyte is 106 bytes. A
byte is also known as an octet. (When BYTE appears in
uppercase letters, it refers to the Informix data type.)
callback
function
A user-defined function called during execution of an SQL

request.
Cartesian
product
The set that results when you pair each and every
member of one set with each and every member of
another set. A Cartesian product results from a
multiple-table query when you do not specify the joining
conditions among tables. See join.
Glossary
cascading
deletes
Defines the delete action on referencing columns (foreign

key) in a referential constraint. When defined on the referencing columns with the CREATE TABLE or ALTER TABLE
statements, deletes from the referenced columns cascade
to the referencing columns.
casesensitivity
The condition of distinguishing between uppercase and

lowercase letters. Be careful running Informix programs
because certain commands and their options are case-sensitive; that is, they react differently to the same letters presented in uppercase and lowercase characters.
character
A logical unit of storage for the value code in a code set. It

can be represented by one or more bytes and can be
diacritic or alphabetic.
check
constraint
A condition that must be met before data can be assigned

to a table column during an INSERT or UPDATE statement.
Check constraints are defined using search conditions.
checkpoint
A point in time during an INFORMIX-OnLine Dynamic

Server operation when the pages on disk are synchronized with the pages in the shared-memory buffer pool.
Checkpoints are marked by a special record written into
the logical log.
child table
The referencing table in a referential constraint. See parent

table.
chunk
client
A large continuous section of disk space for OnLine. A

chunk can correspond to a UNIX disk partition. A specified set of chunks defines a dbspace or blobspace.
An application program that requests services from a
server program, typically a file server or a database
server.
client/server
architecture
A hardware and software design that allows the user

interface and database server to reside on separate nodes
or platforms on a single computer or over a network.
client/server
connection
statements
The SQL statements that you use to make connections

with databases. These statements include CONNECT,
DISCONNECT, and SET CONNECTION.
client/server
processing
A function that allows an application to run on multiple

computers across a network using the processing power
of the computers involved.
close a cursor
close a
database
To drop the association between the active set of rows

resulting from a query and a cursor.
To relinquish the current status of a database. Only one
current database can exist at a time.
close a file
To release the association between a file and a program.
cluster an
index
To rearrange the physical data of a table according to a

specific index.
cluster key
The column in a table that logically relates a group of

blobs stored in an optical cluster.
clustersize
The amount of space, specified in kilobytes, that is

allocated to an optical cluster on an optical volume.
code set
The representation of a national character set where each

code value has a one-to-one mapping with a character
graphic.
Glossary
collating
sequence
column
A data element containing a particular type of

information that occurs in every row of the table; also
known as a field.
command file
A system file that contains one or more statements or

commands, such as SQL statements.
comment
The information in a program file that is not processed by

the computer but documents the program. You use
special characters, such as a pound sign ( # ), curly braces
( { } ), slash marks (/) and asterisks ( * ), or a double dash
( -- ) to identify comments, depending on the programming environment.
COMMIT
WORK
To terminate a transaction by accepting all changes to the

database since the beginning of the transaction.
COMMITTED
READ
An Informix level of isolation available through

INFORMIX-OnLine Dynamic Server and set with the SET
ISOLATION statement in which a user can view only rows
that are currently committed at the moment of the query
request; that is, a user cannot view rows that were
changed as a part of a currently uncommitted transaction.
It is the default level of isolation under OnLine for
databases that are not ANSI-compliant. See isolation.
compile
The sequence of values or codes that specifies some

logical order in which the character fields in a database
are sorted and indexed. It may involve dictionary ordering or character ordering of data. Collating sequence is
also known as collation order.
To translate a file that contains instructions (in a

higher-level language) into a file containing the
corresponding machine-level instructions.
compile-time
errors
The errors that occur at the time the program source code
is converted to executable form. Compare with run-time
errors.
composite
index
An index constructed on two or more columns of a table.

The ordering imposed by the composite index varies least
frequently on the first-named column and most
frequently on the last-named column.
composite join
concatenate
concatenation
operator
concurrency
A join between two tables based on the relationship

among two or more columns in each table. See join.
To append a second string to the end of a first string.
A symbolic notation composed of two pipe symbols (||)
used in expressions to indicate the joining of two strings.
The ability of two or more processes to access the same
database simultaneously.
configuration
file
A file read during INFORMIX-OnLine Dynamic Server disk

or shared-memory initialization that contains the parameters that specify values for configurable behavior. OnLine
and its archiving tool, ON-Archive, use configuration
files.
connection
An association between an application and a database

environment, created by a CONNECT or DATABASE
statement. Database servers can also have connections to
one another. See also explicit connection, implicit connection.
constant
A nonvarying data element or value.
Glossary
constraint
control
character
correlation
name
A character whose occurrence in a particular context

initiates, modifies, or stops a control function (an
operation to control a device, for example, in moving a
cursor or in reading data). In a program, you can define
actions that use the CTRL key with another key to execute
some programming action (for example, entering CTRL-W
to obtain on-line Help in Informix products). A control
character is sometimes referred to as a control key.
Compare to printable character.
The prefix that you can use with a column name in a
triggered action to refer to an old (before triggering
statement) or a new (after triggering statement) column
value. The associated column name must belong to the
triggering table.
corrupted
database
A database whose tables or indexes contain incomplete or

invalid data.
corrupted
index
An index that does not correspond exactly to its table.
current row
10
A restriction on what kinds of data can be inserted or

updated in tables. See also check constraint, primary-key
constraint, referential constraint, and unique constraint.
The most recently retrieved row of the active set of a

query.
cursor
An identifier associated with a group of rows;

conceptually, the pointer to the current row. You can use
cursors for SELECT statements or EXECUTE PROCEDURE
statements (associating the cursor with the rows returned
by a query) or INSERT statements (associating the cursor
with a buffer to insert multiple rows as a group). A select
cursor is declared for sequential only (regular cursor) or
nonsequential (scroll cursor) retrieval of row information.
In addition, you can declare a select cursor for update
(initiating locking control for updated and deleted rows)
or with hold (completing a transaction does not close the
cursor). In ESQL/C and ESQL/COBOL, a cursor can be
dynamic, meaning that it can be an identifier or a
character/string variable.
cursor
manipulation
statements
The SQL statements that control cursors; specifically, the

CLOSE, DECLARE, FETCH, FLUSH, OPEN, and PUT
statements.
CURSOR
STABILITY
An Informix level of isolation available through OnLine

and set with the SET ISOLATION statement in which the
database server must secure a shared lock on a fetched
row before the row can be viewed. The database server
retains the lock until it receives a request to fetch a new
row. See isolation.
data access
statements
The SQL statements that you use to grant and revoke

permissions and to lock tables.
data definition
statements
The SQL statements that you use to create, alter, drop, and
rename data objects, including databases, tables, views,
synonyms, triggers, and procedures.
data dictionary
The collection of tables that keeps track of the structure of

the database. Information about the database is
maintained in the data dictionary, which is also referred
to as the system catalog. See system catalog.
Glossary
11
data integrity
The process of ensuring that data corruption does not

occur when multiple users simultaneously try to alter the
same data. Locking and transaction processing are used
to control data integrity.
data integrity
statements
The SQL statements that you use to control transactions

and audits. Data integrity statements also include
statements for repairing and recovering tables.
data
manipulation
statements
The SQL statements that you use to query tables, insert

into tables, delete from tables, update tables, and load
into and unload from tables.
data
replication
data restriction
Synonym for constraint. See constraint.
data type
A descriptor assigned to each column in a table or

program variable, which indicates the type of data the
column or program variable is intended to hold. Informix
data types include SMALLINT, INTEGER, SERIAL,
SMALLFLOAT, FLOAT, DECIMAL, MONEY, DATE,
DATETIME, INTERVAL, CHAR, VARCHAR, TEXT, and
BYTE. When NLS is enabled, Informix data types include
NCHAR and NVARCHAR.
database
A collection of information (contained in tables) that is

useful to a particular organization or used for a specific
purpose.
Database
Administrator
12
When database objects have more than one representation

at more than one distinct site. INFORMIX-OnLine Dynamic
Server implements data replication at the level of
database servers.
See DBA.
database
application
A program that applies database management techniques

to implement specific data manipulation and reporting
tasks.
database
environment
Used in the CONNECT statement, either the database

server or the database server and database to which a
user connects.
database
management
system
See DBMS.
database
server process
The portion of the INFORMIX-SE database management

system that actually manipulates the database files. It
receives SQL statements from the application process,
parses them, optimizes the approach to data retrieval,
retrieves the database, and returns the data to the application. In the INFORMIX-OnLine Dynamic Server database
management system, these activities are distributed
among threads instead of using a single process. See
thread.
DBA
Acronym for Database Administrator. The DBA is the

individual who is responsible for the contents and use of
a database. This is different from the administrator of an
INFORMIX-OnLine Dynamic Server database server, who
is responsible for managing one or more OnLine database
servers.
DBAprivileged
DBMS
Refers to a class of stored procedures created only by a

user with DBA database privileges.
Acronym for database management system. It is all the
components necessary to create and maintain a database,
including the application development tools and the
database server.
Glossary
13
dbspace
DDL
Acronym for data definition language. See data definition

statements.
deadlock
A situation in which two or more threads cannot proceed

because each is waiting for data locked by the other (or
another) thread. INFORMIX-OnLine Dynamic Server
monitors and prevents potential deadlock situations by
sending an error message to the application whose
request for a lock may result in a deadlock.
debug file
A file that receives output used for debugging purposes.
decisionsupport
application
An application that provides information, which is used

for strategic planning, decision-making, and reporting. It
typically executes in a batch environment in a sequential
scan fashion and returns a large fraction of the rows
scanned. Decision-support queries typically scan the
entire database. See OLTP application.
decisionsupport query
A query that is generated by a decision-support

application. It often requires operations such as multiple
joins, temporary tables, and extensive calculations, and
can benefit significantly from PDQ. Compare with OLTP
query.
declaration
statement
14
A logical collection of one or more INFORMIX-OnLine

Dynamic Server chunks. Because chunks represent
specific regions of disk space, the creators of databases
and tables can control where their data is physically
located by placing databases or tables in specific
dbspaces.
A programming language statement that describes or

defines objects, for example, defining a program variable.
Compare to procedural statement.
default
How a program acts or the values that are assumed if the

user does not explicitly specify an action.
default value
A value inserted into a column or variable when an

explicit value is not specified. Default values can be
assigned to columns using the ALTER TABLE and CREATE
TABLE statements and to variables in stored procedures.
delete
To remove any row or combination of rows with the

DELETE statement.
delimited
identifier
An identifier surrounded by double quotes. The purpose

of a delimited identifier is to allow usage of identifiers
that are otherwise identical to SQL reserved keywords or
that contain non-alphabetical characters. See also
identifier.
delimiter
A boundary on an input field or the terminator for a

column or row. Some files and prepared objects require
semicolon ( ; ), comma ( , ), space, or tab delimiters
between statements.
descriptor
A quoted string or embedded variable name that

identifies an allocated system-descriptor area or an sqlda
structure. It is used for the Informix SQL APIs. See
identifier.
detached index
An index that is created with a fragmentation strategy or

with the IN dbspace storage option.
diagnostic area
A data structure that stores diagnostic information about

an executed SQL statement.
Glossary
15
DIRTY READ
disk
configuration
disk I/O
display label
The organization of data on a disk; also refers to the

process of preparing a disk to store data.
The process of transferring data between memory and
disk.
A temporary name for a column or expression in a query.
distributed
data
The ability to access data in multiple databases. The

databases can be on the same hardware or on a network.
(INFORMIX-OnLine Dynamic Server can perform
multiple-database queries.)
distribution
scheme
A method that OnLine uses to distribute rows or index

entries to fragments and in some cases, to reduce the
number of fragments that OnLine scans. In an expressionbased distribution scheme, you decide where a fragment
is to be stored in addition to providing a rule or algorithm
that OnLine uses to place the rows into the fragments.
DML
dominant
table
16
An Informix level of isolation set with the SET ISOLATION

statement that does not account for locks and allows
viewing of any existing rows, even rows that currently
can be altered from inside an uncommitted transaction.
DIRTY READ is the lowest level of isolation (no isolation at
all). It is the level at which INFORMIX-SE normally operates and it is an optional level under INFORMIX-OnLine
Dynamic Server. See isolation.
Acronym for data manipulation language. See data

manipulation statements.
See outer join.
dynamic
management
statements
The SQL statements that describe, execute, and prepare

statements.
dynamic SQL
The statements and structures that allow a program to

form an SQL statement during execution, so that portions
of the statement can be determined by user input.
dynamic
statements
The SQL statements that are created at the time the

program is executed, rather than when the program is
written. You use the PREPARE statement to create
dynamic statements.
embedded
The SQL statements that are placed within a host

language. Informix supports embedded SQL in C and
COBOL.
SQL
environment
variable
A variable that is maintained by the operating system for

each user and made available to all programs that the
user runs.
error message
A message that is displayed on the screen or written to a

file, describing either the failure of an action or an illegal
specification. Each error is identified by a (usually
negative) designated number.
error trapping
The code within a program that anticipates and reacts to

run-time errors.
escape
character
A character that indicates that the following character,

normally interpreted by the program, is to be printed as a
literal character instead. The escape character is used with
the interpreted character to escape or ignore the interpreted meaning.
Glossary
17
escape key
The keyboard key, usually marked ESC, that is used to

terminate one mode and start another mode in most UNIX
and DOS systems.
exception
An error or warning returned by the database server or a

state initiated by a stored procedure statement.
exclusive
access
When a user has sole access to a database or table and

other users are prevented from using it.
exclusive lock
A lock on an object (row, page, table, or database) that is

held by a single thread that prevents other processes from
acquiring a lock of any kind on the same object.
executable file
A binary file containing compiled code that can be run as

a program; can also refer to a UNIX shell script or a DOS
batch file.
execute
To carry out a program, procedure, or a set of instructions.
explicit
connection
exponent
expression
18
A connection made to a database environment that uses

the CONNECT statement.
The power to which a value is to be raised.
Anything from a simple numeric or alphabetic constant
to a more complex series of column values, functions,
quoted strings, operators, and keywords. A Boolean
expression contains a logical operator (>, <, =, !=,
IS NULL, and so on) and evaluates as TRUE, FALSE, or
UNKNOWN. An arithmetic expression contains the
operators (+, , , /, and so on) and evaluates as a
number.
expressionbased
distribution
scheme
User-defined distribution scheme created by formulating

a series of fragment expressions to be used by OnLine to
distribute rows to fragments.
extent
A continuous segment of disk space that is allocated to a

tblspace (a table) in INFORMIX-OnLine Dynamic Server.
The user can specify both the initial extent size for a table
and the size of all subsequent extents allocated to the
table.
external table
A database table that is not in the current database. It may

or may not be in a database managed by the same
database server.
family name
A quoted string constant that specifies a family name in

the optical family. See optical family.
fast recovery
An automatic, fault-tolerant feature that

INFORMIX-OnLine Dynamic Server implements any time
the operating mode changes from off-line to quiescent
mode. The aim of fast recovery is to return OnLine to a
state of physical and logical consistency with a minimal
loss of work in the event of a system failure.
fault tolerance
fetch
fetch buffer
field
See high availability.

The action of moving a cursor to a new row and
retrieving the row values into memory.
A buffer in the application process that the database
server uses to send fetched row data (except blob data) to
the application. See also application process.
See column.
Glossary
19
file
A collection of related information stored together on a

system, such as the words in a letter or report, a computer
program, or a listing of data.
file server
A network node that manages a set of disks and provides

storage services to computers on the network.
fixchar
A character data type, available in INFORMIX-ESQL/C

programs, in which the character string is fixed in length,
padded with blanks if necessary, and not null-terminated.
fixed-point
number
20
A number where the decimal point is fixed at a specific

place regardless of the value of the number.
filename
extension
The part of a filename following the period. For example,

DB-Access appends the extension .sql to command files.
flag
A command-line option, usually indicated by a minus ( - )

sign in UNIX systems. For example, in DB-Access the -e
flag echoes input to the screen.
floating-point
number
A number with fixed precision (total number of digits)

and undefined scale (number of digits to the left of the
decimal point). The decimal point floats as appropriate to
represent an assigned value.
forced
residency
An option that forces UNIX to keep the resident portion of

INFORMIX-OnLine Dynamic Server shared-memory
segments resident in memory, preventing UNIX from
swapping out these segments to disk. (This option is not
available on all UNIX systems.)
foreign key
fragment
fragment
expression
A column, or set of columns, that references a unique or

primary key in a table. For every entry in a foreign-key
column, there must exist a matching entry in the unique
or primary column, if all foreign-key columns contain
non-null values.
See index fragment and table fragment.
The individual expressions within a range, hash, or
arbitrary rule.
fragmentation
An OnLine feature that enables you to define groups of

rows within a table based on a rule. OnLine stores these
groups or fragments in separate dbspaces that you
specify when you create a table or index fragmentation
strategy.
fragmentation
strategy
Consists of a distribution scheme (round-robin or

expression), a rule or algorithm, and a location for the
fragments. The rule or algorithm is OnLine-defined for a
round robin-based distribution scheme and user defined
for an expression-based distribution scheme.
function
See program block.
gateway
A data communications device that establishes

communications between networks.
global variable
A variable whose value you can access from any module

or function in a program or stored procedure. See variable
and scope of reference.
Glossary
21
hash rule
A user-defined algorithm that maps each row in a table to

a set of integers called hash values. OnLine uses these values to determine in which fragment it will store a given
row. Hash rules are usually implemented using the MOD
function.
hierarchy
A treelike data structure in which some groups of data are

subordinate to others such that only one group (called
root) exists at the highest level, and each group except root
is related to only one parent group on a higher level.
high
availability
The ability of a system to resist failure and data loss. High

availability includes features such as fast recovery and
mirroring. It is sometimes referred to as fault tolerance.
highlight
22
An rectangular inverse-video area that marks your place

on the screen. A highlight often indicates the current
option on a menu or the current character in an editing
session. If a terminal cannot display highlighting, the
current option often appears in angle brackets, and the
current character is underlined.
hold cursor
A cursor that is created using the WITH HOLD keywords.

A hold cursor remains open past the end of a transaction.
It allows uninterrupted access to a set of rows across
multiple transactions.
home page
The page that contains the first byte of the data row. Even
if a data row outgrows its original storage location, the
home page does not change. The home page contains a
forward pointer to the new location of the data row. See
remainder page.
host variable
A C or COBOL program variable that is referenced in an

embedded statement. A host variable is identified by the
dollar sign ( $ ) or colon ( : ) that precedes it.
identifier
implicit
connection
incremental
archiving
index
A sequence of letters, digits, and underscores ( _ ) that

represents the name of a database, table, column, cursor,
function, index, synonym, alias, view, prepared object,
constraint, or procedure name. Identifiers for column and
tables names are limited to 18 characters.
A connection made using a database statement
(DATABASE, CREATE DATABASE, START DATABASE,
DROP DATABASE).
A system of archiving that allows the option to archive
only those parts of the data that have changed since the
last archive was created.
A structure of pointers that point to rows of data in a
table. An index optimizes the performance of database
queries by ordering rows to make access faster.
index
fragment
Consists of zero or more index items grouped together,

which can be stored in the same dbspace as the associated
table fragment or, if you choose, in a separate dbspace.
Informix user
A login user ID (login user name) that must be valid on all

computer systems (operating systems) involved in the
clients database access. Often referred to as the clients
user ID or user name. The user ID does not need to refer to
a fully functional user account on the computer system;
only the user identity components of the user account
information is significant to Informix database servers.
Any given user typically has the same Informix user ID on
all networked computer systems involved in the database
access.
ID
Glossary
23
Informix user
password
initialize
inmigration
input
input
parameter
insert cursor
24
A user ID password that must be valid on all computer

systems (operating systems) involved in the clients
database access. When the client specifies an explicit user
ID, most computer systems require the Informix user
password to validate the user ID.
To assign a starting value.
The process by which INFORMIX-OnLine/Optical
migrates a blob from the optical storage subsystem into
the INFORMIX-OnLine Dynamic Server environment.
The information that is received from an external source
(for example, from the keyboard, a file, or another
program) and processed by a program.
A placeholder within a prepared SQL statement that
indicates a value is to be provided at the time the
statement is executed.
A cursor for insert operations. Allows bulk insert data to
be buffered in memory and written to disk.
installation
The loading of software from some magnetic medium

(tape, cartridge, or floppy disk) onto a computer and
preparing it for use.
interactive
Refers to a program that accepts input from the user,

processes the input, and then produces output on the
screen, in a file, or on a printer.
interquery
parallelization
Occurs when OnLine processes multiple queries

simultaneously. A common bottleneck develops when
multiple, independent queries access the same table.
Fragmentation combined with interquery parallelization
can effectively eliminate this bottleneck. Compare this
definition with intraquery parallelization.
interrupt
A signal from a user or another process that can stop the

current process temporarily or permanently. See signal.
interrupt key
A key used to cancel or abort a program or to leave a

current menu and return to the menu one level above.
On many systems, the CONTROL-C keypress is used for
the interrupt key. On other systems, the interrupt key is
DEL or CONTROL-Break.
intraquery
parallelization
Occurs when OnLine breaks a single query using PDQ

into subqueries and then processes the subqueries in
parallel. Parallel processing of this type has important
implications when each subquery retrieves data from a
fragment of a table. Because each partial query operates
on a smaller amount of data, the retrieval time is
significantly reduced. Compare this definition with
interquery parallelization.
IPX/SPX
Acronym for Internetwork Packet Exchange/Sequenced

Packet Exchange. It refers to the NetWare network
protocol by Novell.
ISAM
ISAM error
Acronym for Indexed Sequential Access Method. An

indexed sequential access method allows you to find
information in a specific order or to find specific pieces of
information quickly through an index. See access method.
Operating system or file access error.
Glossary
25
ISO
26
Acronym for the International Standards Organization.

ISO sets worldwide standards for the computer industry,
including standards for character input and
manipulation, code sets, and SQL syntax.
isolation
The level of independence among multiple users when

they attempt to access common data, specifically relating
to the locking strategy for read-only SQL requests. The
various levels of isolation are distinguished primarily by
the length of time that shared locks are (or can be)
acquired and held. INFORMIX-SE sets a level of no isolation
(referred to as a DIRTY READ), which cannot be changed.
INFORMIX-OnLine Dynamic Server allows the programmer to choose from Informix levels of isolation or ANSI
levels of isolation. See the Informix levels of isolation:
DIRTY READ, COMMITTED READ, CURSOR STABILITY, and
REPEATABLE READ. See the ANSI levels of isolation: READ
UNCOMMITTED, READ COMMITTED, REPEATABLE READ,
SERIALIZABLE.
join
The process of combining information from two or more

tables based on some common domain of information.
Rows from one table are paired with rows from another
table when information in the corresponding rows match
on the joining criterion. For example, if a customer_num
column exists in the customer and the orders tables, you
can construct a query that pairs each customer row with
all the associated orders rows based on the common
customer_num. See Cartesian product and outer join.
jukebox
A cabinet that consists of one or more optical-disc drives,

slots that store optical platters when they are not
mounted, and a robotic arm that transfers platters
between the slots and the drives. A jukebox is also known
as an autochanger.
kernel
The part of the UNIX operating system that controls

processes and the allocation of resources.
key
The pieces of information that are used to locate a row of

data. A key defines the pieces of information you want to
search for, as well as the order in which you want to
process information in a table. For example, you can
index the last_name column in a customer table to find
specific customers or to process the customers in alphabetical or reverse alphabetical order, according to their
last names (last_name serves as the key).
keyword
A word that has meaning to a program. For example, the

word SELECT is a keyword in SQL.
language
supplement
The result of the product localization process. A language

supplement for a specific Western European language can
be installed with an Informix product to allow the user to
see error and warning messages in a language other than
U.S. English. If installed with DB-Access, the menu names
and options and on-line Help for that product also appear
in the specified language.
latch
A mechanism of shared-memory resource management

that is used by INFORMIX-OnLine Dynamic Server to coordinate processes (virtual processors) as they attempt to
modify entries in shared memory.
level of
isolation
library
See isolation.
A collection of precompiled functions or routines that are

designed to perform tasks, which are common to a
particular kind of application. Your product can include
library functions or routines that you can call from your
programs.
Glossary
27
link
literal
28
The process of combining separately compiled program

modules into an executable program.
A character or numeric constant.
local character
A character in a native language character set; also known

as a national character or a native character.
local loopback
A connection between the client and database server that

uses a network connection even though the client and the
database servers are on the same computer.
local variable
A variable that has meaning only in the module in which

it is defined. See variable and scope of reference.
locale
The environment that defines the behavior of the

program at run time by specifying a language, code set,
and local customs. It usually is based on the linguistic
customs and rules of the region or territory. The locale can
be expressed through an environment variable setting
that dictates output formats for numbers, currency
symbols, dates, and time or collation order for character
strings and regular expressions.
lock mode
An option that describes whether a user who requests a

lock on an already locked object is to not wait for the lock
and instead receive an error, wait until the object is
released to receive the lock, or wait a certain amount of
time before receiving an error (available only with
INFORMIX-OnLine Dynamic Server). The lock mode also
can refer to the standard unit of locking (either page or
row) chosen by the programmer. The lock mode is set
with the SET LOCK MODE statement.
locking
locking
granularity
logical log
login
login
password
login user ID
macro
Memory
Grant
Manager
(MGM)
The process of temporarily limiting access to an object

(database, table, page, or row) to prevent conflicting
interactions among concurrent processes. Locks can be in
either exclusive mode, which restricts read and write
access to only one user; or share mode, which allows
read-only access to other users. In addition, update locks
exist that begin in share mode but are upgraded to
exclusive mode when a row is changed.
The size of a locked object. The size may be a database,
table, page, or row.
An allocation of disk space managed by OnLine that contains records of all changes that were performed on a
database during the period the log was active. The logical
log is used to roll back transactions, recover from system
failures, and restore databases from archives.
The process of identifying oneself to a computer.
See Informix user password.
See Informix user ID.

A named set of instructions that the computer executes
whenever the name is referenced.
An OnLine component that coordinates the use of
memory and I/O bandwidth for decision-support queries.
MGM uses the DS_MAX_QUERIES, DS_TOTAL_MEMORY,
DS_MAX_SCANS, and PDQPRIORITY configuration
parameters to determine what resources can or cannot be
granted to a decision-support query.
Glossary
29
mantissa
math functions
menu
message log
See aggregate functions.

A screen display that allows you to choose the commands
that you want the computer to perform.
The UNIX file that INFORMIX-OnLine Dynamic Server
keeps to record significant events, such as checkpoints,
logical log file backups, recovery data, and errors.
mirroring
Storing the same data on two chunks simultaneously. If

one chunk fails, the data is still usable on the other chunk
in the mirrored pair. This data storage option is available
with INFORMIX-OnLine Dynamic Server and is handled
by the OnLine administrator.
MODE ANSI
The keywords specified on the CREATE DATABASE statement to make a database ANSI-compliant.
multithreading
30
The significant digits in a floating-point number.
Refers to multiple threads that are run within the same

process. See thread.
national
character
See local character.
native
character
See local character.
native
language
The spoken or written language that is used in a certain

region of the world, such as English or French.
NLS
Acronym for Native Language Support. NLS represents

an application environment that supports single-byte,
8-bit character code sets; it supports alphabetic or Latinbased languages such as those found in Europe and Latin
America. NLS is also known as Native Language System or
National Language Support.
null value
A value representing unknown or not applicable. (A null

is not the same as a value of zero or blank.)
offset
A term that is used in INFORMIX-OnLine Dynamic Server

to specify the physical position of a chunk on a disk. The
offset is the number of kilobytes indented into the named
device (which is the specified disk partition) before
starting the chunk.
OLTP
Characterized by quick, indexed access to a small number

of data items. The applications are typically multiuser,
and response times are measured in fractions of seconds.
application
OLTP queries
OnLine
instance
The transactions handled by OLTP applications are

usually simple and predefined. A typical OLTP system is
an order-entry system where only a limited number of
rows are accessed many times.
One OnLine database server.
ON-Monitor
An interface that presents a series of screens through

which an INFORMIX-OnLine Dynamic Server administrator can monitor and modify an OnLine database server.
open
The process of making a resource available, such as

preparing a file for access, activating a cursor, or initiating
a window.
Glossary
31
operating
mode
optical cluster
An amount of space, on an optical disc, that is reserved

for storing a group of logically related blobs.
optical family
A group of optical-discs, theoretically unlimited in

number.
optical platters
optical
statements
The removable optical disc that stores data in an optical

storage subsystem.
The SQL statements that you use to control optical
clustering.
optical volume
One side of a removable Write-Once-Read-Many (WORM)

optical disc.
outer join
An asymmetric joining of a dominant and a subordinate

table in a query; the joining restrictions apply only to the
subordinate or outer table. Rows in the dominant table are
retrieved without considering the join, but rows from the
outer table are included only if they also satisfy the join
conditions. Any dominant-table rows that do not have a
matching row from the outer table receive a row of nulls
in place of an outer-table row.
outmigration
output
32
The INFORMIX-OnLine Dynamic Server state of operation.

The operating modes are off-line, quiescent, on-line,
read-only, shutdown, and recovery.
The process by which INFORMIX-OnLine/Optical

migrates a blob from the INFORMIX-OnLine Dynamic
Server environment to an optical storage subsystem.
The result that the computer produces in response to a
query or a request for a report.
ownerprivileged
pad
Refers to a class of stored procedure that can be created by

any user who has Resource database privileges.
Usually a space or blank to fill empty places at the
beginning or end of a line, string, or field.
page
The basic unit of disk and memory storage that is used by

INFORMIX-OnLine Dynamic Server. The size is fixed for a
particular operating system and hardware platform, and
the OnLine administrator cannot change it.
parallelism
Refers to ability of OnLine to process a task in parallel by

breaking the task into subtasks and then processing them
simultaneously.
parameter
A variable that is given a constant value for a specified

application. In a subroutine, a parameter is the
placeholder for the argument values that are passed to the
subroutine at run time.
parent-child
relationship
See referential constraint.
parent table
The referenced table in a referential constraint. See child

table.
partition
pattern
See table fragment.

An identifiable or repeatable series of characters or
symbols.
Glossary
33
PDQ
Acronym for Parallel Database Query (or Queries). An

OnLine feature that permits parallel rather than sequential execution of SQL queries by distributing the execution
of a single query across several processors, which
enhances performance.
PDQ priority
Determines the amount of resources OnLine allocates to

process a query in parallel. These resources include
memory, threads (such as scan threads), and sort space.
The level of parallelism is established by using the
PDQPRIORITY environment variable or various OnLine
configuration parameters (including PDQPRIORITY and
MAX_PDQPRIORITY) or dynamically through the SET
PDQPRIORITY statement.
permission
On some operating systems, the right to access files and

directories.
phantom row
A row of a table that is initially modified or inserted

during a transaction but is subsequently rolled back.
Another user can see a phantom row if the isolation level
is Informix DIRTY READ or ANSI READ UNCOMMITTED.
No other isolation levels allow a changed but
uncommitted row to be seen.
physical log
An allocation of disk space in INFORMIX-OnLine Dynamic

Server that contains the before-images of all pages
changed since the last checkpoint.
34
pointer
A number that specifies the address-in-memory of the

data or variable of interest.
precision
The total number of significant digits in a real number,

both to the right and left of the decimal point. For example, the number 1437.2305 has a precision of 8. See scale.
prepared
statement
An SQL statement that is generated by the PREPARE

statement from a character string or from a variable
containing a character string. This feature allows you to
form your request while the program is executing
without having to modify and recompile the program.
preprocessor
A program that takes high-level programs and produces

code that a standard language compiler, such as C or
Micro Focus COBOL/2, can compile.
primary key
The information from a column or set of columns that

uniquely identifies each row in a table. The primary key
sometimes is called a unique key.
primary-key
constraint
Specifies that each entry in a column or set of columns

contains a non-null unique value.
printable
character
A character that can be displayed on a terminal, screen, or

printer. Printable characters include A-Z, a-z, 0-9, and
punctuation marks. Compare with control character.
privilege
The right to use or change the contents of a database or

table. See access privileges.
procedural
statement
A programming language statement that specifies

actions; for example, looping and branching if a condition
is met. Compare with declaration statement.
procedure
See program block and stored procedure.
procedure
cursor
A cursor that is associated with an EXECUTE PROCEDURE

statement. It enables you to scan multiple rows of data,
moving data row by row into a set of receiving variables.
Glossary
35
process
A discrete task, generally a program, that the operating

system executes.
program block
A named collection of statements, such as a function,

routine, or procedure, that performs a particular task; a
unit of program code.
program
control
projection
promotable
lock
protocol
query
query
optimization
information
statements
36
The actions that a computer takes, as opposed to actions

that a user takes.
Taking a vertical subset from the columns of a single table
that retains the unique rows. Projection is implemented
through the select list in the SELECT clause of a SELECT
statement and returns some of the columns and all the
rows in a table. See selection and join.
A lock that can be changed from a shared lock to an
exclusive lock. See update lock.
A set of rules that govern communication among
computers. These rules govern format, timing,
sequencing, and error control.
A request to the database to retrieve data that meets
certain criteria, usually with the SELECT statement.
The SQL statements that are used to optimize queries.
These statements include SET EXPLAIN, SET
OPTIMIZATION, and UPDATE STATISTICS.
range rule
A user-defined algorithm that you use to define the

boundaries of each fragment in a table using SQL relational and logical operators. Expressions in a range rule
can use the following restricted set of operators: >, <, >=,
<=, and the logical operator AND.
raw device
A UNIX disk partition that is defined as a characterspecial device, which is not mounted. It can be used for
INFORMIX-OnLine Dynamic Server disk space to increase
performance with UNIX files.
READ
COMMITTED
An ANSI level of isolation available through

TRANSACTION statement in which a user can view only
rows that are currently committed at the moment of the
query request; that is, a user cannot view rows that were
changed as a part of a currently uncommitted transaction.
It is the default level of isolation under OnLine for
databases that are not ANSI-compliant. See isolation.
READ An ANSI level of isolation set with the SET TRANSACTION

UNCOMMITTED statement that does not account for locks and allows
viewing of any existing rows, even rows that currently

can be altered from inside an uncommitted transaction.
READ UNCOMMITTED is the lowest level of isolation (no
isolation at all). See isolation.
real user ID
record
recover a
database

See row.
To restore a database to a former condition after a system
failure or other destructive event. The recovery restores
the database as it existed immediately before the crash.
This is sometimes referred to as restore a database.
Glossary
37
referential
constraint
relation
See table.
relational
database
A database that uses a table structure to store data. Each

table consists of a set of fixed-length rows divided into
columns.
remainder
page
An additional page that is filled with data from a single

row. INFORMIX-OnLine Dynamic Server uses remainder
pages when the data for a row cannot fit in the initial
page. Remainder pages are added and filled as needed.
The original page entry contains pointers to the
remainder pages. See home page.
remote
A connection that requires a network.
REPEATABLE
READ
An Informix and ANSI level of isolation available through

OnLine with the Informix SET ISOLATION statement or
ANSI SET TRANSACTION statement, which ensures all
data read during a transaction is not modified during the
entire transaction. Transactions under ANSI REPEATABLE
READ are also known as SERIALIZABLE. Informix
REPEATABLE READ is the default level of isolation under
OnLine for ANSI-compliant databases. See isolation and
SERIALIZABLE.
reserved word
A word in a statement or command that you cannot use

in any other context of the language or program without
receiving a warning or error message.
restore a
database
38
Defines the relationship between columns within a table

or between tables; also known as a parent-child relationship.
Referencing columns also are known as foreign keys.
See recover a database.
roll back
The process that reverses an action or series of actions on

a database. The database is returned to the condition that
existed before the actions were executed. See transaction.
roll forward
The process that brings a database up to date. This

process usually takes place when a database is recovered
after a system crash or other failure. In INFORMIX-SE, an
archive copy of the database is restored to the disk, and
then the database is rolled forward to a point just before
the failure. In INFORMIX-OnLine Dynamic Server, an
archive copy of the database is restored to the disk, and
then the logical log records are rolled forward to a point
just before the failure.
root dbspace
The initial dbspace for an INFORMIX-OnLine Dynamic

Server system. In addition to any data, the root dbspace
contains reserved pages and internal tables that track
OnLine storage, recovery, and consistency information.
round-robin
distribution
scheme
An OnLine-defined distribution scheme. Online distributes rows in such a way that the number of rows in each
of the fragments remains approximately the same.
routine
row
See program block.

A group of related items of information about a single
entity in a database table. In a table of customer
information, for example, a row contains information
about a single customer. A row is sometimes referred to as
a record or tuple. (In a screen form, a row can refer to a line
of the screen.)
Glossary
39
rowid
In nonfragmented tables, rowid refers to an integer that

defines the physical location of a row. Rowids must be
explicitly created to be used in fragmented tables and
they do not define a physical location for a row. Rowids in
fragmented tables are accessed by an index that is created
when the rowid is created; this access method is slow.
Informix recommends that users creating new
applications move toward using primary keys as a
method of row identification instead of using rowids.
rule
How OnLine or the user determines into which fragment

rows are placed. OnLine determines the rule for a round
robin-based distribution scheme. The user determines the
rule for an expression-based distribution scheme.
run-time
environment
The hardware and operating system services available at

the time a program runs.
run-time errors
scale
scan thread
schema
40
Errors that occur during program execution. Compare

with compile-time errors.
The number of digits to the right of the decimal place in
DECIMAL notation. The number 1437.2350 has a scale of 4
(four digits to the right of the decimal point). See precision.
An OnLine thread that is assigned the task of reading
rows from a table. When a query is executed in parallel,
OnLine allocates multiple scan threads to perform the
query in parallel.
The structure of a database or a table. The schema for a
table lists the names of the columns, their data types, and
(where applicable) the lengths, indexing, and other
information about the structure of the table.
scope of
reference
scroll cursor
secure
auditing
select
select cursor
The portion of a program in which an identifier applies

and can be accessed. Three possible scope sizes exist: local
(an identifier applies only within a single program block),
modular (the identifier applies throughout a single
module), and global (an identifier applies throughout the
entire program).
A cursor created with the SCROLL keyword that allows
you to fetch rows of the active set in any sequence.
A facility of the INFORMIX-OnLine Dynamic Server that
lets OnLine administrators keep track of unusual or
potentially harmful user activity. Use the onaudit utility
to enable auditing of events and create audit masks, and
the onshowaudit utility to extract the audit event
information for analysis.
See query.
A cursor associated with the SELECT statement. It enables
you to scan multiple rows of data, moving data row by
row into a set of receiving variables.
selection
Taking a horizontal subset of the rows of a single table

that satisfies a particular condition. Selection is
implemented through the WHERE clause of a SELECT
statement and returns some of the rows and all of the
columns in a table. See projection and join.
self-join
A join between a table and itself. A self-join occurs when a

table is used two or more times in a SELECT statement
(with different aliases) and joined to itself.
semaphore
A UNIX communication device that signals a process to

awaken.
Glossary
41
SERIALIZABLE
An ANSI level of isolation available through

TRANSACTION statement, ensuring all data read during a
transaction is not modified during the entire transaction.
ANSI SERIALIZABLE is the default level of isolation under
OnLine for an ANSI-compliant database that is set with
the SET TRANSACTION statement.
server name
The unique name of a database server. The database

server name is used by an application to select a database
server. It is assigned by the administrator of the database
server.
server number
A unique number between 0 and 255, inclusive, that the

INFORMIX-OnLine Dynamic Server administrator assigns
to an OnLine database server at the time of initialization.
If more than one OnLine database server is installed on
the same computer, each database server must have a
unique number.
session
The structure that is created for an application using

INFORMIX-OnLine Dynamic Server.
set functions
shared lock
42
See aggregate functions.

A lock that more than one thread can acquire on the same
object. Shared locks allow for greater concurrency with
multiple users; if two users have locks on a row, a third
user cannot change the contents of that row until both
users (not just the first) release the lock. Shared-locking
strategies are used in all levels of isolation except
Informix DIRTY READ and ANSI READ UNCOMMITTED.
shared
memory
Memory that is accessible to multiple processes. Shared

memory allows multiple processes to access a common
data space in memory. Common data does not have to be
reread from disk for each process, reducing disk I/O and
improving performance. Also used as an IPC mechanism.
shelf
The location of an optical platter that is neither on an optical drive nor in a jukebox slot.
shuffling
Shuffling refers to the process that occurs when OnLine

moves rows or key values from one fragment to another.
Shuffling occurs in a variety of circumstances including
when you attach, detach, or drop a fragment.
signal
A means of asynchronous communication between two

processes. For example, signals are sent when a user or a
program wants to interrupt or suspend the execution of a
process. See interrupt.
singleton
select
A SELECT statement that returns a single row.
SMI
Acronym for system monitoring interface. SMI is a collection

of tables in the sysmaster database that maintains
dynamically updated information about the operation of
an INFORMIX-OnLine Dynamic Server database server.
source file
A file containing instructions (in ASCII text) that is used as

the source for generating compiled programs.
SPL
Acronym for Stored Procedure Language. See stored

procedure.
Glossary
43
44
SQL
Acronym for Structured Query Language. SQL is a

database query language that was developed by IBM and
standardized by ANSI. Informix relational database
management products are based on an extended
implementation of ANSI-standard SQL.
SQL API
An SQL application programming interface that includes

a library of callable functions, which are used to develop
an application that accesses a relational database. Examples include the embedded-language products such as
INFORMIX-ESQL/C and INFORMIX-ESQL/COBOL. See host
variable.
SQLCA
Acronym for SQL Communications Area. The SQLCA is a

data structure that stores information about the most
recently executed SQL statement. The result code returned
by the database server to the SQLCA is used for error
handling by Informix SQL APIs.
sqlda
Acronym for SQL descriptor area. A dynamic SQL management structure that can be used with the DESCRIBE
statement to store information about database columns or
host variables used in dynamic SQL statements. The structure contains an sqlvar_struct structure for each column;
each sqlvar_struct structure provides information such as
the name, data type, and length of the column. The sqlda
structure is an Informix-specific structure for handling
dynamic columns. It is available only within an
INFORMIX-ESQL/C program. See also descriptor, and
system-descriptor area.
sqlexecd
A daemon process that receives a connection request from

a client and spawns an INFORMIX-SE database server
process.
staging-area
blobspace
The blobspace where INFORMIX-OnLine Dynamic Server

temporarily stores a blob that is being outmigrated to an
optical storage subsystem.
statement
A line, or set of lines, of program code that describes a

single action (for example, a SELECT statement or an
UPDATE statement).
statement
block
A section of a program that usually begins and terminates

with special symbols such as begin and end. A statement
block is the smallest unit of scope of reference for
program variables.
statement
identifier
An embedded variable name or SQL statement identifier

that represents a data structure defined in a PREPARE
statement. It is used for dynamic SQL statement
management by Informix SQL APIs.
status variable
A program variable that indicates the status of some

aspect of program execution. Status variables often store
error numbers or act as flags to indicate that an error has
occurred.
stored
procedure
A function that is used along with SQL statements in an

Informix program. Stored procedures are written using
SQL and Stored Procedure Language (SPL) statements.
The procedure is stored in the database in executable
form.
Glossary
45
string
subordinate
table
46
A set of characters (generally alphanumeric) that is

manipulated as a single unit. A string might consist of a
word (such as Smith), a set of digits representing a number (such as 19543), or any other collection of characters.
Strings generally are surrounded by single quotes. A
string is also a character data type, available in
INFORMIX-ESQL/C programs, in which the character
string is stripped of trailing blanks and is null-terminated.
See outer join.
subquery
A query that is embedded as part of another SQL statement. For example, an INSERT statement can contain a
subquery in which a SELECT statement supplies the
inserted values in place of a VALUES clause; an UPDATE
statement can contain a subquery in which a SELECT
statement supplies the updating values; or a SELECT
statement can contain a subquery in which a second
SELECT statement supplies the qualifying conditions of a
WHERE clause for the first SELECT statement. (Parentheses always delimit a subquery, unless you are referring to
a CREATE VIEW statement or unions.)
subscript
Delimiters that indicate the start and end positions of a

substring.
substring
A portion of a character string.
synonym
A name that is assigned to a table and used in place of the

original name for that table. A synonym does not replace
the original table name; instead, it acts as an alias for the
table.
sysmaster
database
system call
A database that every INFORMIX-OnLine Dynamic Server

database server contains. It holds the ON-Archive catalog
tables and system monitoring interface (SMI) tables.
A call to a function provided by the operating system.
system catalog
A group of database tables that contain information about

the database itself, such as the names of tables or columns
in the database, the number of rows in a table, the
information about indexes and database privileges, and
so on. See data dictionary.
systemdescriptor area
A dynamic SQL management structure that is used with

the ALLOCATE DESCRIPTOR, DEALLOCATE DESCRIPTOR,
DESCRIBE, GET DESCRIPTOR, and SET DESCRIPTOR statements to store information about database columns or
host variables used in dynamic SQL statements. The structure contains an item descriptor for each column; each
item descriptor provides information such as the name,
data type, length, scale, and precision of the column. The
system-descriptor area is the X/Open standard for handling dynamic columns. See descriptor and sqlda.
system
monitoring
interface
table
See SMI.
A rectangular array of data in which each row describes a

single entity and each column contains the values for each
category of description. For example, a table can contain
the names and addresses of customers. Each row corresponds to a different customer and the columns correspond to the name and address items. A table sometimes
is referred to as a relation.
Glossary
47
table fragment
tblspace
TCP/IP
The logical collection of extents that are assigned to a

table under INFORMIX-OnLine Dynamic Server.
The specific name of a particular standard transport layer
protocol (TCP) and network layer protocol (IP). A popular
network protocol used in DOS, UNIX, and other
environments.
temporary
An attribute of any file, index, or table that is used only

during a single session. Temporary files or resources are
typically removed or freed when program execution
terminates or an on-line session ends.
thread
A single sequential flow of control that represents a unit

of work within a multithreaded process.
timeout
TLI
trace
48
Consists of zero or more rows that are grouped together

and stored in a dbspace that you specify when you create
the fragment.
The point at which a lock request is aborted because the

requesting thread waited longer for the lock than the
specified maximum time limit. A program developer can
set a time limit in INFORMIX-OnLine Dynamic Server
through the SET LOCK MODE statement.
Acronym for Transport Level Interface. It is the interface
designed for use by application programs that are
independent of a network protocol.
To keep a running list of the values of program variables,
arguments, expressions, and so on, in a program or stored
procedure.
transaction
A collection of one or more SQL statements that is treated

as a single unit of work. If one statement in a transaction
fails, the entire transaction can be rolled back (canceled). If
the transaction is successful, the work is committed and all
changes to the database from the transaction are accepted.
transaction
logging
The process of keeping records of transactions. See logical

log.
trigger
A mechanism that resides in the database. It specifies that

when a particular action (insert, delete, or update) occurs
on a particular table, the database server should
automatically perform one or more additional actions.
tuple
unique
constraint
unique key
UNIX real
user ID
See row.
Specifies that each entry in a column or set of columns has
a unique value.
See primary key.
unlock
To free an object (database, table, page, or row) that has

been locked. For example, a locked table prevents others
from adding, removing, updating, or (in the case of an
exclusive lock) viewing rows in that table as long as it is
locked. When the user or program unlocks the table,
others are permitted access again.
update
The process of changing the contents of one or more

columns in one or more existing rows of a table.
Glossary
49
update lock
user ID
user ID
password
user name
user password
variable
view
virtual column
50
A promotable lock that is acquired during a SELECT...FOR

UPDATE. An update lock behaves like a shared lock until
the update actually occurs, and it then becomes an
exclusive lock. It differs from a shared lock in that only
one update lock can be acquired on an object at a time.

The identifier for a location in memory that stores the
value of a program object whose value can change during
the execution of the program.
A dynamically controlled picture of the contents in a
database that allows a programmer to determine what
information the user sees and manipulates. A view
represents a virtual table based on a specified SELECT
statement.
A derived column of information that is not stored in the
database. For example, you can create virtual columns in
a SELECT statement by arithmetically manipulating a
single column, such as multiplying existing values by a
constant, or by combining multiple columns, such as
adding the values from two columns.
virtual
processors
The multithreaded processes that make up the

INFORMIX-OnLine Dynamic Server database server.
Virtual processors service a large number of clients by
functioning in a way that is analogous to the way that
hardware processors function in the computer.
warning
A state or situation that is detected by the database server

or compiler, possibly incorrect syntax or a problem. A
warning does not necessarily affect the ability of the code
to run.
wildcard
A special symbol that represents any sequence of zero or

more characters or any single character. In SQL, for
example, you can use the asterisk ( * ), question mark ( ? ),
brackets ( [ ] ), percent sign ( % ), and underscore ( _ ) as
wildcard characters. (The asterisk, question mark, and
brackets are also wildcards in UNIX.)
window
A rectangular area on the screen in which you can take

actions without leaving the context of the background
program.
WORM
X/Open
Acronym for Write-Once-Read-Many optical media.

When a bit of data is written to a WORM platter, a
permanent mark is made on the platter.
An independent consortium that produces and develops
specifications and standards for open-systems products
and technology such as dynamic SQL and NLS.
Glossary
51
X/Open
Portability
Guide
52
A set of specifications which vendors and users can use

to build portable software. Any vendor carrying the XPG
brand on any particular software product is guaranteeing
that the software correctly implements the X/Open Common Applications Environment (CAE) specifications.
There are CAE specifications for SQL, XA, ISAM, RDA, and
so on.
Index
Multiple-Volume Index
This section is a combined index for the manuals in the SQL

manual series. Each page reference in the index ends with a
code that identifies the manual in which the page appears.
These codes are as follows.
R
S
T

Informix Guide to SQL: Syntax
Informix Guide to SQL: Tutorial
Special symbols are listed in ASCII order at the end of the

index.
A
ABS function
syntax in expression 1-560S
use in expression 1-563S
ABSOLUTE keyword
syntax in FETCH 1-260S
use in FETCH 1-264S
Access control. See Privilege.
ACCESS FOR keywords, in INFO
statement 1-317S
Access modes
discussed 7-16T
Accessing data in a fragmented
table 9-39T
Accessing tables 11-18T
ACOS function
Action clause
AFTER 1-172S
definition of 1-171S
FOR EACH ROW 1-172S

subset, syntax 1-177S
syntax 1-171S
Action statements
in triggered action clause 1-179S
list of 1-179S
order of execution 1-179S
Active set
constructing with OPEN
1-341S, 1-342S
definition of 2-29T
of a cursor 5-24T
retrieving data with FETCH
1-260S
ADD CONSTRAINT keywords,
syntax in ALTER TABLE 1-42S
ADD ROWID clause, of ALTER
TABLE 9-41T
Address, Informix corporate vR
AFTER
action 1-172S
keyword 1-172S
Aggregate function
ALL keyword, syntax 1-583S
and GROUP BY clause 3-5T
AVG function, syntax 1-583S
description of 2-53T
DISTINCT keyword, syntax
1-583S
in ESQL 5-15T, 1-588S
in EXISTS subquery 1-529S
in expressions 1-400S
in SELECT 1-401S
in SPL expressions 12-23T
in subquery 3-34T
MAX function, syntax 1-583S
MIN function, syntax 1-583S
null value signalled 5-13T
restrictions in modifiable view
10-25T
restrictions with GROUP BY
1-420S
SUM function, syntax 1-583S
summary 1-587S
Algebraic functions
ABS function 1-563S
MOD function 1-563S
POW function 1-564S
ROOT function 1-564S
ROUND function 1-564S
SQRT function 1-565S
syntax 1-560S
TRUNC function 1-566S
Alias
for a table in SELECT 1-409S
for table name 2-79T
to assign column names in
temporary table 3-13T
use with GROUP BY clause
1-420S, 1-424S
with self-join 3-11T
ALL keyword
beginning a subquery
3-32T, 1-415S
DISCONNECT statement 1-229S
syntax
in expression 1-583S
in GRANT 1-308S
in REVOKE 1-386S
in SELECT 1-397S
with UNION operator 1-395S
use
in Condition subquery 1-530S
in GRANT 1-310S
in SELECT 1-399S
with dbschema utility
5-41R, 5-46R
ALLOCATE DESCRIPTOR
statement
syntax 1-14S
with concatenation operator
1-548S
Allocating memory with the
ALLOCATE DESCRIPTOR
statement 1-14S
ALTER FRAGMENT statement
ADD Clause 1-31S
ATTACH clause 1-19S
attaching with fragment
expression 1-23S
attaching with round robin 1-22S
DETACH clause 1-36S
DROP clause 1-33S
effects on BLOB columns 1-23S
effects on constraints 1-24S
effects on indexes 1-24S
effects on triggers 1-24S
effects on triggers, constraints,
indexes 1-21S
example 9-37T
how executed 1-18S
INIT clause 9-41T, 1-24S
MODIFY clause 9-36T, 1-34S
privileges needed to alter
fragments 1-18S
syntax 1-17S
use 1-18S
ALTER INDEX statement
creating clustered index 1-39S
dropping clustered index 1-40S
locks table 7-8T
syntax 1-39S
ALTER keyword
syntax
in GRANT 1-304S
in REVOKE 1-386S
use
in GRANT 1-310S
in REVOKE 1-387S
Alter privilege 10-10T, 1-310S
ALTER TABLE statement
ADD clause 1-44S
ADD CONSTRAINT clause 1-61S
ADD ROWIDS clause 9-41T
adding
a column 1-44S
a column constraint 1-60S
rowids 1-65S
and NCHAR column 1-22R
and NVARCHAR column 1-22R
cascading deletes 1-52S
changing column data type
9-21T, 1-57S
changing table lock mode 1-65S
CHECK clause 1-54S
DEFAULT clause 1-45S
DROP clause 1-56S
DROP CONSTRAINT clause
1-63S
DROP ROWIDS clause 9-41T
dropping
a column 1-56S
a column constraint 1-63S
rowids 1-66S
LOCK MODE clause 1-65S
MODIFY NEXT SIZE clause
2-11R, 1-64S
ON DELETE CASCADE keyword
1-49S
PAGE keyword 1-65S
privilege for 10-10T, 1-304S
reclustering a table 1-40S
REFERENCES clause 1-49S
ROW keyword 1-65S
rules for primary key constraints
1-62S
rules for unique constraints 1-62S
American National Standards
Institute. See ANSI.
AND keyword
syntax in Condition segment
1-517S
use
in Condition segment 1-531S
with BETWEEN keyword
1-412S
AND logical operator 2-37T, 1-531S
ANSI 1-17T
ANSI compliance
-ansi flag 4-18R
DBANSIWARN environment
variable 4-18R
ANSI-compliance
-ansi flag
Intro-8S, 1-124S, 1-130S, 1-19
4S
described 1-10R
determining 1-11R
list of SQL statements 1-11S
reserved words 1-593S
table naming 1-380S
updating rows 1-493S
ANSI-compliant database
buffered logging restricted in
9-25T
constraint naming 1-534S
create with START DATABASE
1-482S
description of 1-17T, 1-96S
designating 1-11R
effect on
cursor behavior 1-15R
decimal data type 1-15R
default isolation level 1-14R
escape characters 1-15R
object privileges 1-14R
owner-naming 1-13R
SQLCODE 1-16R
transaction logging 1-13R
transactions 1-13R
FOR UPDATE not required in
6-16T, 1-207S
owner-naming 1-13R
privileges 1-14R
procedure naming 1-622S
reason for creating 1-11R
signalled in SQLAWARN 5-13T
SQL statements allowed 1-16R
synonym naming 1-633S
table privileges 10-8T, 1-130S

using with INFORMIX-SE 1-98S
with BEGIN WORK 1-68S
ANY keyword
3-33T, 1-415S
in WHENEVER 1-510S
use in Condition subquery 1-530S
Application
common features 1-21T
design of order-entry 4-24T
handling errors 5-18T
report generator 1-19T
screen forms 1-19T
Arbitrary rule
1-30S, 1-107S, 1-161S
Archives
with INFORMIX-SE 11-21T
Archiving
description of 1-11T, 4-27T
INFORMIX-OnLine Dynamic
Server methods 4-28T
setting a different tctermcap file
4-15R
setting DBREMOTECMD to
override default remote shell
4-32R
setting personal default qualifier
file 4-15R
transaction log 4-27T
ARC_DEFAULT environment
variable 4-15R
ARC_KEYPAD environment
variable 4-15R
Arithmetic functions. See Algebraic
functions.
Arithmetic operator, in expression
2-47T, 1-547S
Array, moving rows into with
FETCH 1-267S
AS keyword
in SELECT 1-397S
syntax
in CREATE VIEW 1-193S
in GRANT 1-304S
use
in CREATE VIEW 1-195S
in GRANT 1-312S
with display labels 1-402S
with table aliases 1-410S
ASC keyword
syntax
in SELECT 1-423S
syntax, in CREATE INDEX 1-99S
use
in SELECT 1-425S
use, in CREATE INDEX 1-102S
Ascending order in SELECT 2-15T
ASCII collating order 1-17R, 1-629S
ASIN function
Asterisk
wild card character in SELECT
2-12T
Asterisk (*)
arithmetic operator 1-546S
use in SELECT 1-397S
At (@) sign, in database name
1-535S
ATAN function
ATAN2 function
Attached index 1-104S
Attribute
identifying 8-16T
important qualities of 8-16T
nondecomposable 8-17T
Audit trail
applying with RECOVER TABLE
1-373S
dropping with DROP AUDIT
1-230S
manipulating audit trail file
1-375S
no clustered index 1-101S
starting with CREATE AUDIT
1-92S
Automatic type conversion. See
Data type conversion.
Index
AVG function
as aggregate function 2-53T
B
Bachman, C.R. 8-19T
Backslash (\)
as escape character with LIKE
1-524S
as escape character with
MATCHES 1-525S
Backup. See Archive.
BEFORE keyword 1-171S
BEGIN WORK statement
locking in a transaction 1-67S
specifies start of a transaction
4-26T
syntax 1-67S
BETWEEN keyword
1-519S
use
in SELECT 1-412S
BETWEEN keyword, used to test
for equality in WHERE clause
2-29T
BETWEEN operator 2-33T
Binary Large Object
location shown in sysblobs table
2-13R
Binary Large Object (BLOB)
attaching tables 1-23S
effect of isolation on retrieval
1-465S, 1-480S
in a LOAD statement 1-333S
in an UNLOAD statement 1-487S
increasing buffer size 4-20R
setting buffer size 4-20R
Boolean expression
and logical operator 2-37T
with TEXT data type 3-25R
Bourne shell
how to set environment variables
4-8R
.profile file 4-7R
Buffer
setting size of fetch buffer 4-39R
BUFFERED keyword, syntax in SET
LOG 1-470S
BUFFERED LOG keywords
syntax in CREATE DATABASE
1-94S
use in CREATE DATABASE 1-96S
Buffered logging 9-25T, 1-94S
Building your data model
8-3T to 8-36T
BYTE data type
considerations for UNLOAD
statement 1-487S
description of 9-21T, 3-5R
inserting data 3-6R
requirements for LOAD
statement 1-333S
restrictions
in Boolean expression 3-5R
with GROUP BY 3-6T, 3-5R
with LIKE or MATCHES
2-39T, 3-5R
with ORDER BY 3-5R
with relational expression 2-30T
selecting a BYTE column 3-6R
syntax 1-540S
with stored procedures
2-11S, 2-16S
BYTE value, displaying 2-11T
C
C compiler
setting INFORMIXC environment
variable 4-40R
C shell
4-8R
.cshrc file 4-7R
.login file 4-7R
Calculated expression
1-420S
CALL keyword, in the

WHENEVER statement
1-510S, 1-514S
CALL statement
assigning values with 12-24T
executing a procedure 12-11T
syntax 2-5S
call_type table in stores7 database,
columns in 56
Candidate key
defined 8-25T
Cardinality 8-10T
Cardinality in relationship 8-15T
Caret (^) wildcard in Condition
segment 1-525S
Cartesian product
basis of any join 2-71T
Cascading deletes
defined 4-22T, 1-52S, 1-146S
locking associated with
4-22T, 1-53S, 1-147S
logging 4-22T, 1-53S, 1-147S
restriction 4-23T, 1-54S, 1-148S
syntax 1-49S, 1-142S
Cascading triggers
and triggering table
1-184S, 1-188S
description of 1-187S
maximum number of 1-187S
scope of correlation names 1-181S
triggered actions 1-173S
Chaining synonyms 11-20T
Changing the number of fragments
9-38T
CHAR data type
changing data types 3-28R
in INSERT 1-627S
in relational expressions 2-30T
subscripting 2-45T
substrings of 2-27T
syntax 1-540S
truncation signalled 5-13T
versus NCHAR data type 1-22R
with numeric values 3-6R
CHAR data type, using as default
value 1-46S, 1-134S
CHARACTER data type 3-7R
Character mapping files 5-5R

Character string
as DATE values 3-35R
as DATETIME values
3-12R, 3-35R
as INTERVAL values 3-19R
processing with NLS 1-17R
CHARACTER VARYING data type
Character-position form of FILE
and INSERT statements 5-35R
Check constraint
adding with ALTER TABLE 1-54S
definition of 4-19T, 1-148S
described in syschecks table 2-14R
described in syscoldepend table
2-16R
specifying at column level 1-148S
specifying at table level 1-148S
CHECK keyword
use in ALTER TABLE 1-54S
use in CREATE TABLE 1-148S
CHECK TABLE statement, syntax
and use 1-69S
Checking contents of environment
configuration file 5-4R
Checking for corrupted tables 1-69S
chkenv utility
description of 5-4R
error message for 5-4R
Client/server
shared memory communication
segments 4-47R
specifying default database 4-46R
specifying stacksize for client
session 4-48R
SQLEXEC environment variable
4-64R, 4-65R
SQLRMDIR environment variable
4-65R
Client/server environment 1-190S
CLOSE DATABASE statement
effect on database locks 7-7T
prerequisites to close 1-75S
syntax 1-75S
CLOSE statement
closing
a select cursor 1-72S
closing an insert cursor 1-72S
cursors affected by transaction

end 1-73S
syntax 1-71S
1-548S
CLUSTER keyword
syntax
in ALTER INDEX 1-39S
use
in ALTER INDEX 1-39S
Clustered index
with ALTER INDEX 1-39S
with audit trails 1-101S
Clustered index, creating with
CREATE INDEX 1-101S
COBOL 5-7T
COBOL compiler
identifying the compiler
manufacturer 4-43R
setting directory for library and
objects 4-41R
setting with INFORMIXCOB
environment variable 4-40R
specifying storage for compiling
4-42R
Codd, E. F. 1-12T, 8-35T
Code set
for crtcmap text file 5-7R
mapping non-standard to
standard 5-5R
mapping with crtcmap utility
5-5R
Collation
COLLCHAR environment
variable 4-16R
LC_COLLATE environment
variable 4-51R
simultaneous, and performance
1-23R
with NLS activated 1-17R
Collation order and NLS 2-25T
COLLCHAR environment variable
1-19R, 4-16R
Colon (:)
as delimiter in DATETIME 3-11R
as delimiter in INTERVAL 3-18R
Color, setting INFORMIXTERM for

4-49R
Column
changing data type 3-28R
constraints, listed in
sysconstraints table 2-20R
creating with NLS 1-22R
defaults, described in sysdefaults
table 2-22R
defined 2-5T
defining 8-22T
defining as foreign key 1-141S
defining as primary key 1-141S
described in syscolumns table
2-17R
displaying information for 1-315S
in relational model 1-13T, 8-22T
in stores7 database 52 to 57
inserting into 1-321S
label on 3-45T
length, shown in syscolumns table
2-18R
maximum/minimum, shown in
syscolumns table 2-19R
modifying with ALTER TABLE
1-57S
naming conventions 1-377S
naming, allowable characters
1-591S
number allowed when defining
constraint 1-131S
putting a constraint on 1-131S
referenced and referencing
1-51S, 1-144S
referential constraints in
sysreferences table 2-35R
renaming 1-376S
specifying check constraint for
1-148S
specifying with CREATE TABLE
1-132S
virtual 1-195S
Column expression
in SELECT 1-400S
syntax 1-548S
Index
Column name
allowable characters 1-591S
using functions as names 1-596S
using keywords as names 1-597S
when qualified 1-180S
Column number 2-23T
effect on triggers 1-170S
Column value
in triggered action 1-182S
qualified vs. unqualified 1-183S
when unqualified 1-182S
Column-level privilege
10-11T, 1-310S
described in syscolauth table
2-15R
Column-level privileges
in syscolauth table 2-9R
COLUMNS FOR keywords, in
INFO statement 1-315S
Columns of a fragmented table,
modifying 9-36T
Command file, dbload 5-29R
Command script, creating database
9-29T
Comments about documentation
vR
Commit, two-phase 11-22T
COMMIT WORK statement
closes cursors 7-22T
releases locks 7-10T, 7-22T
sets SQLCODE 6-5T
syntax 1-77S
Committed Read isolation level
1-464S
Committed Read isolation level
(Informix) 7-13T
COMMITTED READ keywords,
syntax in SET ISOLATION
1-463S
Comparison condition
syntax and use 1-519S
Compiler
environment variable for C 4-40R
environment variable for COBOL
4-40R
setting environment variable for
COBOL 4-43R
specifying storage mode for

COBOL 4-42R
specifying the manufacturer of
the COBOL compiler 4-43R
Complex
relationship 8-30T
Complex query
example of 1-459S
Composite column list, multiplecolumn restrictions 1-61S, 1-62S
Composite index
column limit 1-102S
Composite key 8-25T
Compound assignment 2-33S
Compound query 3-40T
Computer network 11-4T
Concatenation operator (||) 1-547S
Concurrency
access modes 7-16T
ANSI Read Committed isolation
7-13T
ANSI Read Uncommitted
isolation 7-12T
ANSI Repeatable Read isolation
7-15T
ANSI Serializable isolation 7-15T
Committed Read isolation 1-464S
Cursor Stability isolation 1-464S
database lock 7-7T
deadlock 7-18T
defining with SET ISOLATION
1-463S
defining with SET
TRANSACTION 1-480S
Dirty Read isolation 1-464S
effect on performance 7-3T
Informix Cursor Stability isolation
7-13T
Informix Dirty Read isolation
7-12T
Informix Read Committed
isolation 7-13T
Informix Repeatable Read
isolation 7-15T
isolation level 7-11T
kinds of locks 7-6T
lock duration 7-9T
lock scope 7-7T

Read Committed isolation 1-479S
Read Uncommitted isolation
1-478S
Repeatable Read isolation
1-464S, 1-479S
SERIAL values 9-8T
Serializable isolation level 1-479S
table lock 7-8T
Condition segment
ALL, ANY, SOME subquery
1-530S
boolean expressions 1-519S
comparison condition 1-519S
join conditions 1-416S
null values 1-518S
relational operators in 1-522S
subquery in SELECT 1-527S
syntax 1-517S
use of functions in 1-519S
wildcards in searches 1-524S
with BETWEEN keyword 1-522S
with ESCAPE keyword 1-525S
with EXISTS keyword 1-529S
with IN keyword 1-523S
with IS keyword 1-523S
with MATCHES keyword 1-524S
with NOT keyword 1-524S
Configuration file
for ON-Archive utility 4-15R
for OnLine 4-59R
for tctermcap 4-15R
Configuring a database server
11-17T
CONNECT keyword
in GRANT 1-306S
in REVOKE 1-388S
Connect privilege
10-6T, 1-306S, 1-388S
CONNECT statement
and INFORMIXSERVER
environment variable
4-47R, 1-80S
connection context 1-80S
connection identifiers 1-79S
database environment 1-83S
DEFAULT option 1-80S
implicit connections 1-80S
opening a database 11-17T

syntax 1-78S
use 1-79S
USER clause 1-89S
WITH CONCURRENT
TRANSACTION option 1-81S
CONNECT TO statement
1-548S
Connecting to data 11-14T
INFORMIXCONRETRY
INFORMIXCONTIME
Connection
context 1-80S
dormant 1-229S
identifiers 1-79S
INFORMIXCONRETRY
INFORMIXCONTIME
Connectivity in relationship
8-10T, 8-12T, 8-19T
Constant expression
in SELECT 1-400S
inserting with PUT 1-366S
1-420S
syntax 1-551S
Constraint
adding with ALTER TABLE
1-60S, 1-131S
cardinality 8-10T
checking 1-188S
defining domains 9-3T
dropping with ALTER TABLE
1-63S, 1-131S
enforcing 1-131S
modifying a column that has
constraints 1-57S
number of columns allowed
1-131S, 1-138S
privileges needed to create 1-62S
rules for unique constraints 1-61S
setting checking mode 1-438S
specifying at table level 1-138S
with DROP INDEX 1-233S
CONSTRAINT keyword
in ALTER TABLE 1-60S
in CREATE TABLE 1-136S
Consumed table 1-20S
CONTINUE keyword, in the
WHENEVER statement
1-510S, 1-515S
CONTINUE statement
exiting a loop 12-26T
syntax 2-8S
Conventions
example code
Intro-7T, Intro-9R, Intro-11S
for naming tables 1-129S
typographical
Converting data types 3-28R
Coordinated deletes 6-6T
Correlated subquery
restriction with cascading deletes
4-23T
Correlation name
and stored procedures 1-181S
in COUNT DISTINCT clause
1-181S
in GROUP BY clause 1-181S
in SET clause 1-181S
in stored procedure 1-185S
new 1-177S
old 1-177S
rules for 1-181S
scope of 1-181S
table of values 1-183S
using 1-181S
when to use 1-181S
COS function
COUNT DISTINCT clause 1-181S
COUNT field
getting contents with GET
DESCRIPTOR 1-278S
setting value for WHERE clause
1-449S
use in GET DESCRIPTOR 1-280S
COUNT function
and GROUP BY 3-6T
count rows to delete 4-5T

use in a subquery 4-6T
use in expression 1-585S, 1-587S
with DISTINCT 2-54T
COUNT keyword, use in SET
DESCRIPTOR 1-449S
CREATE AUDIT statement
need for archive 1-93S
starts audit trail 1-92S
syntax 1-92S
CREATE DATABASE statement
ANSI compliance 1-96S
in command script 9-29T
logging with OnLine 1-96S
sets shared lock 7-7T
SQLAWARN after 5-13T
syntax 1-94S
using with
CREATE SCHEMA 1-122S
INFORMIX-SE 9-25T, 1-97S
OnLine 9-24T
PREPARE 1-96S
CREATE INDEX statement
cluster with fragments 1-102S
composite indexes 1-102S
fragment by expression 1-105S
implicit table locks 1-101S
IN dbspace clause 1-104S
locks table 7-8T
specifying a storage option 1-104S
syntax 1-99S
using
with CREATE SCHEMA 1-122S
using with
ASC keyword 1-102S
CLUSTER keyword 1-101S
DESC keyword 1-102S
FILLFACTOR clause 1-108S
UNIQUE keyword 1-101S
CREATE PROCEDURE FROM
statement
in embedded languages 12-6T
CREATE PROCEDURE statement
inside a CREATE PROCEDURE
FROM 12-6T
syntax 1-111S
use of dbschema 5-42R
using 12-6T
Index
CREATE SCHEMA example 2-4R

CREATE SCHEMA statement
defining a trigger 1-166S
syntax 1-122S
with CREATE sequences 1-124S
with GRANT 1-124S
CREATE SYNONYM statement
chaining synonyms 1-127S
synonym for a table 1-125S
synonym for a view 1-125S
syntax 1-125S
CREATE TABLE statement
adding rowids 1-157S
and COLLCHAR environment
variable 4-17R
and NCHAR column 1-22R
and NVARCHAR column 1-22R
cascading deletes 1-146S
CHECK clause 1-148S
creating temporary table 1-150S
DEFAULT clause 1-133S
defining columns 1-132S
defining constraints
at column level 1-136S
at table level 1-138S
FRAGMENT BY clause 1-159S
in command script 9-29T
IN dbspace clause 1-158S
LOCK MODE clause 1-163S
ON DELETE CASCADE
keywords 1-142S
REFERENCES clause 1-142S
rules for primary keys 1-144S
rules for referential constraints
1-144S
rules for unique constraints
1-144S
sets initial SERIAL value 9-9T
setting columns NOT NULL
1-47S, 1-136S
specifying extent size 1-162S
specifying table columns 1-132S
storing database tables 1-157S
syntax 1-129S
TEMP TABLE clause 1-150S

with BLOB data types 1-137S
WITH ROWIDS clause
9-40T, 1-156S
CREATE TRIGGER statement
in ESQL/C 1-166S
in ESQL/COBOL 1-166S
privilege to use 1-166S
purpose 1-165S
syntax 1-165S
triggered action clause 1-178S
use 1-166S
CREATE VIEW statement
column data types 1-194S
in sysviews table 2-8R
privileges 1-194S
restrictions on 10-23T
syntax 1-193S
using 10-21T
virtual column 1-195S
WITH CHECK OPTION 1-196S
WITH CHECK OPTION
keywords 10-27T
with SELECT * notation 1-194S
Creating
a database from ASCII files 5-16R
a dbload command file 5-29R
crtcmap utility
creating mapping files 5-5R
description of 5-5R
error messages for 5-8R
formats for mapping files 5-7R
Current database
specifying with DATABASE
1-198S
CURRENT function
comparing column values 2-56T
syntax
in INSERT 1-324S
use
in INSERT 1-326S
in WHERE condition 1-556S

input for DAY function 1-556S
CURRENT keyword
use in FETCH 1-264S
with DATETIME 3-34R
CURRENT OF keywords
syntax
in DELETE 1-218S
in UPDATE 1-491S
use
in DELETE 1-220S
in UPDATE 1-500S
Cursor
activating with OPEN 1-339S
active set of 5-24T
affected by transaction end 1-73S
associating with prepared
statements 1-214S
characteristics 1-208S
closing 7-22T, 1-71S
closing with ROLLBACK WORK
1-392S
declaring 5-21T, 1-203S
definition of types 1-206S
for insert 6-9T
for update 6-15T, 7-10T
hold 7-22T
manipulation statements 1-9S
opening
5-21T, 5-25T, 1-341S, 1-342S
retrieving values with FETCH
5-22T, 1-260S
scroll 5-24T, 1-208S
sequential 5-24T, 5-26T, 1-208S
statement, as trigger event 1-167S
using with transactions 1-215S
with
INTO keyword in SELECT
1-405S
prepared statements
5-33T, 1-206S
WITH HOLD 7-22T
Cursor Stability isolation level
1-464S
Cursor Stability isolation level
(Informix) 7-13T
CURSOR STABILITY keywords,

syntax in SET ISOLATION
1-463S
Cursory procedure 2-25S
customer table in stores7 database,
columns in 52
cust_calls table in stores7 database,
columns in 56
Cyclic query 4-23T
D
Daemon 11-15T
Data
connecting to 11-14T
containing foreign characters
1-22R
how to access in fragmented
tables 9-39T
inserting with the LOAD
statement 1-329S
integrity 11-22T
Data access statements 1-10S
Data definition statements
5-36T, 1-8S
Data distributions
confidence 1-508S
on temporary tables 1-509S
RESOLUTION 1-507S, 1-508S
specifying disk space to use 4-37R
DATA field
setting with SET DESCRIPTOR
1-452S
Data integrity
4-23T to 4-27T, 11-22T
statements 1-10S
Data manipulation statements 1-9S
Data model
attribute 8-16T
building 8-3T to 8-36T
defining relationships 8-9T
entity-relationship 8-5T
many-to-many relationship 8-12T
one-to-many relationship 8-12T
one-to-one relationship 8-12T
See also Relational model.
telephone-directory example 8-6T
Data protection
with OnLine 11-21T
Data replication 11-21T
Data type
approximate 2-50R
automatic conversions 5-16T
BYTE 9-21T, 3-5R
changing with ALTER TABLE
1-59S
CHAR 9-17T, 3-6R
CHARACTER 3-7R
character data 9-17T
CHARACTER VARYING
9-18T, 3-8R
CHAR, mapping to NCHAR
4-17R
choosing 9-21T
chronological 9-13T
considerations for INSERT
1-325S, 1-627S
conversion 4-9T, 3-28R
DATE 9-13T, 3-9R
DATETIME 9-14T, 3-9R
DEC 3-12R
DECIMAL 9-11T, 9-12T, 3-13R
DOUBLE PRECISION 3-15R
exact numeric 2-50R
fixed-point 9-12T
FLOAT 3-15R
floating-point 9-10T, 3-15R
in SPL variables 12-20T
INT 3-15R
INTEGER 9-8T, 3-16R
INTERVAL 9-15T, 3-16R
MONEY 9-12T, 3-19R
NCHAR 9-17T, 3-20R
NCHAR, mapping to CHAR
4-17R
NUMERIC 3-21R
numeric 9-8T
NVARCHAR 9-18T, 3-21R
REAL 9-10T, 3-23R
requirements for referential
constraints 1-52S, 1-145S
segment 1-539S
SERIAL 9-8T, 3-23R
SMALLFLOAT 9-10T, 3-24R
SMALLINT 3-24R
specifying with CREATE VIEW

1-194S
summary table 3-3R
syntax 1-540S
TEXT 9-19T, 3-25R
VARCHAR 9-18T, 3-26R
Data types
creating NCHAR columns 1-22R
creating NVARCHAR columns
1-22R
OnLine specific 1-4R
Database
ANSI-compliant 1-18T
application 1-18T
archiving 1-11T
closing with CLOSE DATABASE
1-75S
concurrent use 1-9T
creating ANSI-compliant 1-482S
creating in NLS mode 1-22R
creating with CREATE
DATABASE 1-95S
data types 3-3R
default isolation levels
1-465S, 1-479S
defined 1-3T, 1-12T
dropping 1-231S
implicit connection 1-228S
lock 1-200S
management of 1-9T
map of
stores7 57
system catalog tables 2-45R
mission-critical 1-11T
naming unique to engine 9-24T
naming with variable 1-538S
NLS 1-18T, 1-22R
opening in exclusive mode 1-200S
optimizing queries 1-505S
populating new tables 9-30T
related reading vR
relational, defined 1-12T
remote 1-537S
restoring 1-393S
server 1-9T, 1-18T
server, definition of 1-19T
stopping logging on 1-482S
Index
stores7
stores7 description of 51
table names 11-18T
Database Administrator (DBA)
10-7T, 1-307S
Database lock 7-7T
Database management system
11-4T
Database Name segment
database outside DBPATH 1-538S
for remote database 1-537S
naming with variable 1-538S
syntax 1-535S
using quotes, slashes 1-538S
Database server
attributes in Information Schema
view 2-51R
choosing OnLine or SE 1-4R
configuration 11-17T
definition of 1-19T
effect of server type on
available data types 1-4R
isolation level 1-7R
locking 1-6R
rolling back transactions 1-5R
SQL statements supported 1-8R
system catalog tables 1-8R
transaction logging 1-5R
local 11-6T
remote 11-9T
setting SQLEXEC 4-64R
specifying default for connection
4-46R
SQLRM environment variable
4-65R
4-65R
DATABASE statement
determining database type 1-198S
exclusive mode 7-7T, 1-200S
locking 7-7T
specifying current database
1-198S
SQLAWARN after 5-13T, 1-199S
syntax 1-198S
using with program variables
1-199S
10
Database-level privilege
granting 1-306S
passing grant ability 1-311S
revoking 1-388S
See also Privilege.
Data-distribution information
in sysdistrib table 2-24R
Dataskip
skipping unavailable dbspaces
1-440S
DATE data type
converting to DATETIME 3-30R
functions in 2-56T, 1-573S
in ORDER BY sequence 2-15T
range of operations 3-30R
representing DATE values 3-34R
specify display format 4-21R
syntax 1-540S
using with DATETIME and
INTERVAL values 3-34R
DATE function
as time function 2-56T
use in expression 2-60T, 1-574S
Date value
setting DBDATE environment
variable 4-21R
DATETIME data type
adding or subtracting INTERVAL
values 3-33R
as quoted string 1-626S
character string values 3-12R
converting to DATE 3-30R
CURRENT keyword 3-34R
displaying format 2-60T, 9-16T
field qualifiers 3-10R, 1-543S
formats with DBTIME 4-34R
functions on 2-56T
in
expression 1-556S
INSERT 1-627S
ORDER BY sequence 2-15T
relational expressions 2-30T
multiplying values 3-32R
precision and size 9-15T, 3-10R
range of expressions 3-31R
range of operations with DATE

and INTERVAL 3-30R
representing DATETIME values
3-34R
syntax 1-540S, 1-613S
using the DBTIME environment
variable 4-34R
with EXTEND function
3-32R, 3-33R
DATETIME Field Qualifier
segment 1-543S
Date, display with NLS 1-18R
DAY function
use
DAY keyword
syntax
in DATETIME data type 1-543S
in INTERVAL data type 1-610S
use
as DATETIME field qualifier
3-10R, 1-613S
as INTERVAL field qualifier
3-17R, 1-616S
DBA keyword
in GRANT 1-307S
in REVOKE 1-388S
DB-Access
creating database with
5-36T, 9-30T
UNLOAD statement 9-31T
DBANSIWARN environment
variable
5-11T, 4-18R, 1-124S, 1-130S, 1
-194S
DBAPICODE environment variable
1-19R, 4-19R
relation to crtcmap utility 5-5R
DBA-privileged procedure
12-16T, 1-111S
DBBLOBBUF environment variable
4-20R
DBDATE environment variable
4-9T, 9-14T, 4-21R
DBDELIMITER environment
variable 4-23R, 1-334S
DBEDIT environment variable

4-23R
dbexport utility
description of 5-9R
destination options 5-12R
editing the schema output 5-13R
Interrupt key 5-11R
specifying field delimiter with
DBDELIMITER 4-23R, 4-38R
unloading a database 5-10R
using with NLS 5-14R
dbimport utility
create options 5-20R
creating a database 5-16R
description of 5-15R
input file location options 5-18R
Interrupt key 5-17R
using with NLS 5-15R, 5-22R
DBINFO function
DBLANG environment variable
4-24R
dbload utility
creating a command file 5-29R
INSERT statement, compared to
SQL INSERT statement 5-37R
Interrupt key 5-26R
loading data from a command file
5-25R
loading data into a table 9-31T
options
bad-row limits 5-28R
batch size 5-28R
command-file syntax check
5-27R
load start point 5-27R
DBDELIMITER 4-23R
speed, increasing 5-24R
writing a command file in
character-position form 5-38R
writing a command file in
delimiter form 5-33R
DBMONEY environment variable
9-13T, 4-25R
DBMS. See Database management
system.
DBNLS environment variable

1-18R, 4-26R
DBPATH environment variable
11-16T, 4-28R, 1-199S, 1-538S
DBPRINT environment variable
4-31R
DBREMOTECMD environment
variable 4-32R
.dbs extension
1-95S, 1-152S, 1-199S
dbschema utility
create schema for a database
5-42R
options
obtaining privilege schema
5-44R
obtaining synonym schema
5-44R
specifying a table, view, or
procedure 5-46R
owner conventions 5-43R
use of 9-29T
DBSERVERNAME function
returning servername 1-554S
use
in SELECT 2-62T, 2-65T, 3-20T
dbspace
selecting with CREATE
DATABASE 9-24T
skipping if unavailable
5-11T, 1-440S
DBSPACETEMP environment
variable 4-33R
for locating temporary tables
1-151S
DBTEMP environment variable
4-34R
DBTIME environment variable
4-34R
DBUPSPACE environment variable
4-37R
DDL statements, summary 1-8S
Deadlock detection 7-18T, 1-468S
DEALLOCATE DESCRIPTOR
statement
syntax 1-201S
1-548S
DEC data type 3-12R
DECIMAL data type
disk storage 3-13R
fixed-point 9-12T
floating-point 9-11T, 3-13R
syntax 1-540S
DECIMAL data type, using as
default value 1-46S, 1-134S
Decimal point (.)
DECLARE statement
cursor characteristics 1-208S
cursor types 1-206S
cursors with prepared statements
1-214S
cursors with transactions 1-215S
definition and use
hold cursor 1-209S
insert cursor 1-208S, 1-216S
procedure cursor 1-207S
scroll cursor 1-208S
select cursor 1-207S
sequential cursor 1-208S
update cursor 1-207S, 1-211S
FOR INSERT clause 6-9T
FOR UPDATE 6-15T
insert cursor 1-206S
insert cursor with hold 1-217S
procedure cursor 1-206S
restrictions with SELECT with
ORDER BY 1-427S
SCROLL keyword 5-24T
syntax 1-203S
update cursor 1-206S
updating specified columns
1-212S
Index
11
use
1-548S
with FOR UPDATE keywords
1-207S
WITH HOLD clause 7-23T
with SELECT 1-406S
DEFAULT keyword 1-228S
in the CONNECT statement 1-80S
Default value
specifying
with ALTER TABLE 1-46S
with CREATE TABLE 1-134S
Defaults
column, in sysdefaults table 2-22R
Deferred checking 1-438S
DEFERRED keyword, in the SET
CONSTRAINTS statement
1-438S
DEFINE statement
in stored procedures 12-20T
placement of 2-11S
syntax 2-9S
DELETE keyword
syntax
in GRANT 1-308S
in REVOKE 1-386S
use
in GRANT 1-309S
in REVOKE 1-387S
Delete privilege
10-9T, 10-29T, 1-308S
DELETE REFERENCING clause
and FOR EACH ROW section
1-177S
syntax 1-175S
DELETE statement
all rows of table 4-4T
and end of data 6-14T
applied to view 10-25T
as triggering statement 1-167S
cascading 1-219S
coordinated deletes 6-6T
count of rows 6-4T
CURRENT OF clause 1-220S
description of 4-4T
embedded 5-7T, 6-3T to 6-8T
in trigger event 1-166S
12

number of rows 5-13T
preparing 5-31T
privilege for 10-6T, 10-9T, 1-308S
syntax 1-218S
transactions with 6-5T
using subquery 4-6T
WHERE clause restricted 4-6T
with Condition segment 1-517S
with cursor 6-7T, 1-211S
with select..for update 1-427S
within a transaction 1-218S
DELIMIDENT environment
variable 4-38R
Delimited identifier
defined 1-595S
setting DELIMIDENT
syntax 1-594S
Delimiter
for DATETIME values 3-11R
for INTERVAL values 3-18R
for LOAD input file 1-334S
specifying with UNLOAD 1-488S
Delimiter form of FILE and INSERT
statements 5-30R
DELIMITER keyword
in LOAD 1-334S
in UNLOAD 1-488S
Demonstration database
copying
Intro-10T, Intro-12R, Intro-14
S
installation script
map of 57
overview
structure of tables 52
tables in 52 to 57
Derived data
produced by view 10-21T
DESC keyword 1-425S
syntax
in SELECT 1-423S
use
in SELECT 1-425S
Descending order in SELECT 2-15T

DESCRIBE statement
variable 4-17R
and the USING SQL
DESCRIPTOR clause 1-224S
describing statement type
5-34T, 1-222S
INTO sqlda pointer clause 1-225S
relation to GET DESCRIPTOR
1-281S
syntax 1-221S
using with concatenation operator
1-548S
values returned by SELECT
1-223S
Descriptor 1-224S
Detached index 1-104S
Determining ANSI-compliance
1-11R
Device
optical 11-6T
storage 11-6T
Diamond symbol, used with
product icons Intro-10S
Directory, extension, .dbs
1-95S, 1-199S
Dirty Read isolation level 1-464S
Dirty Read isolation level
(Informix) 7-12T
DIRTY READ keywords, syntax in
SET ISOLATION 1-463S
ALL keyword 1-229S
CURRENT keyword 1-228S
with
concatenation operator 1-548S
Disk space
specifying for data distributions
4-37R
Display label
in ORDER BY clause 2-52T
syntax in SELECT 1-397S
with SELECT 2-50T
Display schema for a database
5-42R
DISTINCT keyword
relation to GROUP BY 3-4T
10-25T
syntax
in SELECT 1-397S
use
in SELECT 2-19T, 1-399S
no effect in subquery 1-528S
with COUNT function 2-54T
DISTINCT, synonym for UNIQUE
1-48S
Distributed deadlock 7-18T
Distributed processing 11-10T
Distribution scheme
changing the number of
fragments 9-38T
Distributions
dropping with DROP
DISTRIBUTIONS clause
1-507S
privileges required to create
1-508S
using the HIGH keyword 1-508S
using the MEDIUM keyword
1-508S
Division (/) symbol, arithmetic
operator 1-546S
DML statements, summary 1-9S
DOCUMENT keyword, use in
stored procedures 12-7T
Documentation comments vR
Documentation notes
Dominant table 3-21T
Dormant connection 1-229S
DOS operating system 11-5T
DROP AUDIT statement 1-230S
DROP CONSTRAINT keywords
DROP DATABASE statement
1-231S
DROP INDEX statement
locks table 7-8T
syntax 1-233S
DROP keyword
DROP ROWIDS clause, of ALTER
TABLE 9-41T
DROP SYNONYM statement
1-236S
DROP TABLE statement 1-238S
DROP TRIGGER statement
syntax 1-240S
use of 1-240S
DROP VIEW statement 1-242S
Dropping a fragment 9-39T
Duplicate values
finding 3-16T
in a query 1-399S
Dynamic management statements
1-9S
Dynamic SQL
cursor use with 5-33T
freeing prepared statements 5-35T
E
Editor, specifying with DBEDIT
4-23R
Effective checking 1-438S
Ellipses (...), wildcard in Condition
segment 1-525S
Embedded SQL
defined 5-4T
languages available 5-4T
End of data
signal in SQLCODE 5-12T, 5-18T
signal only for SELECT 6-14T
when opening cursor 5-21T
Entity
attributes associated with 8-16T
business rules 8-5T
criteria for choosing 8-8T
defined 8-5T
important qualities of 8-5T
in telephone-directory example
8-8T
integrity 4-18T
naming 8-5T
represented by a table 8-24T
Entity occurrence, defined 8-18T

Entity-relationship diagram
connectivity 8-19T
discussed 8-19T
meaning of symbols 8-19T
reading 8-20T
ENVIGNORE environment
variable 4-7R, 4-38R
relation to chkenv utility 5-4R
Environment configuration file
debugging with chkenv 5-4R
example 4-6R
Environment variable
ARC_DEFAULT 4-15R
ARC_KEYPAD 4-15R
COLLCHAR 4-16R
DBANSIWARN 4-18R
DBAPICODE 4-19R
DBAPICODE, and crtcmap utility
5-5R
DBBLOBBUF 4-20R
DBDATE 4-21R
DBDELIMITER 4-23R
DBEDIT 4-23R
DBLANG 4-24R
DBLANG, and crtcmap utility
5-5R
DBMONEY 4-25R
DBNLS 4-26R
DBPATH 11-16T, 4-28R
DBPRINT 4-31R
DBREMOTECMD 4-32R
DBSPACETEMP 4-33R
DBTEMP 4-34R
DBTIME 4-34R
DBUPSPACE 4-37R
defining in environment
configuration file 4-6R
definition of 4-5R
DELIMIDENT 4-38R
ENVIGNORE 4-38R
ENVIGNORE, and chkenv utility
5-4R
FET_BUF_SIZE 4-39R
how to set in Bourne shell 4-8R
how to set in C shell 4-8R
how to set in Korn shell 4-8R
INFORMIXC 4-40R
INFORMIXCOB 4-40R
Index
13
INFORMIXCOBDIR 4-41R
INFORMIXCOBSTORE 4-42R
INFORMIXCOBTYPE 4-43R
INFORMIXCONRETRY 4-43R
INFORMIXCONTIME 4-44R
INFORMIXDIR 11-16T, 4-46R
INFORMIXSERVER
11-16T, 4-46R
INFORMIXSHMBASE 4-47R
INFORMIXSTACKSIZE 4-48R
INFORMIXTERM 4-49R
LANG 1-23R, 4-49R
LANG, and crtcmap utility 5-5R
LC_COLLATE 4-51R
LC_CTYPE 4-53R
LC_MONETARY 4-55R
LC_NUMERIC 4-56R
LC_TIME 4-57R
listed, by topic 4-68R
modifying 4-9R
ONCONFIG 4-59R
OPTCOMPIND 4-59R
overriding a setting 4-7R, 4-38R
PATH 11-16T, 4-60R
PDQPRIORITY 4-61R
PSORT_DBTEMP 4-62R
PSORT_NPROCS 4-63R
rules of precedence 4-10R
setting
at the command line 4-6R
in a login file 4-6R
in a shell file 4-7R
in an environmentconfiguration file 4-6R
SQLEXEC 4-64R
SQLRM 4-65R
SQLRMDIR 4-65R
TERM 4-66R
TERMCAP 11-16T, 4-66R
TERMINFO 4-67R
types of 4-5R
view current setting 4-9R
where to set 4-7R
Equals (=) relational operator
2-30T, 2-71T
Equi-join 2-71T
ERROR 1-513S
14
Error checking
continuing after error in stored
procedure 2-39S
error status with ON EXCEPTION
2-36S
exception handling 12-31T
in stored procedures 12-31T
simulating errors 12-34T
with SYSTEM 2-46S
ERROR keyword, in the
WHENEVER statement 1-510S
Error messages
for NLS 1-24R
for trigger failure 13-14T
generating in a trigger 13-13T
retrieving trigger text in a
program 13-15T, 13-16T
using to identify NLS database
server 1-21R
Errors
after DELETE 6-4T
at compile time 12-7T
codes for 5-13T
dealing with 5-18T
detected on opening cursor 5-21T
during updates 4-23T
in stored procedure syntax 12-8T
inserting with a cursor 6-11T
ISAM error code 5-13T
ESCAPE keyword
1-519S
use
with LIKE keyword
1-413S, 1-525S
with MATCHES keyword
1-414S, 1-526S
with WHERE keyword
2-45T, 1-413S
ESQL
cursor use 5-20T to 5-29T
DELETE statement in 6-3T
delimiting host variables 5-7T
dynamic embedding 5-5T, 5-30T
error handling 5-18T
fetching rows from cursor 5-22T
host variable 5-6T, 5-8T
indicator variable 5-17T
INSERT in 6-8T
NLS errors in SQLERRM field
1-21R
overview
5-3T to 5-39T, 6-3T to 6-18T
preprocessor 5-4T
scroll cursor 5-24T
selecting single rows 5-14T
SQL Communications Area 5-9T
SQLCODE 5-12T
SQLERRD fields 5-13T
static embedding 5-5T
UPDATE in 6-15T
EXCLUSIVE keyword
syntax
in DATABASE 1-198S
in LOCK TABLE 1-336S
use
in DATABASE 1-200S
Exclusive lock 7-6T
Executable programs
where to search 4-60R
EXECUTE IMMEDIATE statement
restricted statement types 1-254S
syntax and usage 1-253S
using with concatenation operator
1-548S
EXECUTE ON keywords
syntax
in GRANT 1-304S
in REVOKE 1-384S
use
in GRANT 1-311S
in REVOKE 1-385S
EXECUTE PROCEDURE statement
1-256S
associating cursor with
DECLARE 1-207S
in FOREACH 2-23S
using 12-11T
with
INTO keyword 1-266S
EXECUTE statement
and sqlca record 1-246S
parameterizing a statement
1-247S
syntax 1-244S
USING DESCRIPTOR clause
1-249S
1-548S
with USING keyword 1-246S
Existence dependency 8-10T
EXISTS keyword
beginning a subquery 1-415S
in a WHERE clause 3-32T
use in condition subquery
10-28T, 1-529S
EXIT statement
syntax 2-17S
EXP function
Explicit temporary table 1-150S
Exponential function
EXP function 1-570S
Expression
date-oriented 2-56T
display label for 2-50T
in UPDATE 1-497S
ordering by 1-426S
Expression segment
aggregate expressions 1-583S
column expressions 1-548S
combined expressions 1-589S
constant expressions 1-551S
expression types 1-546S
function expressions 1-558S
in SPL expressions 1-589S
syntax 1-546S
Expression-based distribution
scheme
in ALTER FRAGMENT 1-29S
in CREATE INDEX 1-105S
EXTEND function
with DATE, DATETIME and
INTERVAL
2-56T, 2-60T, 3-32R, 3-33R
extension
.lok 1-468S
Extension checking, specifying with
DBANSIWARN 4-18R
Extension, to SQL
symbol for Intro-8S
with ANSI-compliant database
1-16R
EXTENT SIZE keywords 1-162S
Extent, changing size of system
table 2-11R
F
FETCH statement
ABSOLUTE keyword 5-24T
as affected by CLOSE 1-72S
checking results with SQLCA
1-270S
fetching a row for update 1-269S
locking for update 1-269S
relation to GET DESCRIPTOR
1-278S
sequential 5-24T
specifying a values memory
location 1-265S
syntax 1-260S
with
concatenation operator 1-548S
program arrays 1-267S
scroll cursor 1-264S
sequential cursor 5-26T, 1-263S
X/Open mode 1-263S
FET_BUF_SIZE environment
variable 4-39R
Field delimiter files
DBDELIMITER 4-23R
Field qualifier
for DATETIME 3-10R, 1-543S
for INTERVAL 1-610S, 1-616S
File
compared to database 1-3T
environment configuration 4-6R
environment configuration,
checking with chkenv 5-4R
extension
.lok 1-468S
mapping, and COLLCHAR 4-16R
mapping, and crtcmap utility 5-5R
mapping, and DBAPICODE
4-19R
mapping, format for 5-7R
permissions in UNIX 10-4T
sending output with the OUTPUT
statement 1-349S
shell 4-7R
temporary for OnLine 4-33R
temporary for SE 4-34R
temporary, sorting 4-62R
termcap, terminfo 4-49R, 4-66R
FILE statement
syntax for character-position form
5-36R
syntax for delimiter form 5-31R
with dbload 5-29R
Files
termcap, terminfo 4-67R
FILLFACTOR clause in CREATE
INDEX 1-108S
finding location of row 1-550S
FIRST keyword
use in FETCH 1-264S
First normal form 8-32T
Fixed point 9-12T
FLOAT data type
syntax 1-540S
FLOAT data type, using as default
value 1-46S, 1-134S
Floating point 9-10T
Index
15
FLUSH statement
count of rows inserted 6-11T
syntax 1-272S
1-548S
writing rows to buffer 6-10T
FOR EACH ROW action
SELECT statement in 1-173S
triggered action list 1-172S
FOR keyword
in CONTINUE 2-8S
in CREATE AUDIT 1-92S
in CREATE SYNONYM 1-125S
in EXIT 2-17S
FOR statement
looping in a stored procedure
12-26T
specifying multiple ranges 2-22S
syntax 2-19S
using expression lists 2-22S
using increments 2-21S
FOR TABLE keywords, in UPDATE
STATISTICS 1-503S
FOR UPDATE keywords
conflicts with ORDER BY 6-8T
not needed in ANSI-compliant
database 6-16T
relation to UPDATE 1-500S
specific columns 6-16T
syntax in DECLARE 1-203S
use
in DECLARE
1-207S, 1-211S, 1-214S
in SELECT 1-427S
with column list 1-212S
FOREACH keyword
in CONTINUE statement 2-8S
in EXIT 2-17S
FOREACH statement
12-26T
syntax 2-23S
Foreign key
4-20T, 1-51S, 1-141S, 1-144S
FOREIGN KEY keywords
16
Format
for crtcmap mapping file 5-7R
specifying for DATE value with
DBDATE 4-21R
specifying for DATETIME value
with DBTIME 4-34R
specifying for money format with
DBMONEY 4-25R
FRACTION keyword
syntax
use
3-10R, 1-613S
3-17R, 1-616S
Fragment
altering 9-37T
dropping 9-39T
modifying with ALTER
FRAGMENT 1-17S
Fragmentation
adding a fragment 1-31S
adding rowids with ALTER
TABLE 1-65S
adding rowids with CREATE
TABLE 1-157S
altering fragments 1-17S
alter, attaching tables 1-19S
and BLOB columns 1-23S
combining tables 1-19S
defining a new fragmentation
strategy 1-19S
defining and initializing 1-24S
described 1-5R
detaching a table fragment 1-36S
dropping an existing fragment
1-33S
dropping rowids with ALTER
TABLE 1-66S
expression-based distribution
scheme 1-29S, 1-105S, 1-161S
fragment expressions
1-23S, 1-29S, 1-106S
if you run out of log/disk space
1-19S
indexes, by expression with
CREATE INDEX 1-105S
information in sysframents table

2-25R
modifying an existing fragment
expression 1-34S
modifying indexes 1-36S
number of rows in fragment 1-19S
reinitializing fragmentation
strategy 1-24S
reinitializing strategy with INIT
clause 1-26S
remainder 1-33S
round robin 1-29S
round-robin distribution scheme
1-160S
rowid 1-29S
rules 1-161S
setting priority levels for PDQ
4-61R, 1-474S
skipping an unavailable dbspace
1-440S
tables, syntax 1-159S
Fragmentation strategy
modifying 9-36T
Fragmented table
accessing data 9-39T
created from multiple nonfragmented table 9-34T
creating 9-34T
creating from one nonfragmented table 9-35T
how to create 9-33T
modifying 9-36T
use of rowid 9-40T
using primary keys 3-16T, 9-39T
FREE statement
effect on cursors 1-348S
freeing prepared statements 5-35T
syntax 1-275S
1-548S
FROM keyword
alias names 2-79T
syntax
in PUT 1-364S
in REVOKE 1-384S
in SELECT 1-395S
use
in PUT 1-368S
in SELECT 1-408S
Function
aggregate 2-53T
algebraic 1-560S
date-oriented 2-56T
in SELECT statements 2-53T
within a stored procedure 12-26T
Function expression
Algebraic functions 1-558S
DBINFO function 1-566S
Exponential and logarithmic
functions 1-558S
HEX function 1-558S
in SELECT 1-400S
LENGTH function 1-558S
Time functions 1-558S
Trigonometric functions 1-558S
TRIM function 1-558S
Functional dependency 8-33T
G
GET DESCRIPTOR statement
syntax 1-278S
the COUNT keyword 1-280S
use with FETCH statement 1-268S
1-548S
X/Open mode 1-281S
GET DIAGNOSTICS statement
CLASS_ORIGIN keyword 1-295S
CONNECTION_NAME
keyword 1-298S
exception clause 1-293S
MESSAGE_LENGTH keyword
1-295S
MESSAGE_TEXT keyword 1-295S
MORE keyword 1-292S
NUMBER keyword 1-292S
purpose 1-285S
RETURNED_SQLSTATE
keyword 1-295S
ROW_COUNT keyword 1-292S
SERVER_NAME keyword 1-295S

SQLSTATE codes 1-287S
statement clause 1-291S
keywords 1-291S
SUBCLASS_ORIGIN keyword
1-295S
syntax 1-285S
Global transaction 11-23T
GOTO keyword, in the
GRANT statement
automated 10-13T
changing grantor 1-312S
creating a privilege chain 1-311S
database-level privileges
10-6T, 1-306S
default table privileges 1-310S
in 4GL 10-14T
in embedded SQL 5-36T to 5-39T
privileges on a view 1-313S
syntax 1-304S
table-level privileges
10-8T, 1-309S
GROUP BY clause 1-181S
GROUP BY keywords
column number with 3-7T
description of 3-4T
10-25T
Hold cursor
insert cursor with hold 1-217S
use of 1-209S
Host machine 11-9T
Host variable
delimiter for 5-7T
description of 5-6T
dynamic allocation of 5-34T
fetching data into 5-22T
in DELETE statement 6-4T
in INSERT 6-8T
in UPDATE 6-15T
in WHERE clause 5-15T
INTO keyword sets 5-15T
null indicator 5-17T
restrictions in prepared statement
5-30T
truncation signalled 5-13T
using non-English characters in
1-25R
with EXECUTE 5-32T
HOUR keyword
syntax
use
3-10R, 1-613S
3-17R, 1-616S
Hyphen (-)
Hash rule 1-30S, 1-107S, 1-161S

HAVING keyword
description of 3-8T
Header, of a procedure 12-28T
HEX function 1-550S
HIGH keyword 1-472S
Icon, explanation of Intro-7S

IDATA field
SET DESCRIPTOR statement
1-452S
with X/Open programs 1-281S
Identifier segment
column names 1-601S
column naming, allowable
characters 1-591S
cursor name 1-603S, 1-606S
database objects that use 1-591S
Index
17
stored procedures 1-603S

syntax 1-591S
table names 1-600S, 1-602S
using keywords as column names
1-597S
variable name 1-605S
IF statement
branching 12-25T
syntax 2-27S
with null values 2-29S
ILENGTH field
1-452S
IMMEDIATE keyword, in the SET
CONSTRAINTS statement
1-438S
Implicit connection
defined 1-80S
with DISCONNECT 1-228S
Implicit temporary table 1-151S
IN keyword
syntax
in CREATE AUDIT 1-92S
in CREATE DATABASE 1-94S
use
in Condition subquery 1-528S
with WHERE keyword 1-412S
used to test for equality in
WHERE clause 2-29T
IN relational operator 3-32T
Index
allowable characters in index
name 1-591S
attached, defined 1-104S
building with NLS 1-23R
clustered fragments 1-102S
converting during upgrade
1-502S, 1-506S
creating fragments 1-105S
creating with CREATE INDEX
1-99S
descriptions in sysindexes table
2-26R
detached 1-104S
18
displaying information for 1-316S

dropping with DROP INDEX
1-233S
effected with ALTER
FRAGMENT ATTACH 1-21S
effects on altered fragments 1-24S
locks table 7-8T
naming conventions
1-534S, 1-591S, 1-609S, 1-634
S
provide for expansion 1-108S
sharing with constraints 1-131S
sorting with NLS 1-17R
surviving 1-17S
unique, restrictions 1-27S
with temporary tables 1-430S
with unique and referential
constraints 1-108S
INDEX keyword
syntax
in GRANT 1-308S
in REVOKE 1-386S
use
in GRANT 1-310S
in REVOKE 1-387S
Index Name segment
syntax 1-533S, 1-621S
use 1-632S
Index privilege 10-10T, 1-310S
INDEXES FOR keywords, in INFO
statement 1-316S
Indexes, with dbload utility 5-26R
INDICATOR field
1-453S
INDICATOR keyword, in SELECT
1-405S, 1-406S
Indicator variable
definition of 5-17T
in SELECT 1-405S, 1-406S
using non-English characters in
1-25R
INFO statement
displaying privileges and status
1-316S
displaying tables, columns, and
indexes 1-315S
syntax 1-314S
Information Schema views

accessing 2-48R
columns view 2-49R
generating 2-47R
server_info view 2-51R
sql_languages view 2-51R
tables view 2-49R
informix
environment configuration file
4-6R
privileges associated with user
1-307S
Informix corporate address vR
Informix extension checking,
specifying with DBANSIWARN
4-18R
INFORMIX-4GL 11-6T
detecting null value 5-17T
example of dynamic SQL 10-14T
indicator variable not used 5-17T
program variable 5-6T
STATUS variable 5-12T
terminates on errors 5-38T, 6-14T
using SQLCODE with 5-12T
WHENEVER ERROR statement
5-38T
INFORMIXC environment variable
4-40R
INFORMIXCOB environment
variable 4-40R
INFORMIXCOBDIR environment
variable 4-41R
INFORMIXCOBSTORE
INFORMIXCOBTYPE environment
variable 4-43R
INFORMIXCONRETRY
INFORMIXCONTIME
INFORMIXDIR environment
variable 11-16T, 4-46R
INFORMIX-OnLine Dynamic
Server
allows views on external tables
10-24T
and triggering statement 1-167S
archiving 4-28T
characteristics of 1-11T
creating demonstration database
Intro-12R, Intro-14S
is NLS-ready 1-17R
when tables are locked 7-8T
INFORMIX-OnLine/Optical 11-6T
list of statements 1-11S
INFORMIX-SE
characteristics of 1-10T
creating database 9-25T
creating demonstration database
Intro-12R, Intro-14S
is NLS-ready 1-17R
INFORMIXSERVER environment
variable 11-16T, 4-46R, 1-80S
INFORMIXSHMBASE
INFORMIX-SQL
creating database with
5-36T, 9-30T
UNLOAD statement 9-30T
INFORMIXSTACKSIZE
INFORMIXTERM environment
variable 4-49R
informix.rc file 4-6R
Insert buffer
counting inserted rows
1-274S, 1-371S
filling with constant values 1-366S
inserting rows with a cursor
1-322S
storing rows with PUT 1-365S
triggering flushing 1-370S
Insert cursor 1-206S
closing 1-72S
in INSERT 1-322S
in PUT 1-367S
opening 1-343S
reopening 1-344S
result of CLOSE in SQLCA 1-72S
use of 6-11T, 1-208S
with hold 1-217S
INSERT INTO keywords
in INSERT 1-319S
in LOAD 1-334S
INSERT keyword
syntax
in GRANT 1-308S
in REVOKE 1-386S
use
in GRANT 1-309S
in REVOKE 1-387S
Insert privilege 10-9T, 10-29T
INSERT REFERENCING clause
1-177S
syntax 1-174S
INSERT STATEMENT
using functions in the VALUES
clause 1-326S
INSERT statement
constant data with 6-11T
duplicate values in 4-8T
effect of transactions 1-323S
embedded 6-8T to 6-14T
filling insert buffer with PUT
1-365S
in dynamic SQL 1-328S
inserting
multiple rows 4-10T
nulls with the VALUES clause
1-327S
rows 4-7T
rows through a view 1-321S
rows with a cursor 1-322S
single rows 4-7T
values into SERIAL columns
3-23R
null values in 4-8T
privilege for 10-6T, 10-9T
SELECT statement in 4-10T
SERIAL columns 1-326S
specifying values to insert 1-324S
syntax 1-319S
for character position form
5-36R
for delimiter form 5-31R
use with insert cursor 1-216S
VALUES clause 4-7T
with
a view 10-26T
DECLARE 1-203S
SELECT 1-327S
with dbload 5-29R
Inserting rows of constant data
6-11T
Installation directory, specifying
with INFORMIXDIR 4-46R
Installation files
INFORMIXDIR environment
variable 4-46R
INTEGER data type
syntax 1-540S
INTEGER data type, using as
Integrity. See Data integrity.
Intensity attributes, setting
INFORMIXTERM for 4-49R
Interrupt key
with dbexport 5-11R
with dbimport 5-17R
with dbload 5-26R
Interrupted modifications 4-23T
INTERVAL data type
adding or subtracting from 3-36R
adding or subtracting from
DATETIME values 3-33R
as quoted string 1-626S
display format 9-16T
field delimiters 3-18R
field qualifier, syntax 1-610S
in INSERT 1-627S
in relational expressions 2-30T
multiplying or dividing values
3-36R
precision and size 9-16T
range of expressions 3-31R
Index
19
range of operations with DATE

and DATETIME 3-30R
syntax 1-540S, 1-616S
with EXTEND function
3-32R, 3-33R
INTERVAL Field Qualifier segment
1-610S
INTO keyword
choice of location 5-23T
in FETCH statement 5-23T
in SELECT 1-403S
mismatch signalled in
SQLAWARN 5-13T
restrictions in INSERT 4-11T
restrictions in prepared statement
5-30T
retrieving multiple rows 5-21T
retrieving single rows 5-15T
syntax
in FETCH 1-260S
in SELECT 1-395S
use
in FETCH 1-267S
in SELECT 1-403S
INTO TEMP keywords
restrictions in view 10-23T
use
in SELECT 1-429S
IS keyword
with WHERE keyword 1-413S
IS NOT keywords, syntax in
Condition segment 1-519S
IS NULL keywords 1-413S
ISAM error code
5-13T, 2-35S, 2-41S
Isolation level
ANSI Read Committed 7-13T
ANSI Read Uncommitted 7-12T
ANSI Repeatable Read 7-15T
ANSI Serializable 7-15T
Committed Read 1-464S
Cursor Stability 1-464S
default in ANSI-compliant
database 1-14R
definitions 1-464S, 1-478S
20
Dirty Read 1-464S
in external tables 1-465S, 1-476S
Informix Committed Read 7-13T
Informix Cursor Stability 7-13T
Informix Dirty Read 7-12T
Informix Repeatable Read 7-15T
Read Committed 1-479S
Read Uncommitted 1-478S
Repeatable Read 1-464S, 1-479S
Serializable 1-479S
setting 7-11T
use with FETCH statement 1-269S
items table in stores7 database,
columns in 54
ITYPE field
1-452S
1-453S
J
Join
associative 2-76T
creating 2-71T
definition of 2-9T
dominant table 3-21T
equi-join 2-71T
multiple-table join 2-77T, 1-418S
natural 2-75T
nested outer 3-27T
nested simple 3-24T
outer 3-21T
outer join 1-419S
10-25T
self-join 3-11T, 1-418S
subservient table 3-21T
two-table join 1-418S
Join column. See Foreign key.
K
Key lock 7-9T
Keywords, using in triggered action
1-180S
Key, composite 8-25T
Key, primary 8-25T
Korn shell
4-8R
.profile file 4-7R
L
Label 2-50T, 3-45T
LANG environment variable
1-18R, 1-23R, 4-49R
Language environment
DBLANG 4-24R
selecting with LANG
setting with DBLANG 4-24R
Language supplement for added
NLS functionality 1-26R
LAST keyword
use in FETCH 1-264S
LC_CTYPE environment variable
1-19R, 4-53R
LC_MONETARY environment
LC_NUMERIC environment
LC_TIME environment variable
1-19R, 4-57R
LENGTH field
1-452S
with DATETIME and INTERVAL
types 1-453S
with DECIMAL and MONEY
types 1-453S
LENGTH function
on TEXT 2-63T
on VARCHAR 2-63T
syntax in expression
1-558S, 1-572S
use in expression 2-62T, 1-572S
LET statement
assigning values 12-24T
executing a procedure 12-11T
syntax 2-32S
LIKE keyword
1-519S
wildcard characters 1-413S
LIKE keyword, used to test for
equality in WHERE clause 2-29T
LIKE relational operator 2-38T
Literal
DATETIME
in expression 1-551S, 1-556S
segment 1-613S
syntax 1-613S
syntax in INSERT 1-324S
DATE, using as a default value
1-46S, 1-134S
INTERVAL
segment 1-616S
syntax 1-616S
using as default value
1-46S, 1-134S
Number
segment 1-619S
syntax 1-619S
LOAD statement
DELIMITER clause 1-334S
INSERT INTO clause 1-334S
loading VARCHAR, TEXT, or
BYTE data types 1-333S
DBDELIMITER 4-23R
specifying the table to load into

1-334S
syntax 1-329S
the LOAD FROM file 1-331S
Loading data from a command file
into a table 5-25R
Local loopback 11-10T
Local server 11-6T
Locale
converting the format of numeric
data 4-57R
LOCK MODE keywords
syntax
use
LOCK TABLE statement
in databases with transactions
1-337S
in databases without transactions
1-338S
locking a table explicitly 7-8T
syntax 1-336S
Locking
and concurrency 4-29T
and integrity 7-3T
deadlock 7-18T
description of 7-6T
during
delete 1-218S
inserts 1-323S
updates 1-212S, 1-494S
granularity 7-7T
in OnLine 1-6R
in SE 1-6R
lock duration 7-9T
lock mode 7-17T
not-wait 7-17T
wait 7-17T
locks released at end of
transaction 7-22T
mode 1-6R
overriding row-level 1-337S
releasing with COMMIT WORK
1-77S
releasing with ROLLBACK
WORK 1-391S
scope 7-7T, 1-6R

scope of lock 7-7T
setting lock mode 7-17T
shared locks 1-7R
types of locks
database lock 7-7T
exclusive lock 7-6T
key lock 7-9T
page lock 7-9T, 1-163S
promotable lock 7-6T, 7-10T
row lock 7-9T, 1-163S
shared lock 7-6T
table lock 7-8T
update cursors effect on 1-212S
update locks 1-494S
waiting period 1-468S
with
DELETE 6-4T
FETCH 1-269S
SET ISOLATION 1-463S
SET LOCK MODE 1-467S
SET TRANSACTION 1-476S
UNLOCK TABLE 1-489S
update cursor 7-10T
within transaction 1-67S
LOG IN keywords, syntax in
CREATE DATABASE 1-94S
LOG10 function
Logarithmic function
syntax
LOG10 function 1-569S
LOGN function 1-569S
use
LOG10 function 1-570S
LOGN function 1-570S
Logging
buffered 9-25T
buffered vs. unbuffered 1-470S
cascading deletes 1-53S, 1-147S
changing mode with SET LOG
1-470S
choosing for OnLine database
server 9-25T
choosing for SE database server
9-25T
finding log file location 1-98S
renaming log 1-483S
Index
21
setting with CREATE TABLE

1-156S
starting with START DATABASE
1-97S, 1-482S
stopping 1-483S
stopping with START
DATABASE 1-482S
unbuffered 9-25T
with INFORMIX-OnLine 1-96S
with INFORMIX-SE 1-97S
with triggers 1-190S
Logical log
definition of 4-27T
Logical operator
AND 2-37T
NOT 2-37T
OR 2-37T
LOGN function
.lok extension 1-468S
Loop
controlled 2-19S
creating and exiting in SPL 12-26T
exiting using RAISE exception
12-35T
indefinite with WHILE 2-51S
Loopback, local 11-10T
LOW keyword 1-472S
M
Machine notes
Mail
sending from stored procedure
2-46S
Mandatory, entity in relationship
8-10T
Many-to-many relationship
8-10T, 8-12T, 8-29T
Mapping files
COLLCHAR 4-16R
DBAPICODE 4-19R
Mapping files for non-standard
code sets 5-5R
22
MATCHES keyword
1-519S
use
in SELECT 1-413S
with NLS 2-43T
used to test for equality in
WHERE clause 2-29T
wildcard characters 1-414S
MATCHES relational operator
in WHERE clause 2-38T
MAX function
MDY function
Memory
allocating for a system sqlda
structure 1-14S
shared 11-8T
Message files
error messages
setting LANG for NLS 4-49R
specifying subdirectory for NLS
1-25R
specifying subdirectory with
DBLANG 4-24R
MIN function
Minus (-) sign, arithmetic operator
1-546S
MINUTE keyword
syntax
use
3-10R, 1-613S
3-17R, 1-616S
MOD function
MODE ANSI keywords

ANSI-compliant database 1-17T
ANSI-compliant logging 9-25T
specifying ANSI-compliance
1-12R
specifying transactions 4-26T
syntax
in START DATABASE 1-482S
use
Model. See Data model.
MODIFY clause of ALTER
FRAGMENT 9-36T
MODIFY keyword
MODIFY NEXT SIZE keywords
Modifying a fragmentation strategy
9-36T
Modifying fragmented tables 9-36T
MONEY data type 9-13T
display format 9-13T
in INSERT 4-8T
syntax 1-540S
MONEY data type, using as default
value 1-46S, 1-134S
Money display format
specifying for NLS 4-56R
specifying format with
LC_MONETARY 4-55R
specifying with DBMONEY
4-25R, 4-26R
Money value display, affected by
NLS 1-17R
MONTH function
MONTH keyword
syntax
use
3-10R, 1-613S
3-17R, 1-616S
Multiple triggers
column numbers in 1-170S
example 1-169S
order of execution 1-170S
preventing overriding 1-189S
Multiple-table join 2-77T
Multi-row query
destination of returned values
1-265S
managing with FETCH 1-262S
N
Naming convention
column 1-377S
database 1-537S
index 1-534S, 1-609S, 1-634S
table 1-129S, 1-592S, 1-637S
Naming conventions
tables 11-18T
Native Language Support. See NLS.
Natural join 2-75T
NCHAR data type
nonprintable characters 3-21R
syntax 1-540S
versus CHAR data type 1-22R
Nested ordering, in SELECT
2-16T, 1-426S
Network
computer 11-4T
connection information 11-17T
site 11-4T
Network environment variable
DBPATH 4-28R
SQLRM 4-65R
SQLRMDIR 4-65R
New features
for Version 7.1 Intro-12T
NEW keyword
in DELETE REFERENCING
clause 1-175S
in INSERT REFERENCING clause
1-174S
in UPDATE REFERENCING
clause 1-177S
NEXT keyword
use in FETCH 1-264S
NEXT SIZE keywords, use in
CREATE TABLE 1-162S
NLS
activating 2-25T, 4-26R
activating in Informix products
1-18R
and collation order 2-25T
and dbexport utility 5-14R
and dbimport utility 5-15R
and MATCHES keyword 2-43T
and ORDER BY keywords
2-25T, 2-43T
character attributes 4-53R
checking products for
functionality 1-21R
code sets 4-19R
collation 4-16R
COLLCHAR environment
variable 4-16R
creating character mapping files
for 5-5R
data types for 1-22R
database server compatibility
1-22R
Date and time formats 4-57R
DBAPICODE environment
variable 4-19R
DBNLS environment variable
4-26R
error messages for incompatibility
1-24R
functionality in Informix products
1-25R, 1-26R
functionality listed 1-17R
information in systables 2-42R
installation notes for language
supplement 1-26R
LANG environment variable

4-49R
language, locale setting 4-49R
variable 4-51R
LC_CTYPE environment variable
4-53R
LC_MONETARY environment
variable 4-55R
LC_NUMERIC environment
variable 4-56R
LC_TIME environment variable
4-57R
NCHAR data type 3-20R
numeric values 4-56R
NVARCHAR data type 3-21R
populating with dbimport 5-22R
setting environment variables
1-18R, 4-50R, 4-51R, 4-53R,
4-55R, 4-56R, 4-57R
specifying a language
environment 2-25T
viewing characteristics of 1-21R
NLS database
versus non-NLS database 1-22R
Nondecomposable attributes 8-17T
Nonprintable characters
with CHAR data type 3-7R
with NCHAR data type 3-21R
with NVARCHAR 3-22R
with TEXT 3-26R
with VARCHAR data type 3-27R
Normal form 8-31T
Normalization
benefits 8-31T
first normal form 8-32T
of data model 8-31T
rules 8-31T
rules, summary 8-35T
second normal form 8-33T
third normal form 8-34T
NOT CLUSTER keywords
syntax in ALTER INDEX 1-39S
NOT FOUND keywords, in the
WHENEVER statement
1-510S, 1-513S
Index
23
NOT IN keywords, use in

Condition subquery 1-528S
NOT keyword
syntax
in Condition segment
1-517S, 1-519S
1-412S
use
with LIKE, MATCHES
keywords 1-413S
NOT logical operator 2-37T
NOT NULL keywords
syntax
use
in CREATE TABLE
9-27T, 1-136S
NOT operator
condition 1-518S
NOT relational operator 2-33T
NOT WAIT keywords, in SET
LOCK MODE 1-467S
NULL keyword, ambiguous as
procedure variable 1-604S
NULL relational operator 2-36T
NULL value
testing in BYTE expression 3-5R
testing with TEXT data type 3-25R
Null value
checking for in SELECT
1-247S, 1-250S
defined 9-22T
detecting in ESQL 5-17T
in columns, status in syscolumns
table 2-17R
in INSERT statement 4-8T
in SPL IF statement 2-29S
inserting with the VALUES clause
1-327S
restrictions in primary key 8-25T
returned implicitly by stored
procedure 2-42S
testing for 2-36T
24
updating a column 1-498S

used in Condition with NOT
operator 1-518S
used in the ORDER BY clause
1-425S
with logical operator 2-37T
with SPL WHILE statement 2-51S
Null value, specifying as default
value 1-47S
Number of fragments, changing
9-38T
NUMERIC data type 3-21R
Numeric data type
converting to local format 4-57R
NVARCHAR data type
syntax 1-540S
versus VARCHAR data type
1-22R
O
OF keyword
use in DECLARE 1-212S
OLD keyword
in DELETE REFERENCING
clause 1-175S
in INSERT REFERENCING clause
1-174S
in UPDATE REFERENCING
clause 1-177S
ON DELETE CASCADE keyword
DELETE trigger event 1-167S
ON EXCEPTION statement
placement of 2-36S
scope of control 12-32T
syntax 2-35S
trapping errors 12-31T
user-generated errors 12-34T
ON keyword
syntax
in GRANT 1-304S
in REVOKE 1-384S
use
in GRANT 1-310S

ONCONFIG environment variable
4-59R
One-to-many relationship
8-10T, 8-12T
One-to-one relationship
8-10T, 8-12T
On-line
files
onload utility 4-29T
onunload utility 4-29T
OPEN statement
activating a cursor 5-21T
constructing the active set 1-341S
opening a procedure cursor
1-342S
opening an insert cursor 1-343S
opening select or update cursors
5-22T, 1-341S
reopening a cursor 1-344S
substituting values for ?
parameters 1-345S
syntax 1-339S
1-548S
with FREE 1-348S
Opening a cursor 5-21T, 5-25T
Operating system
DOS 11-5T
UNIX 11-5T
OPTCOMPIND
environment variable, values
4-59R
Optical cluster, description in
sysopclstr table 2-29R
Optical device 11-6T
Optimization, specifying a high or
low level 1-472S
Optimizer
and SET OPTIMIZATION
statement 1-472S
with UPDATE STATISTICS
1-505S
Optimizing
a query 1-455S
a server 1-472S
across a network 1-473S
Optional, entity in relationship

8-10T
OR keyword
1-517S
use in Condition segment 1-531S
OR logical operator 2-37T
OR relational operator 2-34T
ORDER BY keywords
and NLS 2-25T
ascending order 2-15T, 1-425S
DESC keyword 2-15T, 2-24T
descending order 1-425S
display label with 2-52T
multiple columns 2-15T
relation to GROUP BY 3-7T
restrictions in INSERT
4-11T, 1-327S
restrictions with FOR UPDATE
6-8T
select columns by number
2-23T, 1-426S
sorting rows 2-14T
use
in SELECT 1-423S
Order of execution, of action
statements 1-179S
orders table in stores7 database,
columns in 53
Outer join
forming 1-409S
OUTER keyword, with FROM
keyword in SELECT 1-408S
Output from TRACE command
13-13T
OUTPUT statement, syntax and use
1-349S
Owner
in CREATE SYNONYM 1-125S
in dbschema 5-43R
in Index Name segment
1-533S, 1-608S, 1-621S,
1-633S
in RENAME COLUMN 1-377S
in RENAME TABLE 1-379S
in Table Name segment

1-591S, 1-636S
in View Name segment 1-640S
of view in CREATE VIEW 1-641S
Owner-privileged procedure
12-16T, 1-111S
Ownership 10-8T
P
PAGE keyword
Page lock 7-9T
Parallel distributed queries
SET PRIORITY statement 1-474S
setting with PDQPRIORITY
Parallel sorting 4-62R
setting PSORT_NPROCS 4-63R
Parameter
BYTE or TEXT in SPL 2-16S
in CALL statement 2-6S
to a stored procedure 12-28T
parameterizing
defined 1-247S
prepared statements 1-247S
Parameterizing a statement
with SQL identifiers 1-359S
Parent-child relationship
1-51S, 1-144S
Parts explosion 5-27T
PATH environment variable
11-16T, 4-60R
setting 4-9R
Pathname
for C compiler 4-40R
for COBOL compiler 4-40R
for database server 4-28R
for executable programs 4-60R
for installation 4-46R
for message files 4-24R
for parallel sorting 4-62R
for relay module 4-64R
for remote shell 4-32R
for temporary files in SE 4-34R
specifying with DBPATH 4-28R
specifying with PATH 4-60R
PDQ
OPTCOMPIND environment
variable 4-59R
PDQPRIORITY environment
variable 4-61R
SET PDQPRIORITY statement
1-474S
PDQPRIORITY
environment variable
values 4-61R
1-474S
Percent (%) sign, wildcard in
PERFORM keyword, in the
Performance
buffered log 9-25T
depends on concurrency 7-3T
increasing with stored procedures
12-4T
using CHAR instead of NCHAR
1-22R
Permission, with SYSTEM 2-46S
Phantom row 1-464S, 1-478S
PIPE keyword, in the OUTPUT
statement 1-350S
Pipes, unnamed 11-8T
Plus (+) sign, arithmetic operator
1-546S
Populating tables 9-30T
POW function
Precedence, rules for environment
variables 4-10R
Precedence, rules for NLS
environment variables 4-11R
PRECISION field
1-453S
with GET DESCRIPTOR 1-282S
PREPARE statement
error return in SQLERRD 5-13T
executing 1-244S
increasing performance efficiency
1-363S
missing WHERE signalled 5-11T
Index
25
multiple SQL statements 5-32T

multi-statement text
1-357S, 1-362S
parameterizing a statement
1-358S
parameterizing for SQL
identifiers 1-359S
preparing GRANT 10-14T
question (?) mark as placeholder
1-352S
releasing resources with FREE
1-277S
restrictions with SELECT 1-354S
statement identifier use 1-352S
syntax 1-351S
valid statement text 1-354S
1-548S
Prepared statement
describing returned values with
DESCRIBE 1-222S
executing 1-244S
prepared object limit 1-352S
valid statement text 1-354S
version number in systables 2-40R
version number in systables table
2-39R
prepared statement
parameterizing 1-247S
PREVIOUS keyword
use in FETCH 1-264S
Primary key
definition of 8-25T
restrictions with 8-25T
Primary key constraint 1-51S
composite 8-25T
data type conversion 1-59S
defining column as 1-141S
definition of 4-20T
dropping 1-63S
enforcing 1-131S
modifying a column with 1-58S
referencing 1-51S
requirements for 1-48S, 1-141S
rules of use 1-62S, 1-144S
26
PRIMARY KEY keywords

in ALTER TABLE 1-48S, 1-60S
in CREATE TABLE
1-136S, 1-138S
Primary key, use in fragmented
table 3-16T, 9-39T
Primary site 11-21T
Printing
specifying print program with
DBPRINT 4-31R
PRIOR keyword
use in FETCH 1-264S
Privilege
Alter 10-10T, 1-310S
and views 10-28T to 10-31T
ANSI-compliant databases 1-14R
automating grants of 10-13T
column-level 10-11T
Connect 10-6T, 1-306S
DBA 10-7T, 1-307S
default for stored procedures
12-17T
default for table using CREATE
TABLE 1-129S
Delete 10-9T, 10-29T, 1-309S
displaying 4-17T
displaying with the INFO
statement 1-316S
encoded in system catalog
10-9T, 2-38R, 2-44R
Execute 10-13T, 12-17T
for triggered action 1-186S
granting 10-6T to 10-15T
Index 10-10T, 1-310S
Insert 10-9T, 10-29T, 1-309S
needed
to create a view 10-28T, 1-313S
to drop an index 1-233S
to modify data 4-15T, 1-309S
on a synonym 1-125S
on a table, described in systabauth
2-38R
on a view 10-29T, 1-194S
on stored procedures 12-15T
overview 1-9T
Resource 10-7T, 1-307S
Select 10-9T, 10-11T, 10-28T
Update
10-9T, 10-11T, 10-29T, 1-309S
when privileges conflict 1-305S
with DBA-privileged procedures
12-16T
with owner-privileged
procedures 12-16T
Privileges
user, described in sysusers table
2-44R
PRIVILEGES FOR keywords, in
PRIVILEGES keyword
syntax
in GRANT 1-308S
in REVOKE 1-386S
use
in GRANT 1-310S
in REVOKE 1-387S
Procedure
compiled version in sysprocbody
table 2-32R
Procedure cursor
in DECLARE statement 1-206S
opening 1-342S
reopening 1-344S
Procedure name
conflict with function name
1-622S
Procedure privileges
in sysprocauth table 2-31R
Processing, distributed 11-10T
Projection, described 2-7T
Project, description of 1-14T
Promotable lock
7-6T, 7-10T, 1-212S
Protected stored procedures 2-33R
PSORT_DBTEMP environment
variable 4-62R
PSORT_NPROCS environment
variable 4-63R
PUBLIC keyword
privilege granted to all users
10-7T
syntax
in GRANT 1-304S
in REVOKE 1-384S
use
in GRANT 1-307S
in REVOKE 1-386S
PUT statement
constant data with 6-11T
impact on trigger 1-167S
sends returned data to buffer
6-10T
source of row values 1-366S
syntax 1-364S
use in transactions 1-366S
1-548S
with FLUSH 1-366S
Q
Qualifier, field
for DATETIME
3-10R, 1-543S, 1-613S
for INTERVAL 1-610S, 1-616S
Query
cyclic 4-23T
piping results to another program
1-350S
self-referencing 4-23T
sending results to an operating
system file 1-349S
sending results to another
program 1-350S
stated in terms of data model 1-7T
Query optimization information
in sysprocplan table 2-34R
Query optimization information
statements 1-10S
Question (?) mark
as placeholder in PREPARE
1-352S
naming variables in PUT 1-368S
replacing with USING keyword
1-345S
wildcard in Condition segment
1-525S
Quoted string
syntax
in INSERT 1-324S
use
in INSERT 1-627S
with LIKE, MATCHES
keywords 1-413S
Quoted String segment
DATETIME, INTERVAL values
as strings 1-626S
syntax 1-624S
wildcards 1-626S
with LIKE in a condition 1-626S
Quotes, single Intro-7S
R
RAISE EXCEPTION statement
syntax 2-40S
Range rule 1-29S, 1-106S, 1-161S
Read Committed isolation level
1-479S
Read Committed isolation level
(ANSI) 7-13T
READ COMMITTED keywords,
syntax in SET TRANSACTION
1-476S
Read Uncommitted isolation level
1-478S
Read Uncommitted isolation level
(ANSI) 7-12T
READ UNCOMMITTED
keywords, syntax in SET
TRANSACTION 1-476S
REAL data type 3-23R
RECOVER TABLE statement
archiving a database with audit
trails 1-373S
manipulating audit trail file
1-375S
syntax 1-373S
Recursion, in a stored procedure
12-27T
Recursive relationship 8-12T, 8-30T

Redundant relationship 8-31T
Reference material
about databases vR
REFERENCES FOR keywords, in
REFERENCES keyword
in CREATE TABLE
1-142S, 1-146S
syntax
in GRANT 1-308S
in REVOKE 1-386S
use
in GRANT 1-309S
in REVOKE 1-387S
References privilege
displaying with the INFO
statement 1-317S
REFERENCING clause
DELETE REFERENCING clause
1-175S
INSERT REFERENCING clause
1-174S
UPDATE REFERENCING clause
1-176S
using referencing 13-9T, 1-181S
Referential constraint
and a DELETE trigger 1-167S
data type restrictions 1-145S
definition of 4-20T, 1-51S, 1-143S
dropping 1-63S
enforcing 1-131S
rules of use 1-144S
Referential integrity 4-20T
defining primary and foreign keys
8-26T
Regular expression
evaluating with NLS 1-17R
Relational database, defined 1-12T
Relational model
attribute 8-16T
description of
1-12T, 8-3T to 8-36T
entity 8-5T
join 2-9T
many-to-many relationship 8-12T
Index
27
normalizing data 8-31T

one-to-many relationship 8-12T
one-to-one relationship 8-12T
projection 2-6T
resolving relationships 8-28T
rules for defining tables, rows,
and columns 8-22T
selection 2-6T
Relational operation 2-5T
Relational operator
BETWEEN 2-33T
equals 2-30T
EXISTS 3-32T
IN 3-32T
in a WHERE clause 2-29T to ??
LIKE 2-38T
NOT 2-33T
NULL 2-36T
OR 2-34T
segment 1-628S
with WHERE keyword in
SELECT 1-411S
Relationship
attribute 8-16T
cardinality 8-10T, 8-15T
complex 8-30T
connectivity 8-10T, 8-12T
defining in data model 8-9T
entity 8-5T
existence dependency 8-10T
mandatory 8-10T
many-to-many 8-10T, 8-12T
many-to-many, resolving 8-29T
one-to-many 8-10T, 8-12T
one-to-one 8-10T, 8-12T
optional 8-10T
recursive 8-30T
redundant 8-31T
using matrix to discover 8-11T
RELATIVE keyword
use in FETCH 1-264S
Relay module
4-65R
4-65R
28
Release notes
Remainder, in fragment
expressions 1-33S
Remote database server 11-9T
Remote shell 4-32R
RENAME COLUMN statement
restrictions 1-377S
syntax 1-376S
RENAME TABLE statement
ANSI-compliant naming 1-380S
syntax 1-379S
REPAIR TABLE statement, syntax
and use 1-382S
Repeatable Read isolation level
description of 1-464S, 1-479S
emulating during update 1-269S
Repeatable Read isolation level
(Informix and ANSI)
REPEATABLE READ keywords
syntax in SET ISOLATION 1-463S
syntax in SET TRANSACTION
1-476S
Replication of data 11-21T
Report generator 1-19T
Reserved words 1-593S
Resolution
in UPDATE STATISTICS
1-507S, 1-508S
with data distributions 1-507S
RESOURCE keyword
use in GRANT 1-307S
use in REVOKE 1-388S
Resource manager 11-13T
Resource privilege 10-7T, 1-307S
Restricting access, using file system
10-4T
Result of triggering statement
1-179S
RETURN statement
returning insufficient values 2-42S
returning null values 2-42S
syntax 2-42S
REVOKE statement
column-specific privileges 1-388S
database-level privileges 1-388S
granting privileges
10-6T to 10-15T
in embedded SQL 5-36T to 5-39T
privileges needed 1-385S
syntax 1-384S
table-level privileges 1-386S
with a view 10-30T
ROLLBACK WORK statement
cancels a transaction 4-26T
closes cursors 7-22T
releases locks 7-10T, 7-22T
sets SQLCODE 6-5T
syntax 1-391S
use with WHENEVER
1-68S, 1-76S, 1-392S
with DROP DATABASE 1-232S
with DROP INDEX statement
1-234S
with DROP PROCEDURE
statement 1-235S
with DROP SYNONYM
statement 1-236S
with DROP TABLE statement
1-239S
with DROP TRIGGER statement
1-240S
with DROP VIEW statement
1-242S
ROLLFORWARD DATABASE
statement
applies log to restored database
4-28T
exclusive locking 1-393S
syntax 1-393S
ROOT function
ROUND function
Round-robin distribution scheme
defined with ALTER
FRAGMENT 1-29S
Routine
DATETIME formatting 4-34R
Row
defined 2-5T
defining 8-22T
deleting 4-4T, 1-218S
engine response to locked row
1-468S
inserting 4-7T
through a view 1-321S
with a cursor 1-322S
multirow queries with FETCH
1-262S
order, guaranteeing
independence of 1-173S
phantom 1-464S, 1-478S
retrieving with FETCH 1-265S
rowid definition 1-265S
updating through a view 1-492S
writing buffered rows with
FLUSH 1-272S
ROW keyword
Row lock 7-9T
Rowid
adding
column with INIT clause 1-29S
to fragmented table with
CREATE TABLE 1-156S
to fragmented tables with
ALTER TABLE 1-65S
creating in a fragmented table
9-40T
dropping from fragmented tables
1-66S
dropping in a fragmented table
9-40T
in fragmented tables 9-40T
locating internal row numbers
3-17T
use in a column expression 1-550S
use in a join 3-16T
use in fragmented tables 1-29S
used as column name 1-599S
ROWID keyword 1-550S
Rule
arbitrary 1-30S, 1-107S, 1-161S
hash 1-30S, 1-107S, 1-161S
range 1-29S, 1-106S, 1-161S
Rules for stored procedures 1-185S
Run-time program
setting DBANSIWARN 4-19R
setting INFORMIXCOBDIR 4-41R
S
SCALE field
1-453S
with GET DESCRIPTOR 1-282S
Schema. See Data Model.
Scroll cursor
active set 5-26T
use of 1-208S
with FETCH 1-264S
SCROLL keyword
use in DECLARE 5-24T, 1-208S
SE
temporary files 4-34R
SECOND keyword
syntax
use
3-10R, 1-613S
3-17R, 1-616S
Second normal form 8-33T
Secondary site 11-21T
Security
constraining inserted values
10-21T, 10-27T
database-level privileges 10-5T
making database inaccessible
10-5T
restricting access to columns
10-21T
restricting access to rows
10-21T, 10-22T
restricting access to view 10-28T
table-level privileges 10-11T
using host file system 10-4T
using operating system facilities
10-4T
with stored procedures 10-3T
Select
Select cursor
opening 5-22T, 1-341S
reopening 1-344S
use of 5-21T, 1-207S
SELECT keyword
ambiguous use as procedure
variable 1-604S
syntax
in GRANT 1-308S
in REVOKE 1-386S
use
in GRANT 1-309S
in REVOKE 1-387S
Select list
display label 2-50T
expressions in 2-47T
functions in 2-53T to 2-66T
labels in 3-45T
selecting all columns 2-12T
selecting specific columns 2-18T
specifying a substring in 2-27T
Select privilege
column level 10-11T
with a view 10-28T
SELECT statement
active set 2-29T
aggregate functions in
2-53T, 1-583S
alias names 2-79T
variable 4-17R
and LC_COLLATE environment
variable 4-52R
and NLS collation order 1-17R
as an argument to a stored
procedure 2-6S
associating with cursor with
DECLARE 1-207S
BETWEEN condition 1-412S
column numbers 1-426S
compound query 3-40T
cursor for 5-20T, 5-21T
date-oriented functions in 2-56T
Index
29
describing returned values with

DESCRIBE 1-221S
description of advanced
3-4T to 3-53T
description of simple
2-3T to 2-83T
display label 2-50T
DISTINCT keyword 2-19T
for joined tables 2-69T to 2-83T
for single tables 2-12T to 2-66T
FROM Clause 1-408S
functions 2-53T to 2-66T
GROUP BY clause 3-4T, 1-419S
HAVING clause 3-8T, 1-422S
IN condition 1-412S
in FOR EACH ROW section
1-173S
in modifiable view 10-25T
INTO clause with ESQL 1-403S
INTO TEMP clause 2-83T, 1-429S
IS NULL condition 1-413S
join 2-71T to 2-79T
joining tables in WHERE clause
1-416S
LIKE or MATCHES condition
1-413S
multiple-table 2-69T
natural join 2-75T
null values in the ORDER BY
clause 1-425S
ORDER BY clause 2-14T, 1-423S
ORDER BY clause and NLS 1-17R
outer join 3-21T to 3-30T
relational-operator condition
1-411S
restrictions with INTO clause
1-354S
rowid 3-16T, 3-21T
ROWID keyword 1-550S
SELECT clause
2-12T to 2-28T, 1-397S
select numbers 1-426S
selecting a substring 2-27T
selecting expressions 2-47T
selection list 2-12T
self-join 3-11T
single-table 2-12T
30
singleton 2-29T, 1-404S

subquery 3-31T to 3-40T
subquery with WHERE keyword
1-411S
syntax 1-395S
UNION operator 3-40T, 1-431S
use of expressions 1-399S
using
for join 2-9T
for projection 2-7T
for selection 2-6T
WHERE clause and NLS 1-17R
with
DECLARE 1-203S
FOREACH 2-23S
INSERT 1-327S
INTO keyword 1-266S
LET 2-33S
writing rows retrieved to an
ASCII file 1-485S
Selection, described 2-6T
Self-join
assigning column names with
INTO TEMP 3-13T
Self-referencing query 3-11T, 4-23T
Semantic integrity 4-19T, 9-3T
Sequential cursor
use of 1-208S
with FETCH 1-263S
Sequential integers, with SERIAL
data type 3-23R
SERIAL data type
generated number in SQLERRD
5-13T
in INSERT 1-326S
inserting a starting value 4-8T
inserting values 3-23R
resetting values 3-23R
syntax 1-540S
treatment by dbschema 5-43R
with stored procedures 2-11S
Serializable isolation level
Serializable isolation level (ANSI)
SERIALIZABLE keyword, syntax in

SET TRANSACTION 1-476S
Server. See Database server.
SET clause 4-14T, 1-181S
SET CONNECTION statement
1-548S
SET CONSTRAINTS statement
use with CREATE TRIGGER
1-188S
SET DATASKIP statement 1-440S
what causes a skip 1-441S
SET DEBUG FILE TO statement
with TRACE 2-47S
syntax 1-446S
the VALUE option 1-450S
1-548S
X/Open mode 1-451S
Set difference 3-51T
SET EXPLAIN statement
interpreting output 1-456S
MERGE JOIN information 1-457S
optimizer access paths 1-456S
output examples 1-458S
SORT SCAN information 1-457S
syntax 1-455S
Set intersection 3-49T
SET ISOLATION statement
controlling the effect of locks
4-29T
default database levels 1-465S
definition of isolation levels
1-464S
discussed 7-11T
effects of isolation 1-465S
similarities to SET
TRANSACTION 1-477S
similarities to SET
TRANSACTION statement
7-11T
syntax 1-463S
SET keyword
syntax in UPDATE 1-491S
use in UPDATE 4-12T, 1-495S
SET LOCK MODE statement

controlling the effect of locks
4-29T
kernel locking 1-468S
setting wait period 1-468S
syntax 1-467S
SET LOG statement
buffered vs. unbuffered
9-25T, 1-470S
syntax 1-470S
SET OPTIMIZATION statement,
1-474S
SET TRANSACTION statement
default database levels 1-479S
definition of isolation levels
1-478S
effects of isolation 1-480S
similarities to SET ISOLATION
1-477S
similarities to SET ISOLATION
statement 7-11T
syntax 1-476S
Setting environment variables 4-8R
SHARE keyword, syntax in LOCK
TABLE 1-336S
Shared memory
network connection 11-8T
setting INFORMIXSHMBASE
4-47R
Shared memory parameters,
specifying file with ONCONFIG
4-59R
Shell
remote 4-32R
search path 4-60R
setting environment variables in a
file 4-7R
specifying with
DBREMOTECMD 4-32R
Simple assignment 2-33S
SIN function
Single-precision floating-point
number, storage of 3-15R
Singleton SELECT statement

2-29T, 1-404S
Site
network 11-4T
primary 11-21T
secondary 11-21T
SITENAME function
returns servername 1-554S
syntax
in INSERT 1-324S
use
in INSERT 1-326S
in SELECT 2-62T, 2-65T, 3-20T
Slash (/), arithmetic operator
1-546S
SMALLFLOAT data type
syntax 1-540S
SMALLINT data type
syntax 1-540S
SMALLINT data type, using as
SOME keyword
3-32T, 1-415S
use in Condition subquery 1-530S
Sorting
in a combined query 1-432S
in SELECT 1-423S
nested 2-15T
setting DBSPACETEMP 4-33R
setting PSORT_DBTEMP
setting PSORT_NPROCS
when there are multiple active
NLS locales 1-23R
with NLS activated 2-25T, 1-17R
with ORDER BY 2-15T
Space ( )
Specifying ANSI-compliance 1-12R

SPL
flow control statements 12-25T
program variable 5-6T
relation to SQL 12-3T
statements described 2-4S
SQL
ANSI standard 1-17T
cursor 5-20T
error handling 5-18T
history 1-16T
in NLS-ready products 1-25R
Informix SQL and ANSI SQL
1-17T
interactive use 1-19T
standardization 1-16T
statement types 1-7S
SQL Communications Area
(SQLCA)
altered by end of transaction 6-5T
description of 5-9T
effect of setting DBANSIWARN
4-19R
inserting rows 6-11T
result after CLOSE 1-72S
result after DATABASE 1-198S
result after DESCRIBE 1-222S
result after FETCH 1-270S
result after FLUSH 1-273S
result after OPEN 1-341S, 1-342S
result after PUT 1-370S
result after SELECT 1-406S
returning NLS error messages to
1-21R
SQL statement
ALTER FRAGMENT 1-17S
ALTER TABLE 1-42S
CREATE INDEX 1-99S
CREATE TABLE 1-129S
SET DATASKIP 1-440S
SET PDQPRIORITY 1-474S
SQL statements
FILE 5-29R
INSERT 5-29R
SQLAWARN array
syntax of naming 5-12T
with PREPARE 5-31T
Index
31
SQLCA
warning when dbspace skipped
1-440S
sqlca record and EXECUTE
statement 1-246S
SQLCODE field
after opening cursor 5-21T
end of data on SELECT only 6-14T
end of data signalled 5-18T
set by DELETE 6-4T
set by DESCRIBE 5-34T
set by PUT, FLUSH 6-11T
sqlda structure
syntax
in DESCRIBE 1-222S
in FETCH 1-260S
in OPEN
1-247S, 1-251S, 1-340S, 1-36
5S
use
in DESCRIBE 1-223S
in FETCH 1-268S
in OPEN 1-346S
in PUT 1-369S
use with EXECUTE statement
1-247S
SQLERRD array
count of deleted rows 6-4T
count of inserted rows 6-11T
count of rows 6-14T
syntax of naming 5-12T
SQLERROR keyword, in the
SQLEXEC environment variable
4-64R
sqlexecd 11-15T
sqlhosts. See $INFORMIXDIR/etc/
sqlhosts.
SQLNOTFOUND
error conditions with EXECUTE
statement 1-249S
4-65R
4-65R
32
SQLSTATE
in databases that are not ANSIcompliant 5-18T
list of codes 1-287S
use with a cursor 5-22T
SQLWARNING keyword, in the
SQRT function
Stacksize
setting INFORMIXSTACKSIZE
4-48R
START DATABASE statement
adding a transaction log 9-26T
state table in stores7 database,
columns in 57
Statement
naming with NLS 1-17R
SQL
ANSI compliance and
DBANSIWARN 4-19R
CONNECT and
INFORMIXSERVER 4-47R
CREATE TABLE and
COLLCHAR 4-17R
DESCRIBE and COLLCHAR
4-17R
editing and DBEDIT 4-23R
LOAD and DBDELIMITER
4-23R, 4-38R
printing and DBPRINT 4-31R
SELECT and COLLCHAR 4-17R
SELECT and LC_COLLATE
4-52R
UNLOAD and DBDELIMITER
4-23R, 4-38R
UPDATE STATISTICS and
DBUPSPACE 4-37R
Statement identifier
associating with cursor 1-206S
releasing 1-353S
syntax
in DECLARE 1-203S
in FREE 1-275S
use
in DECLARE 1-214S
in FREE 1-277S
in PREPARE 1-352S
Statement types 1-7S
Static SQL 5-5T
STATUS FOR keywords, in INFO
statement 1-318S
STATUS variable (4GL) 5-12T
Status, displaying with INFO
statement 1-318S
stock table in stores7 database,
columns in 55
STOP keyword, in the WHENEVER
statement 1-510S, 1-515S
Storage device 11-6T
Stored procedure
altering 12-15T
as triggered action 13-11T, 1-185S
branching 12-25T
BYTE and TEXT data types
2-11S, 2-16S
characteristics in sysprocedures
table 2-33R
checking references 1-185S
comments in 12-7T
creating from an embedded
language 12-6T
creating from DB-Access 12-6T
cursors with 2-24S
DBA-privileged, how to create
1-111S
DBA-privileged, use with triggers
12-16T, 1-186S
debugging 12-13T, 2-47S
default privileges 12-17T
DEFINE statement 12-20T
definition of 12-4T
displaying contents 12-10T
displaying documentation 12-11T
executing 12-11T
executing operating system
commands from 2-45S
general programming 1-20T
granting privileges on
10-13T, 12-17T, 12-18T,
1-311S
handling multiple rows 2-43S
header 12-28T, 2-11S
in SELECT statements
2-66T, 1-401S
in WHEN condition 1-179S
introduction to 12-3T
looping 12-26T
name confusion with SQL
functions 12-23T
naming output file for TRACE
statement 1-443S
owner-privileged
12-16T, 1-111S, 1-186S
privileges 1-186S
privileges necessary at execution
12-17T
program flow control 12-25T
receiving data from SELECT
1-403S
recursion 12-27T
REFERENCES clause 12-20T
returning values 12-28T
revoking privileges on
12-18T, 1-385S
security purposes 10-3T
sending mail from 2-46S
simulating errors 2-40S
tracing triggered actions 13-12T
use 12-4T
variable 12-19T
stored procedure
protected 2-33R
stores7 database
call_type table columns 56
catalog table columns 55
copying Intro-10T, Intro-12R,
Intro-14S
creating Intro-10T, Intro-12R,
Intro-14S
customer table columns 52
cust_calls table columns 56
data values 66
description of 51
items table columns 54
manufact table columns 57
map of 57
orders table columns 53
overview
primary-foreign key relationships
59 to 66
stock table columns 55

structure of tables 52
Structured Query Language. See
SQL.
Subquery
beginning with ALL/ANY/
SOME keywords 1-415S
beginning with EXISTS keyword
1-415S
beginning with IN keyword
1-414S
correlated 3-31T, 4-23T, 1-527S
in DELETE statement 4-6T
in SELECT 3-31T to 3-40T
in UPDATE-SET 4-13T
in UPDATE-WHERE 4-13T
restrictions with UNION operator
1-432S
with DISTINCT keyword 1-399S
Subscripting
in a WHERE clause 2-45T
on character columns 1-550S
SPL variables 12-21T
Subservient table 3-21T
Substring 2-27T, 12-21T
SUM function
Surviving
index 1-17S
table 1-17S, 1-20S
Synonym
chaining 1-127S
chains 11-20T
creating with CREATE
SYNONYM 1-125S
difference from alias 1-125S
dropping 1-236S
in ANSI-compliant database
1-16R
mappings in syssyntable 2-36R
Synonyms
in syssynonyms table 2-36R
Synonyms for table names 11-19T
Syntax diagram
elements of Intro-9S
syscolauth catalog table,
example 2-8R, 2-9R
syscolumns catalog table,
example 2-7R
sysdepend system catalog table
1-242S
sysindexes catalog table, example
2-10R
syssyntable system catalog table
11-19T
systabauth catalog table,
example 2-8R
systables catalog table,
example 2-5R
System catalog
accessing 2-11R
altering contents 2-11R
character column data type when
NLS activated 1-22R
database entries 1-95S
description of 2-3R
how used by database server 2-4R
list of tables 2-12R
map of tables 2-45R
NCHAR columns in 1-22R
privileges in 4-17T, 10-9T
querying 4-17T
sysblobs 2-13R
syschecks 2-14R
syscolauth 10-9T, 2-15R, 1-386S
syscoldepend 2-16R
syscolumns 2-17R
sysconstraints 2-20R
sysdefaults 2-22R
sysdepend 2-23R
sysdistrib 2-24R
sysfragments 2-25R
sysindexes 2-26R
sysopclstr 2-29R
sysprocauth 2-31R
sysprocbody 12-10T, 2-32R
sysprocedures 2-33R
sysprocplan 2-34R
sysreferences 2-35R
syssynonyms 2-36R
syssyntable 2-36R
Index
33
systabauth
4-17T, 10-9T, 2-38R, 1-312S,
1-386S
systables 2-39R
systrigbody 2-42R
systriggers 2-43R
sysusers 10-9T, 2-44R
sysviews 2-44R
updating statistics 2-11R
updating system catalog tables
2-11R
using 2-4R
System descriptor area 1-224S
assigning values to 1-449S
modifying contents 1-449S
resizing 1-449S
use with EXECUTE statement
1-248S
System name, in database name
1-537S
SYSTEM statement
syntax 2-45S
sysviews catalog table, example
2-8R
T
tabid, description of 2-6R
Table
adding a constraint 1-60S
alias in SELECT 1-408S
candidate keys, defined 8-25T
changing the data type of a
column 3-28R
checking with the CHECK TABLE
statement 1-69S
composite key, defined 8-25T
consumed 1-20S
creating 9-27T
a synonym for 1-125S
a table 1-129S
a temporary table 1-150S
defining fragmentation strategy
1-159S
defining temporary 1-153S
34
dependencies, in sysdepend table

2-23R
description in systables catalog
table 2-39R
dropping
a synonym 1-236S
a table 1-238S
dropping a constraint 1-63S
engine response to locked table
1-468S
fragmenting 1-156S
joins in Condition segment 1-416S
loading data with the LOAD
statement 1-329S
lock 7-8T
locking
with ALTER INDEX 1-40S
with LOCK TABLE 1-336S
locking, changing mode 1-65S
logging 1-156S
names 11-18T
names, synonyms 11-19T
naming conventions
1-129S, 1-592S, 1-637S
optimizing queries 1-505S
ownership 10-8T
primary key in 8-25T
primary key, defined 8-25T
repairing with REPAIR TABLE
statement 1-382S
represents an entity 8-24T
restoring with audit trail 1-373S
storing in dbspaces 1-156S
structure in stores7 database 52
surviving 1-17S, 1-20S
synonyms in syssynonyms table
2-36R
system catalog tables
2-13R to 2-44R
temporary 1-21S
temporary in SE 4-34R
unlocking 1-489S
TABLE keyword, syntax in
UPDATE STATISTICS 1-503S
Table Name segment 1-635S
Table-level privilege
column-specific privileges
10-11T, 1-388S
default with GRANT 1-310S
definition and use 10-8T, 1-309S
granting 1-308S
revoking 1-386S
shown in tabauth table 2-8R
TABLES keyword, in INFO
statement 1-315S
tabtype 2-39R, 2-41R, 1-98S
TAN function
Tape management
setting ARC_DEFAULT 4-15R
setting ARC_KEYPAD 4-15R
setting DBREMOTECMD 4-32R
TEMP keyword
TEMP TABLE keywords, syntax in
CREATE TABLE 1-129S
Temporary
tables in SE, specifying directory
with DBTEMP 4-34R
tables, specifying dbspace with
DBSPACETEMP 4-33R
Temporary files
in OnLine, setting
DBSPACETEMP 4-33R
in SE, specifying directory with
DBTEMP 4-34R
setting PSORT_DBTEMP 4-62R
Temporary table
and active set of cursor 5-25T
assigning column names 3-13T
building distributions 1-509S
creating constraints for 1-153S
DBSPACETEMP environment
variable 1-151S
example 4-11T
explicit 1-150S
implicit 1-151S
naming 1-151S
storage
created with CREATE TABLE
1-151S
created with SELECT INTO
TEMP 1-429S
effects of DBSPACETEMP 4-33R
updating statistics 1-505S
when deleted 1-150S
TERM environment variable 4-66R
TERMCAP environment variable
11-16T, 4-66R
termcap file
and TERMCAP environment
variable 4-66R
Terminal handling
and TERM environment variable
4-66R
and TERMCAP environment
variable 4-66R
and TERMINFO environment
variable 4-67R
setting INFORMIXTERM 4-49R
terminfo directory
and TERMINFO environment
variable 4-67R
TERMINFO environment variable
4-67R
TEXT data type
inserting values 3-25R
statement 1-333S
restrictions
with aggregate functions 3-25R
with GROUP BY 3-6T, 3-25R
with IN clause 3-25R
with LIKE or MATCHES
2-39T, 3-25R
with ORDER BY 3-25R
with relational expression 2-30T
selecting a column 3-26R
syntax 1-540S
use in Boolean expression 3-25R
with control characters 3-25R
with LENGTH function 2-63T
with stored procedures
2-11S, 2-16S
Text editor, specifying with

DBEDIT 4-23R
TEXT value, displaying 2-11T
Third normal form 8-34T
Time function
1-420S
Time value
setting DBTIME environment
variable 4-34R
setting national date and time
4-57R
Time, representing with NLS 1-18R
TO CLUSTER keywords, in ALTER
INDEX 1-39S
TO keyword
in GRANT 1-304S
TODAY function
syntax
in INSERT 1-324S
use
in constant expression
2-62T, 4-9T, 1-555S
in INSERT 1-326S
TP/XA. See Transaction manager.
TRACE command
output from 13-13T
TRACE statement
debugging a stored procedure
12-13T
syntax 2-47S
Transaction
and CREATE DATABASE 1-97S
ANSI-compliant database, effects
1-13R
committing with COMMIT
WORK 1-77S
cursors closed at end 7-22T
example with DELETE 6-5T
global 11-23T
locks held to end of 7-10T
locks released at end 7-10T, 7-22T
logging 1-482S
recovering transactions 1-393S
rolling back 1-5R, 1-391S
starting with BEGIN WORK 1-67S
stopping logging 1-482S
transaction log 4-25T, 4-28T
transaction log required 9-25T
use signalled in SQLAWARN
5-13T
using cursors in 1-215S
Transaction logging
ANSI-compliant database, effects
1-13R
buffered 9-25T
contents of log 4-27T
effect on database server type
1-5R
establishing with CREATE
DATABASE 9-23T
OnLine methods of 9-25T
renaming log 1-483S
stopping 1-483S
turning off for faster loading
9-32T
turning off not possible 9-26T
Transaction manager 11-13T
Transfer of database files 5-23R
Transitive dependency 8-34T
Trigger
creating 13-4T
definition of 13-3T
effects on altered fragments 1-24S
effects with ALTER FRAGMENT
ATTACH 1-21S
in client/server environment
1-190S
information in systriggers table
2-43R
number on a table 1-166S
text in systrigbody table 2-42R
when to use 13-3T
Trigger event
example of 13-5T
in CREATE TRIGGER statement
1-166S
INSERT 1-174S
privileges on 1-167S
Index
35
with cursor statement 1-167S

Trigger name
assigning 13-5T
syntax 1-168S
Triggered action
action on triggering table 1-183S
anyone can use 1-186S
BEFORE and AFTER 13-7T
cascading 1-173S
clause 1-178S
action statements 1-179S
syntax 1-178S
WHEN condition 1-178S
correlation name in
1-182S, 1-185S
FOR EACH ROW 13-8T
generating an error message
13-13T
in client/server environment
1-190S
in relation to triggering statement
13-6T
list
AFTER 1-172S
BEFORE 1-171S
FOR EACH ROW 1-172S
for multiple triggers 1-172S
sequence of 1-171S
merged 1-172S
statements 13-3T
tracing 13-12T
using 13-7T
using stored procedures 13-11T
WHEN condition 13-10T, 1-178S
Triggering statement
affecting multiple rows 1-173S
execution of 1-168S
guaranteeing same result 1-167S
result of 1-179S
UPDATE 1-170S
Triggering table
action on 1-183S
and cascading triggers 1-188S
Trigonometric function
ACOS function 1-579S
ASIN function 1-579S
ATAN function 1-579S
ATAN2 function 1-579S
36
COS function 1-578S

SIN function 1-578S
TAN function 1-578S
TRIM function 1-580S
TRUNC function
Truncation, signalled in
SQLAWARN 5-13T
Two-phase commit 11-22T
TYPE field
changing from BYTE or TEXT
1-454S
setting in SET DESCRIPTOR
1-450S
setting in X/Open programs
1-451S
Typographical conventions
U
Unbuffered logging 9-25T
Underscore (_), wildcard in
UNION operator
display labels with 3-45T
restrictions on use 1-432S
Unique constraint
dropping 1-63S
rules of use 1-61S, 1-140S, 1-144S
UNIQUE keyword
constraint in CREATE TABLE
9-27T
10-25T
syntax
in SELECT 1-397S
use
in SELECT 2-19T, 1-399S
no effect in subquery 1-528S
Unique numeric code, with SERIAL
data type 3-23R
UNIQUE, synonym for DISTINCT
1-48S
UNITS keyword
UNIX
BSD
default print capability 4-31R
PATH environment variable
4-60R
specifying directories for
intermediate writes 4-62R
System V
default print capability 4-31R
terminfo library support 4-49R
TERM environment variable
4-66R
TERMCAP environment variable
4-66R
TERMINFO environment
variable 4-67R
viewing environment variable
settings 4-9R
UNIX environment variables 4-11R
UNIX operating system
11-5T, 11-7T
UNLOAD statement
DELIMITER clause 1-488S
exporting data to a file 9-30T
DBDELIMITER 4-23R
syntax 1-485S
UNLOAD TO file 1-486S
unloading VARCHAR, TEXT, or
BYTE columns 1-487S
UNLOAD TO file 1-486S
Unloading a database 5-10R
UNLOCK TABLE statement, syntax
and use 1-489S
Unnamed pipes 11-8T
Updatable view 1-197S

UPDATE clause, syntax 1-169S
Update cursor 1-206S
locking considerations 1-212S
opening 1-341S
restricted statements 1-211S
use in UPDATE 1-500S
using 1-211S
UPDATE keyword
syntax
in GRANT 1-308S
in REVOKE 1-386S
use
in GRANT 1-309S
in REVOKE 1-387S
Update privilege
column level 10-11T
with a view 10-29T, 1-492S
UPDATE REFERENCING clause
1-177S
syntax 1-176S
UPDATE statement
and transactions 1-493S
applied to view 10-25T
as triggered action 1-179S
as triggering statement
1-167S, 1-169S, 1-170S
locking considerations 1-494S
missing WHERE signalled 5-11T
multiple assignment 4-14T
preparing 5-31T
restrictions on columns for update
1-212S
restrictions on subqueries 4-14T
rolling back updates 1-493S
syntax 1-492S
updating a column to null 1-498S
updating through a view 1-492S
updating with cursor 1-500S
use of expressions 1-499S
with
FETCH 1-269S
SET keyword 1-495S
WHERE CURRENT OF
keywords 1-500S
WHERE keyword 1-499S
with a select..for update 1-427S
with an update cursor 1-211S
UPDATE STATISTICS statement
and DBUPSPACE environment
variable 4-37R
and temporary tables 1-509S
creating data distributions 1-507S
dropping data distributions
1-507S
effect on sysdistrib table 2-24R
examining index pages 1-505S
optimizing search strategies
1-505S
syntax 1-502S
update system catalog 2-11R
using the LOW keyword 1-506S
when to execute 1-506S
Update trigger, defining multiple
1-169S
Upgrading the database server
1-506S
Upgrading to a newer database
server 1-506S
USER function
as affected by ANSI compliance
1-384S, 1-554S
syntax
in INSERT 1-324S
use
in expression
2-62T, 2-63T, 3-19T, 1-553S
in INSERT 1-326S
User informix, privileges associated
with 1-307S
User privileges, described in
sysusers table 2-44R
Using correlation names 1-181S
USING DESCRIPTOR keywords

information from DESCRIBE
1-224S
syntax
in EXECUTE 1-244S
in FETCH 1-260S
in OPEN 1-339S
in PUT 1-364S
use
in FETCH 1-268S
in OPEN 1-346S
in PUT 1-249S, 1-369S
USING keyword
syntax
in EXECUTE 1-246S
in OPEN 1-339S
use
in EXECUTE 5-32T, 1-246S
in OPEN 1-345S
USING SQL DESCRIPTOR
keywords
in DESCRIBE 1-224S
in EXECUTE 1-248S
Utility program
chkenv 5-4R
crtcmap 5-5R
dbexport 5-9R
dbimport 5-15R
dbload 9-31T, 5-23R
dbschema 9-29T, 5-40R
onload 4-29T
onunload 4-29T
V
VALUE clause
after NULL value is fetched
1-283S
relation to FETCH 1-282S
use in GET DESCRIPTOR 1-281S
use in SET DESCRIPTOR 1-450S
VALUES clause
effect with PUT 1-367S
use in INSERT 4-7T, 1-324S
Index
37
VARCHAR data type

considerations for UNLOAD
statement 1-487S
statement 1-333S
syntax 1-540S
using as default value
1-46S, 1-134S
value, displaying 2-11T
versus NVARCHAR data type
1-22R
with LENGTH function 2-63T
Variable
default values in SPL 2-14S, 2-15S
define in SPL 2-9S
global, in SPL 12-19T, 2-12S
in SPL 12-19T
local, in SPL 12-19T, 2-15S
scope of SPL variable 2-11S
unknown values in IF 2-29S
with same name as a keyword
12-22T
View
creating a view 10-21T, 1-193S
creating synonym for 1-125S
deleting rows in 10-25T
dependencies, in sysdepend table
2-23R
described in sysviews table 2-44R
display description with
dbschema 5-42R
dropped when basis is dropped
10-23T
dropping 1-242S
effect of changing basis 10-24T
inserting rows in 10-26T
modifying 10-24T to 10-28T
null inserted in unexposed
columns 10-26T
privilege when accessing 10-29T
privilege when creating 1-194S
privileges 10-28T to 10-31T
privileges with GRANT 1-313S
produces duplicate rows 10-22T
38
restrictions with UNION operator

1-432S
synonyms in syssynonyms table
2-36R
system catalog table 2-44R
updatable 1-197S
updating 1-492S
updating duplicate rows 10-26T
using CHECK OPTION 10-27T
virtual column 10-25T, 1-195S
with SELECT * notation 1-194S
View Name segment 1-639S
W
WAIT keyword, in the SET LOCK
MODE statement 1-467S
Warning
if dbspace is skipped 5-11T
if dbspace skipped 1-440S
WARNING keyword, in the
Warnings, with stored procedures
at compile time 12-9T
WEEKDAY function
as time function 2-56T, 2-59T
WHEN condition
restrictions 1-179S
use of 1-178S
WHENEVER statement, syntax and
use 1-510S
WHERE clause, subscripting 2-45T
WHERE CURRENT OF keywords
impact on trigger 1-167S
syntax
in DELETE 1-218S
in UPDATE 1-491S
use
in DELETE 6-7T
in UPDATE 6-15T, 1-500S
WHERE keyword
Boolean expression in 2-37T
comparison condition 2-29T to ??
date-oriented functions in 2-59T
enforcing data constraints 10-28T
host variables in 5-15T

in DELETE 4-4T to 4-7T
joining tables 1-416S
null data tests 2-36T
range of values 2-33T
relational operators 2-29T
selecting rows 2-28T
setting descriptions of items
1-449S
subqueries in 3-32T
syntax
in DELETE 1-218S
in SELECT 1-395S
in UPDATE 1-491S
testing a subscript 2-45T
use
in DELETE 1-219S
in UPDATE 1-499S
with a subquery 1-411S
with ALL keyword 1-415S
with ANY keyword 1-415S
1-412S
with LIKE keyword 1-413S
with MATCHES keyword
1-413S
with NOT keyword 2-33T
with OR keyword 2-34T
with relational operator 1-411S
with SOME keyword 1-415S
wildcard comparisons 2-38T
WHILE keyword
in CONTINUE statement 2-8S
in EXIT 2-17S
WHILE statement
12-26T
syntax 2-51S
with NULL expressions 2-51S
Wildcard character
asterisk 2-12T
Wildcard characters
with LIKE or MATCHES 1-626S
Wildcard comparison
in WHERE clause 2-38T to 2-45T
WITH APPEND keywords, in the

SET DEBUG FILE TO statement
1-443S
WITH CHECK keywords
syntax in CREATE VIEW 1-193S
use in CREATE VIEW 1-196S
WITH CHECK OPTION keywords
of CREATE VIEW statement
10-27T
WITH GRANT keywords
syntax in GRANT 1-304S
use in GRANT 1-311S
WITH HOLD keywords
declaring a hold cursor 7-23T
use in DECLARE 1-209S, 1-217S
WITH keyword, syntax in CREATE
DATABASE 1-94S
WITH LISTING IN keywords
warnings in a stored procedure
12-10T
WITH LOG IN keywords, syntax in
START DATABASE 1-482S
WITH NO LOG keywords
syntax
in SELECT 1-429S
use
in SELECT 1-431S
WITH RESUME keywords, in
RETURN 2-43S
WITH ROWIDS clause, of CREATE
TABLE 9-40T, 1-156S
WITHOUT HEADINGS keywords,
in the OUTPUT statement
1-350S
WORM drive 11-6T
Write-once read-many-times
device. See WORM drive.
Writing a dbload command file
in character-position form 5-38R
in delimiter form 5-33R
X
X/Open
and Informix implementation of
NLS 1-18R
Information Schema views 2-47R
setting NLS environment
variables 4-11R
setting the LC_COLLATE
category 4-51R
setting the LC_CTYPE category
4-53R
setting the LC_MONETARY
category 4-55R
setting the LC_NUMERIC
category 4-56R
setting the LC_TIME category
4-57R
specifications, icon for Intro-11S
X/Open mode
FETCH statement 1-263S
GET DESCRIPTOR 1-281S
1-451S
X/Open specification of NLS 1-18R
Y
YEAR function
YEAR keyword
syntax
use
3-10R, 1-613S
3-17R, 1-616S
Symbols
$INFORMIXDIR/etc/sqlhosts
11-17T
%, percent sign, wildcard in
( ), space, as delimiter
in DATETIME 3-11R
in INTERVAL 3-18R
*, asterisk
arithmetic operator 1-546S
+, plus sign, arithmetic operator
1-546S
-, hyphen, as delimiter
in DATETIME 3-11R
in INTERVAL 3-18R
-, minus sign, arithmetic operator
1-546S
. 1-111S
., decimal point, as delimiter
in DATETIME 3-11R
in INTERVAL 3-18R
..., ellipses, wildcard in Condition
segment 1-525S
/etc/hosts 11-17T
/etc/services 11-17T
/, division symbol, arithmetic
operator 1-546S
/, slash, arithmetic operator 1-546S
:, colon, as delimiter
in DATETIME 3-11R
in INTERVAL 3-18R
=, equals, relational operator
2-30T, 2-71T
?, question mark
as placeholder in PREPARE
5-31T, 1-352S
naming variables in PUT 1-368S
replacing with USING keyword
1-345S
wildcard in Condition segment
1-525S
@, at sign, in database name 1-535S
\, backslash, as escape character
with LIKE 1-524S
with MATCHES 1-525S
^, caret, wildcard in Condition
segment 1-525S
_, underscore, wildcard in
||, concatenation operator 1-547S
Index
39
Reader-Response Card
Informix Guide to SQL: Reference, Version 7.1
Dear Reader,
At Informix Software, we think documentation is very important. After all, manuals are
an integral part of our product line. Because documentation is important, we want to know
what you think about our manuals. You can tell us by filling out and returning the ReaderResponse Card.
Thanks for your help!
1.
Overall, how do you rate this manual?

Outstanding
2.
3.
4.
5.
Very good
Good
Average
Poor
Is the manual effective?

Is it organized so you can find things?
Yes
No
Is the index adequate?
Yes
No
Is the table of contents easy to use?
Yes
No
If applicable, do you find the statement syntax readable?
Yes
No
Are topics presented in a useful sequence?
Yes
No
Are the examples useful?
Yes
No
What did you think of the level of description?

Writing quality:
Very good
Good
Average
Clarity:
Very clear
Average
Hard to understand
Poor
Level:
Too technical
Just right
Oversimplified
When you need to find information quickly, which part of the documentation
do you use?
Index:
Often
Sometimes
Rarely
Never
Table of Contents:
Often
Sometimes
Rarely
Never
Quick Reference Card:
Often
Sometimes
Rarely
Never
Chapter summaries:
Often
Sometimes
Rarely
Never
On-line help:
Often
Sometimes
Rarely
Never
Browse through manuals:
Often
Sometimes
Rarely
Never
How long have you been developing database applications?

How many years have you been programming?
1-3
4-5
>5
How many years have you been using databases?
1-3
4-5
>5
How many years have you been using Informix products?
1-3
4-5
>5
6.
Have you used other programming languages? If so, which ones?
7.
Have you used other database products? If so, which ones?

January 1993
8.
What other Informix products do you use?
9.
What is your job title and area of responsibility?
10. Is the format of this manual easy to use? Consider page size, typeface, binding,
diagrams, and code examples.
11. Additional comments:
Company Name:
Your Name:
Address:
City:
State/Province:
Country:
Zip/Postal Code:
Telephone Number:
INFORMIX is a registered trademark of Informix Software, Inc.
To mail this card, please fold on the dotted line and staple or tape the open end.
BUSINESS REPLY MAIL

FIRST CLASS
PERMIT NO. 25
MENLO PARK, CA.
POSTAGE WILL BE PAID BY ADDRESSEE

Technical Publications Department
4100 Bohannon Drive
Menlo Park, California 94025
NO POSTAGE
NECESSARY
IF MAILED
IN THE
UNITED STATES

SQL Ref

Uploaded by

Copyright:

Available Formats

SQL Ref

Uploaded by

Copyright:

Available Formats

Informix Guide to SQL

Published by INFORMIX Press

Informix Software, Inc.

Copyright 1981-1994 by Informix Software, Inc. All Rights Reserved.

Informix Guide to SQL: Reference

The Informix Guide to SQL: Reference is intended to be used as a companion

An INFORMIX-OnLine Dynamic Server database server or an

Either an Informix application development tool, such as

Chapter 1, Informix Databases, explains differences between the

Chapter 2, System Catalog, provides details of the Informix system

Chapter 3, Data Types, defines the column data types supported

Appendix A, The stores7 Database, describes the structure and

Informix Guide to SQL: Reference

Informix Welcomes Your Comments

tables in the database, illustrates the columns on which they are

A glossary of common database terms follows the chapters, and a

Informix Welcomes Your Comments

Database: A Primer by C. J. Date (Addison-Wesley Publishing, 1983)

An Introduction to Database Systems by C. J. Date (Addison-Wesley

Understanding the New SQL: A Complete Guide by J. Melton and A.

Using SQL by J. Groff and P. Weinberg (Osborne McGraw-Hill, 1990)

Introducing the UNIX System by H. McGilton and R. Morgan

Learning the UNIX Operating System, by G. Todino, J. Strang, and

A Practical Guide to the UNIX System, by M. Sobell

UNIX for People by P. Birns, P. Brown, and J. Muster (Prentice-Hall,

UNIX System V: A Practical Guide by M. Sobell (Benjamin/Cummings

Informix Guide to SQL: Reference

Informix Products That Use SQL .

Products Covered in This Manual .

Other Useful Documentation

How to Use This Manual . . .

Useful On-Line Files

ASCII and PostScript Error Message Files .

The Demonstration Database . . . . .

Compliance with Industry Standards

New Features in Informix Version 7.1 Products

System Catalog Tables . . . . . .

Using ANSI-Compliant Databases . . . . . . .

Using Native Language Support . . . . . . .

Using the System Catalog . . . .

Structure of the System Catalog

Informix Guide to SQL: Reference

System Catalog Map

Data Type Conversions . . . . . . . . . . .

Where to Set Environment Variables . . . .

Manipulating Environment Variables . . .

NLS Environment Variables . . . . . . .

UNIX Environment Variables .

List of Environment Variables .

Informix Guide to SQL: Reference

Index of Environment Variables .

The crtcmap Utility . . . . . .

The dbexport Utility . . . . . . . . . . . .

The dbimport Utility . . . . . . . .

The dbload Utility . . . . . . . . . . . .

The dbschema Utility . . . . . . . . . . .

Informix Guide to SQL: Reference

The stores7 Database

The stores7 Database Map

Primary-Foreign Key Relationships .

Data in the stores7 Database .

Informix Products That Use SQL .

Products Covered in This Manual.

Other Useful Documentation .

How to Use This Manual . . .

Useful On-Line Files .

ASCII and PostScript Error Message Files .

The Demonstration Database . . . . .

Compliance with Industry Standards

New Features in Informix Version 7.1 Products

Informix Guide to SQL: Reference

tructured Query Language (SQL) is an English-like language that