IBM WebSphere Business Integration Adapter manual

Contents

Main Page Page Page Page Page Contents Page About this document Audience Related documents Typographic conventions viii Chapter 1. Overview of the connector Connector architecture 2 How the connector works Processing subscriptions Event detection and notification Status updates Event retrieval Processing verbs (operations) Processing service call requests Status updates Page Chapter 2. Installing and configuring the connector Prerequisites for installing the connector Installing the connector on a Windows or UNIX system Step for installing the standard files Installed file structure Configuring the connector 8 Standard connector properties LogAtInterchangeEnd MessageFileName Connector-specific properties Configuring start_i2.bat (for Windows) or start_i2.sh (for UNIX) Starting the connector Chapter 3. Understanding business objects for the connector Defining connector metadata Overview of business object structure i2 business object structure Supported Verb= 12 Wrapper BO Operation Metaobject (MO Instance) Output type BO Input type BO Configuring metaobjects for polling I2MO_AddBid InstanceId=CA_Instance WrapperBOName=IBM_Bidding_BO Verb=Dummy Specifying business object attribute properties 14 The following table shows the properties for child object attributes. Special attribute values Identifying business object application-specific information Application-specific information at the business object- level Application-specific information at the attribute level Page Chapter 4. Generating business objects using i2 ODA Overview of i2 ODA Installing i2 ODA Steps for installing i2 ODA Other installation requirements Launching i2 ODA 18 Working with error and trace message files Using i2 ODA in Business Object Designer Steps for using i2ODA Select the Agent 20 Configure agent properties Expand nodes and select port types, operations, and input/output types Confirm selection, generate wrapper business object, and save 22 Complete the business object and generate the business objects for the types Save the business object files 24 Create the metaobject for polling Page Chapter 5. Troubleshooting and error handling Logging error messages Structure of error messages Polling-related error messages 28 Service call request processing error messages Tracing messages 30 Tips for troubleshooting Page Appendix A. Standard configuration properties for connectors New and deleted properties Configuring standard connector properties for WebSphere InterChange Server 34 Page 36 AdminInQueue AdminOutQueue AgentConnections AgentTraceLevel ApplicationName BrokerType 38 CharacterEncoding ConcurrentEventTriggeredFlows ContainerManagedEvents ControllerStoreAndForwardMode ControllerTraceLevel DeliveryQueue DeliveryTransport 40 WebSphere MQ and IDL JMS DuplicateEventElimination FaultQueue JvmMaxHeapSize JvmMaxNativeStackSize Page LogAtInterchangeEnd MaxEventCapacity MessageFileName OADAutoRestartAgent OADMaxNumRetry OADRetryTimeInterval 44 PollEndTime PollFrequency RepositoryDirectory ResponseQueue RestartRetryCount RestartRetryInterval SourceQueue SynchronousRequestTimeout TraceFileName 46 WireFormat Configuring standard connector properties for WebSphere MQ Integrator Page AdminInQueue AdminOutQueue 48 AgentTraceLevel ApplicationName ContainerManagedEvents DeliveryQueue DeliveryTransport DuplicateEventElimination FaultQueue jms.FactoryClassName jms.MessageBrokerName 50 jms.NumConcurrentRequests jms.Password MessageFileName PollEndTime PollFrequency PollStartTime RepositoryDirectory RequestQueue ResponseQueue 52 RestartRetryCount RestartRetryInterval Page Page Appendix B. Connector Configurator Using Connector Configurator in an internationalized environment Starting Connector Configurator Running Configurator from System Manager 56 Running Configurator independently of System Manager Choosing your broker Using a connector-specific property template Creating a template of connector-specific properties 58 Specifying general characteristics Specifying values Setting dependencies Creating a configuration file from a connector-specific template 60 Using Connector Configurator with ICS as the broker Completing a configuration file Using an existing file 62 Using an existing System Manager project Setting the configuration file properties (ICS) Setting standard connector properties (ICS) Setting application-configuration properties (ICS) 64 Encryption for connector properties (ICS) Update method (ICS) Specifying supported business object definitions (ICS) Business object name Agent support Maximum transaction level 66 Associated maps (ICS) Resources (ICS) Setting trace/log file values (ICS) Configuring messaging Data handlers 68 Setting the configuration file properties (WebSphere MQ Integrator Broker) Setting standard connector properties Setting application-configuration properties Encryption for connector properties Update method 70 Specifying supported business object definitions Setting trace/log file values Configuring data handlers Using standard and connector-specific properties with Connector Configurator Completing the configuration 72 Appendix C. Connector feature list Event notification features The following table details the event notification features supported by the connector. Service call request handling features The following table details the service call request handling features supported by the connector. General features The following table details the general features supported by the connector. 74 Page Page Appendix D. Notices Programming interface information Trademarks and service marks 78