IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > IBM i > Reference > Configuration properties > Outbound configuration properties
Managed connection factory properties
Managed connection factory properties are used by the adapter at run time to create an outbound connection instance with the IBM i system.
You set managed connection factory properties through the external service wizard when you configure the adapter. You can change them before deployment through the Integration Designer assembly editor or after deployment through the IBM BPM or WebSphere Enterprise Service Bus administrative console.
The following table describes the managed connection factory properties. More detailed information about each property is provided in tables that follow. For details about the information presented in these tables, see Guide to information about properties.
The external service wizard refers to these properties as managed connection factory properties, while the administrative console refers to them as J2C connection factory properties.
Managed connection factory properties for Adapter for IBM i Property name Description In the wizard In the administrative console Adapter ID AdapterID
Identifies the adapter instance for PMI events and for logging and tracing.
Disguise user data as "XXX" in log and trace files HideConfidentialTrace Specifies whether to disguise potentially sensitive information by writing X strings instead of user data in the log and trace files. Host name HostName The fully qualified host name or IP address of the host where the server is running Password Password Password for the corresponding user name.
User name UserName The IBM i system user name
Adapter ID (AdapterID)
This property identifies a specific deployment or instance of the adapter.
Adapter ID details Required Yes Default 001 Property type String Usage This property identifies the adapter instance in the log and trace files, and also helps identify the adapter instance while monitoring adapters. The adapter ID is used with an adapter-specific identifier, ISESRA, to form the component name used by the Log and Trace Analyzer tool. For example, if the adapter ID property is set to 001, the component ID is ISESRA001.
If you run multiple instances of the same adapter, ensure that the first seven characters of the adapter ID property are unique for each instance so that you can correlate the log and trace information to a particular adapter instance. By making the first seven characters of an adapter ID property unique, the component ID for multiple instances of that adapter is also unique, allowing you to correlate the log and trace information to a particular instance of an adapter.
For example, when you set the adapter ID property of two instances of WebSphere Adapter for IBM i to 001 and 002. The component IDs for those instances, ISESRA001 and ISESRA002, are short enough to remain unique, enabling you to distinguish them as separate adapter instances. However, instances with longer adapter ID properties cannot be distinguished from each other. If you set the adapter ID properties of two instances to Instance01 and Instance02, you will not be able to examine the log and trace information for each adapter instance because the component ID for both instances is truncated to ISESRAInstanc.
For inbound processing, the value of this property is set at the resource adapter level. For outbound processing, the value can be set both at the resource adapter level and the managed connection factory level. After you use the external service wizard to configure the adapter for outbound processing, you can set the resource adapter and managed connection factory properties independently. If you use the IBM Integration Designer assembly editor or the administrative console to reset these properties, ensure that you set them consistently, to prevent inconsistent marking of the log and trace entries.
Globalized Yes Bidi supported No
Disguise user data as "XXX" in log and trace files (HideConfidentialTrace)
This property specifies whether to replace user data in log and trace files with a string of X's to prevent unauthorized disclosure of potentially sensitive data.
Disguise user data as "XXX" in log and trace files details Required No Possible values True
FalseDefault False Property type Boolean Usage If you set this property to True, the adapter replaces user data with a string of X's when writing to log and trace files. For inbound processing, the value of this property is set at the resource adapter level. For outbound processing, the value can be set both at the resource adapter level and the managed connection factory level. After you use the external service wizard to configure the adapter for outbound processing, you can set the resource adapter and managed connection factory properties independently. If you use the IBM Integration Designer assembly editor or the administrative console to reset these properties, ensure that you set them consistently, to prevent inconsistent marking of the log and trace entries.
Globalized No Bidi supported No
Host name (HostName)
This property specifies the IP address or fully qualified name of the host where the IBM i system is running.
Host name details Required Yes Default No default value Property type String Usage Must be a valid server name Example user.us.ibm.com Globalized No Bidi supported No
Password (Password)
This property specifies the password for the IBM i system user name.
Password details Required Yes Default No default value Property type String Usage The password for the IBM i system user name. Typing an incorrect password will prevent the adapter from accessing the IBM i system. Globalized No Bidi supported No
User name (UserName)
This property specifies the user name for connecting to the IBM i system.
User name details Required Yes Default No default value Property type String Usage The user name for connecting to the IBM i system. Typing an incorrect user name will prevent the adapter from accessing the IBM i system. Globalized No Bidi supported No
Outbound configuration properties
Related tasks:
Setting managed (J2C) connection factory properties for embedded adapters