[an error occurred while processing this directive] PATH Documentation > WebObjects 4.5 > InformixEOAdaptor Reference

InformixChannel

Inherits from: EOAdaptorChannel : NSObject

Declared in: InformixEOAdaptor/InformixChannel.h
InformixEOAdaptor/InformixDescription.h

Class Description

An InformixChannel represents an independent communication channel to the database server its InformixAdaptor is connected to. All of an InformixChannel's operations take place within the context of transactions controlled or tracked by its InformixContext. An InformixContext can manage multiple InformixChannels, and a channel is associated with only one context.

The features InformixChannel adds to EOAdaptorChannel are as follows:

Informix-specific error handling (see InformixChannel Delegate)
The ability to configure the fetch buffer
The ability to read a list of table names from the database

Method Types

Finding table names

- setInformixTableNamesSQL:

- informixTableNamesSQL

Getting the cursor data area

- cursorDataArea

Setting the isolation level

- informixSetIsolationTo:

Setting the fetch buffer length

- setFetchBufferLength:

- fetchBufferLength

Instance Methods

cursorDataArea

- (struct informix_cursor *)cursorDataArea

If the channel is connected, returns an Informix-specific data structure describing characteristics of the channel. Otherwise, returns NULL.

fetchBufferLength

- (unsigned)fetchBufferLength

Returns the size, in bytes, of the fetch buffer. The larger the buffer, the more rows can be returned for each round trip to the server.

informixSetIsolationTo:

- (void)informixSetIsolationTo:(InformixIsolationLevel)isolationLevel

Sets the isolation transaction level of the connection represented by the receiver to isolationLevel.

informixTableNamesSQL

- (NSString *)informixTableNamesSQL

Returns the SQL statement the receiver uses to find table names. The user default InformixTableNamesSQL overrides a statement set with setInformixTableNamesSQL:.

setFetchBufferLength:

- (void)setFetchBufferLength:(unsigned)length

Sets the size (in bytes) of the fetch buffer to length. The larger the buffer, the more rows can be returned for each round trip to the server.

setInformixTableNamesSQL:

- (void)setInformixTableNamesSQL:(NSString *)sql

Set the SQL statement the receiver uses to find table names to sql.