Table 4 provides a quick reference to the standard connector configuration properties. Not all the connectors make use of all these properties, and property settings may differ from integration broker to integration broker, as standard property dependencies are based on RepositoryDirectory.
You must set the values of some of these properties before running the connector. See the following section for an explanation of each property.
Table 4. Summary of standard configuration properties
Property name | Possible values | Default value | Update method | Notes |
---|---|---|---|---|
AdapterHelpName |
Droplist consisting of valid subdirectories in HomeDirectory\bin\Data \App\Help\Regional Setting\ | Template name if valid or None |
Component restart |
Supported regional settings include chs_chn, cht_twn, deu_deu, esn_esp, fra_fra, ita_ita, jpn_jpn, kor_kor, ptb_bra, and enu_usa (default). |
AdminInQueue | Valid JMS queue name | CONNECTORNAME /ADMININQUEUE |
Component restart |
Delivery Transport is JMS |
AdminOutQueue | Valid JMS queue name | CONNECTORNAME/ADMINOUTQUEUE |
Component restart |
Delivery Transport is JMS |
AgentConnections | 1-4 | 1 |
Component restart |
Delivery Transport is MQ or IDL: Repository directory is <REMOTE> (broker is ICS) |
AgentTraceLevel | 0-5 | 0 | Dynamic |
|
ApplicationName | Application name |
Value specified for the connector application name |
Component restart |
|
BiDi.Application |
Any valid combination of the BiDi attributes:
| ILYNN (5 letters) |
Component restart |
BiDi.Transforma tion is true: |
BiDi.Broker |
Any valid combination of the BiDi attributes:
| ILYNN (5 letters) |
Component restart | Applicable only
if: BiDi.Transforma tion is true:
|
BiDi.Metadata |
Any valid combination of the BiDi attributes:
| ILYNN (5 letters) |
Component restart |
BiDi.Transforma tion is true |
BiDi.Transformation | true or false | false |
Component restart | Applicable only
if BrokerType is not WAS |
BrokerType | ICS, WMQI, WAS |
|
Component restart |
|
CharacterEncoding | Any supported code.
The droplist shows this subset: ascii7, ascii8, SJIS, Cp949, GBK, Big5, Cp297, Cp273, Cp280, Cp284, Cp037, Cp437 | ascii7 |
Component restart |
|
CommonEventInfrastructure | true or false | false |
Component restart |
|
CommonEventInfrastructure
ContextURL.
|
URL string. For example, corbaloc:iiop:host:2809 | None |
Component restart |
CommonEvent Infrastructure is true |
ConcurrentEventTriggeredFlows | 1 to 32,767 | 1 |
Component restart |
Repository directory is <REMOTE> (broker is ICS) |
ContainerManagedEvents | No value or JMS | No value |
Component restart |
Delivery Transport is JMS |
ControllerEventSequencing | true or false | true | Dynamic |
Repository directory is <REMOTE> (BrokerType is ICS) |
ControllerStoreAndForwardMode | true or false | true | Dynamic |
Repository directory is <REMOTE> (BrokerType is ICS) |
ControllerTraceLevel | 0-5 | 0 | Dynamic |
Repository directory is <REMOTE> (broker is ICS) |
DeliveryQueue |
| CONNECTORNAME/DELIVERYQUEUE |
Component restart |
JMS transport only |
DeliveryTransport | MQ, IDL, or JMS | JMS |
Component restart |
If Repository directory is local, then value is JMS only |
DuplicateEventElimination | true or false | false |
Component restart |
JMS transport only: Container Managed Events must be <NONE> |
FaultQueue |
| CONNECTORNAME/FAULTQUEUE |
Component restart |
JMS transport only |
jms.FactoryClassName | CxCommon.Messaging.jms
.IBMMQSeriesFactory or CxCommon.Messaging
.jms.SonicMQFactory
or any Java class name | CxCommon.Messaging. jms.IBMMQSeriesFactory |
Component restart |
JMS transport only |
jms.ListenerConcurrency | 1-32767 | 1 |
Component restart |
jms. Transport Optimized is true |
jms.MessageBrokerName | If FactoryClassName is
IBM, use crossworlds.queue. manager. If FactoryClassName is Sonic, use localhost:2506. | crossworlds.queue.manager |
Component restart |
JMS transport only |
jms.NumConcurrentRequests | Positive integer | 10 |
Component restart |
JMS transport only |
jms.Password | Any valid password |
|
Component restart |
JMS transport only |
jms.TransportOptimized | true or false | false |
Component restart |
Delivery Transport is JMS: BrokerType is ICS |
jms.UserName | Any valid name |
|
Component restart |
JMS transport only |
JvmMaxHeapSize | Heap size in megabytes | 128m |
Component restart |
Repository directory is <REMOTE> (BrokerType is ICS) |
JvmMaxNativeStackSize | Size of stack in kilobytes | 128k |
Component restart |
Repository directory is <REMOTE> (BrokerType is ICS) |
JvmMinHeapSize | Heap size in megabytes | 1m |
Component restart |
Repository directory is <REMOTE> (BrokerType is ICS) |
ListenerConcurrency | 1- 100 | 1 |
Component restart |
Delivery Transport must be MQ |
Locale | en_US, ja_JP, ko_KR,
zh_CN, zh_TW, fr_FR, de_DE, it_IT, es_ES, pt_BR
| en_US |
Component restart |
|
LogAtInterchangeEnd | true or false | false |
Component restart |
Repository Directory must be <REMOTE> (BrokerType is ICS) |
MaxEventCapacity | 1-2147483647 | 2147483647 | Dynamic |
Repository Directory must be <REMOTE> (BrokerType is ICS) |
MessageFileName | Path or filename | CONNECTORNAMEConnector.txt |
Component restart |
|
MonitorQueue | Any valid queue name | CONNECTORNAME/MONITORQUEUE |
Component restart |
JMS transport only: DuplicateEvent Elimination must be true |
OADAutoRestartAgent | true or false | false | Dynamic |
Repository Directory must be <REMOTE> (BrokerType is ICS) |
OADMaxNumRetry | A positive number | 1000 | Dynamic |
Repository Directory must be <REMOTE> (BrokerType is ICS) |
OADRetryTimeInterval |
A positive number in minutes | 10 | Dynamic |
Repository Directory must be <REMOTE> (BrokerType is ICS) |
PollEndTime | HH:MM | HH:MM |
Component restart |
|
PollFrequency |
A positive integer in milliseconds
no (to disable polling) key (to poll only when
| 10000 | Dynamic |
|
PollQuantity | 1-500 | 1 |
Agent restart |
JMS transport only: Container Managed Events is specified |
PollStartTime | HH:MM(HH is 0-23, MM is 0-59) | HH:MM |
Component restart |
|
RepositoryDirectory | Location of metadata
repository |
|
Agent restart |
For ICS: set to <REMOTE> For WebSphere MQ message brokers and WAS: set to C:\crossworlds\ repository |
RequestQueue | Valid JMS queue name | CONNECTORNAME/REQUESTQUEUE |
Component restart |
Delivery Transport is JMS |
ResponseQueue | Valid JMS queue name | CONNECTORNAME/RESPONSEQUEUE |
Component restart |
Delivery Transport is JMS: required only if Repository directory is <REMOTE> |
RestartRetryCount | 0-99 | 3 | Dynamic |
|
RestartRetryInterval |
A sensible positive value in minutes: 1 - 2147483547 | 1 | Dynamic |
|
ResultsSetEnabled | true or false | false |
Component restart |
Only if Delivery Transport is JMS and BrokerType is WMQI |
ResultsSetSize | Positive integer | 0 |
Component restart |
Only if Results SetEnabled is true. A value of zero means the results set size is unbounded. |
RHF2MessageDomain | mrm, xml | mrm |
Component restart |
Only if Delivery Transport is JMS and WireFormat is CwXML . |
SourceQueue |
Valid WebSphere MQ name | CONNECTORNAME/SOURCEQUEUE |
Agent restart |
Only if Delivery Transport is JMS and Container Managed Events is specified |
SynchronousRequestQueue |
| CONNECTORNAME/ SYNCHRONOUSREQUESTQUEUE |
Component restart |
Delivery Transport is JMS |
SynchronousRequestTimeout | 0 - any number (millisecs) | 0 |
Component restart |
Delivery Transport is JMS |
SynchronousResponseQueue |
| CONNECTORNAME/ SYNCHRONOUSRESPONSEQUEUE |
Component restart |
Delivery Transport is JMS |
TivoliMonitorTransaction
Performance | true or false | false |
Component restart |
|
WireFormat | CwXML, CwBO | CwXML |
Agent restart |
CwXML if Repository Directory is not <REMOTE>: CwBO if Repository Directory is <REMOTE> |
WsifSynchronousRequestTimeout | 0 - any number
(millisecs) | 0 |
Component restart | WAS only |
XMLNameSpaceFormat | short, long | short |
Agent restart |
WebSphere MQ message brokers and WAS only |