Contents


List of Figures

Preface

Chapter 1 Concepts

About UIF
UIF Architecture
UIF Abstractions Overview

UIF Internal Runtime Services
Repository Schema and Definitions
Enterprise Connector
Management Console
Enterprise Connector-to-EIS Architecture

UIF Tools
UIF API
UIF Application Development Model

Chapter 2 Installation

Summary of Installation Tasks
Checking Your Package
Checking Hardware and Software Requirements
Preparing to Install
Installing UIF

Installing on Windows NT
Installing on Unix

Uninstalling UIF

Uninstalling on Windows NT
Uninstalling on Unix

Troubleshooting Your Installation
Upgrade or Reinstall Issues
Cluster Installations

UIF and Enterprise Connector Clusters

Chapter 3 Repository

UIF Repository

Connector Types
Datasources

About the UIF Repository Browser

View Hierarchy
Data Object views

Using the UIF Repository Browser

Import a Node and its Subnodes
Export a Node and its subnodes
Delete a Node and its subnodes
Refresh the UIF Repository
Import the Root Node
View the Log

Troubleshooting Tips

Chapter 4 Pooling Concepts

About Pooling

Pooling Configuration

Bind Durations

Bind Duration Escalation
Bind Duration Timeouts

Chapter 5 Programming Model

Data Objects

Primitive Objects
Structure Objects
List Objects
Array Objects
Type Info Objects
API Naming Conventions
Attributes and Paths
Changing Data Types
Interface Hierarchy

Using the UIF API

Acquiring the UIF Runtime Object
Creating a Service Provider Object
Creating a Function Object
Setting Up and Executing the Function Object
Executing Multiple Function Objects

Developing J2EE I18N Applications with UIF

Chapter 6 Exceptions

About UIF Exceptions
Exception Scenarios

Application Logic Errors
UIF Runtime Errors
Enterprise Connector Errors

UIF Exceptions Handling

Chapter 7 API Reference

IBSPRuntime Interface

Package
Methods
createFunctionObject()
createServiceProvider()
getServerContext()

IBSPServiceProvider Interface

Package
Methods
disable()
enable()
extendBindDuration()
getConfig()
isEnabled()

IBSPFunctionObject Interface

Package
Methods
execute()
getDataBlock()
getProperties()
getServiceProvider()
prepare()

IBSPDataObjectMgr Interface

Package
Methods
dumpDataObject()

IBSPDataObject Interface

Package
Attribute Access Methods
Other Methods
attrExists()
attrIsDefined()
copy()
getAttr()
getAttrBinary()
getAttrBinarySize()
getAttrCount()
getAttrDouble()
getAttrFloat()
getAttrFString()
getAttrFStringMaxLen()
getAttrInt()
getAttrString()
getAttrType()
getAttrVBinary()
getAttrVBinarySize()
getDataItr()
getTypeInfo()
isAttrType()
isType()
removeAttr()
setAttrBinary()
setAttrDataObject()
setAttrDataObjectList()
setAttrDataObjectStructure()
setAttrDouble()
setAttrFloat()
setAttrFString()
setAttrInt()
setAttrString()
setAttrVBinary()

IBSPDataObjectPrimitive Interface

Package
Methods
getBinary()
getBinarySize()
getDouble()
getFloat()
getFString()
getFStringMaxLen()
getInt()
getString()
getVBinary()
getVBinarySize()
setBinary()
setDouble()
setFloat()
setFString()
setInt()
setString()
setVBinary()

IBSPDataObjectPrimitiveInfo Interface

Package
Methods
getPrimDefault()
getPrimDefaultBinary()
getPrimDefaultDataObject()
getPrimDefaultDouble()
getPrimDefaultFloat()
getPrimDefaultFString()
getPrimDefaultFStringMaxLen()
getPrimDefaultInt()
getPrimDefaultVBinary()
getPrimSize()
getPrimType()
setPrimDefaultBinary()
setPrimDefaultDataObject()
setPrimDefaultDouble()
setPrimDefaultFloat()
setPrimDefaultFString()
setPrimDefaultInt()
setPrimDefaultString()
setPrimDefaultVBinary()

IBSPDataObjectCollection Interface
IBSPDataObjectList Interface

Package
Access Methods
Element Insertion and Deletion Methods
Other Methods
addElemBinary()
addElemDataObject()
addElemDataObjectList()
addElemDataObjectStructure()
addElemDouble()
addElemFloat()
addElemFString()
addElemInt()
addElemString()
addElemVBinary()
elemExists()
elemIsDefined()
getElem()
getElemBinary()
getElemBinarySize()
getElemCount()
getElemDataObject()
getElemDouble()
getElemFloat()
getElemFString()
getElemFStringMaxLen()
getElemInt()
getElemString()
getElemType()
getElemVBinary()
getElemVBinarySize()
getMaxElemCount()
isElemType()
removeElem()
setElemBinary()
setElemDataObject()
setElemDataObjectList()
setElemDataObjectStructure()
setElemDouble()
setElemFloat()
setElemFString()
setElemInt()
setElemString()
setElemVBinary()
setMaxElemCount()

IBSPDataObjectArray Interface

Package
addElem()
getElemTypeInfo()

IBSPDataObjectStructure Interface

Package
Access Methods
Other Methods
fieldExists()
fieldIsDefined()
getField()
getFieldBinary()
getFieldBinarySize()
getFieldCount()
getFieldDataObject()
getFieldDouble()
getFieldFloat()
getFieldFString()
getFieldFStringMaxLen()
getFieldInt()
getFieldString()
getFieldType()
getFieldVBinary()
getFieldVBinarySize()
isFieldType()
removeField()
setFieldBinary()
setFieldDataObject()
setFieldDataObjectList()
setFieldDataObjectStructure()
setFieldDouble()
setFieldFloat()
setFieldFString()
setFieldInt()
setFieldString()
setFieldVBinary()

IBSPDataObjectStructureInfo Interface

Package
Methods
definesField()
getFieldInfo()
getFields()

IBSPDataObjectInfo Interface

Package
Methods
createInstance()

IBSPDataObjectListInfo Interface

Package
Methods
getInitialSize()
getMaxElemCount()
setInitialSize()
setMaxElemCount()

IBSPDataObjectArrayInfo Interface

Package
Methods
getArrayElemType()
getArrayElemTypeInfo()
setArrayElemType()
setArrayElemTypeInfo()

IBSPDataObjectDataItr Interface

Package
Accessor Methods
Other Methods
getCurrent()
getCurrentBinary()
getCurrentBinarySize()
getCurrentDataObject()
getCurrentDouble()
getCurrentFieldName()
getCurrentFloat()
getCurrentFString()
getCurrentInt()
getCurrentString()
getCurrentType()
getCurrentVBinary()
getCurrentVBinarySize()
isCurrentType()
next()
setCurrentBinary()
setCurrentDataObject()
setCurrentDouble()
setCurrentFloat()
setCurrentFString()
setCurrentInt()
setCurrentString()
setCurrentVBinary()

BspException Class

Package
Methods
getInfo()

DataObjectException Class

Package

FieldNameIsNullException Class

Package

FieldNameTooLongException Class

Package

FieldNotFoundException Class

Package

IllegalPathException Class

Package

IllegalRecusionException Class

Package

IndexOutOfBoundsException Class

Package

MethodUnsupportedException Class

Package

TypeMismatchException Class

Package

Glossary

Index