Home
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.install_jar

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
  The Informix® Guide to SQL: Reference contains 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
  The Informix® Guide to SQL: Tutorial 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.

sqlj.install_jar

Use the sqlj.install_jar( ) procedure to install a JAR file in the current database and assign to it a JAR identifier.

^{(explicit id sij001)
sij001}

sqlj.install_jar

sqlj.install_jar

(jar_file, <Jar Name>^[] , { 0 | deploy } )


Argument	Description	Restrictions	Syntax
deploy	Integer that causes the procedure to search for deployment descriptor files in the JAR file	None	Literal Number
jar_file	URL of the JAR file that contains the Java™ language UDR	Maximum length of the URL is 255 bytes	Quoted String

For example, consider a Java™ class Chemistry that contains the following static method explosiveReaction( ):

public static int explosiveReaction(int ingredient)

Here the Chemistry class resides in this JAR file on the server computer:

/students/data/Courses.jar

You can install all classes in the Courses.jar file in the current database with the following call to the sqlj.install_jar( ) procedure:

EXECUTE PROCEDURE 
   sqlj.install_jar("file://students/data/Courses.jar", "course_jar");

The sqlj.install_jar( ) procedure assigns the JAR ID, course_jar, to the Courses.jar file that it has installed in the current database.

After you define a JAR ID in the database, you can use that JAR ID when you create and execute a UDR written in the Java™ language. (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.)

When you specify a nonzero number for the third argument, the database server searches through any included deployment descriptor files. For example, you might want to include descriptor files that include SQL statements to register and grant privileges on UDRs in the JAR file.

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 sqlj.install_jar( ) procedure. When IFX_EXTEND_ROLE is disabled, any user can execute sqlj.install_jar( ).

¹ See Jar Name