Welcome
SQL programming
You can use the HCL Informix® implementation of the SQL language to develop applications for Informix database servers.
Guide to SQL: Syntax
The Informix® Guide to SQL: Syntax describes the syntax of the statements, data types, expressions, operators, and built-in functions of the Informix dialect of the SQL language.
Built-In Routines
SQLJ Driver Built-In Procedures
sqlj.setUDTextName

HCL Informix® V14.10 documentation
Welcome to the documentation for HCL Informix® 14.10 and related client tools and products. The current fix pack level of Informix is 14.10.xC13.
Product overview
HCL Informix® is a fast and scalable database server that manages traditional relational, object-relational, and dimensional databases. Its small footprint and self-managing capabilities are suited to embedded data-management solutions.
Installing
These topics describe how to install HCL Informix® database servers, client products, and DataBlade® modules.
Administering
In addition to administering the database server, you can tune performance, replicate data, and archive data.
Migrating and upgrading
You can upgrade to the 14.10 release of HCL Informix® or migrate from other database servers to Informix. Upgrading is an in-place migration method that uses your existing hardware and operating system software. Some changes to the Informix database server can affect upgrading from a previous release.
Client APIs and tools
You can use the HCL Informix® implementation of client APIs to develop applications for Informix database servers.
Embedding Informix®
When you embed HCL Informix®, you can use enterprise-class high-availability and high performance with embeddability features such as easy programmability, a small disk and memory footprint, and silent deployment.
Extending Informix®
Beyond standard relational database objects, HCL Informix® can be extended to handle specialized data types, access methods, routines, and other objects. Informix includes many built-in extensions that are fully integrated in the database server. Informix also provides DataBlade® modules, which are packages of extended database objects for a particular purpose and that are installed separately from the database server. Alternatively, you can create your own user-defined objects for Informix.
Data warehousing
In addition to designing and implementing Informix® dimensional databases, you can use tools to create data warehouse applications and optimize your data warehouse queries.
Designing databases
The first step in creating a relational database is to construct a data model, which is a precise, complete definition of the data you want to store. After you prepare your data model, you must implement it as a database and tables. To implement your data model, you first select a data type for each column and then you create a database and tables and populate the tables with data. You can also implement fragmentation strategies and control access to your data.
JSON compatibility
You can use the popular JSON-oriented query language created by MongoDB to interact with data stored in HCL Informix®.
Security
You can secure your Informix® database server and the data that is stored in your Informix databases. You can encrypt data, secure connections, control user privileges and access, and audit data security.
SQL programming
You can use the HCL Informix® implementation of the SQL language to develop applications for Informix database servers.
- Guide to SQL: Syntax
  The Informix® Guide to SQL: Syntax describes the syntax of the statements, data types, expressions, operators, and built-in functions of the Informix dialect of the SQL language.
  - Overview of SQL syntax
    These topics provide an overview about how to use the SQL statements, SPL statements, and syntax segments.
  - SQL statements
    This chapter describes the syntax and semantics of SQL statements that are recognized by Informix®.
  - SPL statements
    These topics describe Stored Procedure Language (SPL) statements, which you use to write SPL routines. You can store these routines in the database as user-defined routines (UDRs).
  - Data types and expressions
    These topics describe the data types and expressions that Informix®supports.
  - Other syntax segments
    These topics describe syntax segments, which are language elements, such as database object names or optimizer directives, that appear as a subdiagram reference in the syntax diagrams of some SQL or SPL statements.
  - Built-In Routines
    - Interval functions
      Use the interval functions to return an INTERVAL value from arguments that include a number and a character-string representing time units and separators in INTERVAL qualifiers. These functions are useful in CREATE TABLE, CREATE INDEX, and ALTER FRAGMENT statements that define or modify range-interval distributed storage strategies for indexes and tables.
    - Session Configuration Procedures
    - BSON processing functions
      BSON processing functions manipulate BSON data. Some SQL statements require function expressions that call these built-in functions.
    - DataBlade® Module Management Functions
      From sessions connected to Informix® databases that support explicit transaction logging, you can register or unregister DataBlade® modules by issuing SQL statements that call the built-in SYSBldPrepare( ) function. Another built-in function, SYSBldRelease( ), returns the version string of the SYSBldPrepare( ) function in the local database.
    - The EXPLAIN_SQL Routine
      The Data Studio Administration Edition can use the EXPLAIN_SQL routine to obtain a query plan in XML format, interpret the XML, and render the plan visually.
    - UDR Definition Routines
    - jvpcontrol Function
    - SQLJ Driver Built-In Procedures
    - Extended Utilities
  - Appendixes
- Guide to SQL: Reference
  These topics contain the reference information for the system catalog tables, data types, and environment variables of the HCL Informix® dialect of the SQL language, as implemented in HCL Informix. These topics also include information about the stores_demo, sales_demo, and superstore_demo databases that are included with HCL Informix.
- Guide to SQL: Tutorial
  This publication shows how to use basic and advanced structured query language (SQL) to access and manipulate the data in your databases. It discusses the data manipulation language (DML) statements as well as triggers and stored procedure language (SPL) routines, which DML statements often use.
Troubleshooting HCL Informix®
Several troubleshooting techniques, tools, and resources are available for resolving problems that you encounter in your HCL Informix® database server environment.
Informix PDF guides

sqlj.setUDTextName

Use the sqlj.setUDTextName( ) procedure to define the mapping between a user-defined data type and a Java™ class.

sqlj.SetUDTextName


Argument	Description	Restrictions	Syntax
class_id	Java™ class that contains the Java™ data type	Qualified name package_id.class_id must not exceed 255 bytes	Language-specific rules for Java™ identifiers
data_type	User-defined type for which to create a mapping	Name must not exceed 255 bytes	Identifier
package_id	Name of package that contains the class_id Java™ class	Same length restrictions as class_id	Language-specific rules for Java™ identifiers

You must have registered the user-defined data type in the CREATE DISTINCT TYPE, CREATE OPAQUE TYPE, or CREATE ROW TYPE statement.

To look up the Java™ class for a user-defined data type, the database server searches in the JAR-file path, which the sqlj.alter_java_path( ) procedure has specified. For more information on the JAR-file path, see sqlj.alter_java_path.

The SQLJ Driver looks in the path that CLASSPATH specifies in the client environment before it asks the database server for the name of the Java™ class.

The setUDTextName( ) routine is an extension to the SQLJ:SQL Routines Using the Java™ Programming Language specification.

If the IFX_EXTEND_ROLE configuration parameter is enabled (which is its default setting), only the DBSA or users who hold the EXTEND role are able to execute the setUDTextName( ) procedure. When IFX_EXTEND_ROLE is disabled, any user can execute setUDTextName( ). (But regardless of the IFX_EXTEND_ROLE setting, you must hold the Resource privilege or the DBA privilege on the database, and also hold the Usage privilege on the Java™ language, before you can create or drop a Java™ UDR.)