B Setting B2B Configuration Properties in Fusion Middleware Control

Use Oracle Enterprise Manager Fusion Middleware Control to set B2B configuration properties for properties that are not set on the Configuration tab of the Oracle B2B interface (see Chapter 15, "Configuring B2B System Parameters"). B2B properties can also be set by using the configmbeanutil utility.

This appendix contains the following topics:

Section B.1, "Properties To Set in Fusion Middleware Control"
Section B.2, "Using the configmbeanutil Utility"

B.1 Properties To Set in Fusion Middleware Control

The following properties can be set in Oracle Enterprise Manager Fusion Middleware Control. See Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite for how to set the properties.

Note:

Restarting the SOA Server is required for changes to B2B properties.

To turn off validation during deployment, set this property to false:
```
b2b.deploy.validation
```
This is useful when deploying a large number of agreements where you are certain that the data is valid.
To set the Metadata Service (MDS) instance cache size, set this property:
```
b2b.mdsCache cache_size
```
A ratio of 5:1 is recommended for the xmx-to-mdsCache values. For example, if the xmx size is 1024, maintain mdsCache at 200 MB.
To set the number of threads and thread sleep time to improve message processing, set the following:
```
b2b.inboundThreadCount
b2b.inboundThreadSleepTime 
b2b.outboundThreadCount
b2b.outboundThreadSleepTime
b2b.defaultThreadCount
b2b.defaultThreadSleepTime
```
The recommended values for b2b.inboundThreadCount and b2b.outboundThreadCount depend on your system. For a 2 GB computer, a setting of 3 to 5 is recommended.

The b2b.inboundThreadSleepTime and b2b.inboundThreadSleepTime properties put a thread to sleep after message processing. A setting between 10 and 1000 (milliseconds) is recommended.
To set up File, FTP, or Email transports in an HA environment, specify a unique name for each instance by using
```
b2b.HAInstanceName unique_instance_name
```
If you use #ServerName# for the value, B2B retrieves the WebLogic Server name as the HAInstanceName.
To swap the interchange and group IDs in the generated FA from the sender to the receiver and vice versa, set this property to true:
```
b2b.FAInternalProperties
```
Caution:
This property should not be set using Oracle Enterprise Manager Fusion Middleware Control Console. Use the Functional Ack internal properties configuration parameters on the Administration > Configuration tab. Settings on the Configuration tab override properties set using the Oracle Enterprise Manager Fusion Middleware Control Console.

The test usage indicator parameter is also mapped; that is, an inbound message set as a test message generates an FA with the flag set to test message. Setting b2b.FAInternalProperties to true, by default, does not map ISA segment elements (1-4).
To specify how a functional acknowledgment is handled, set this property to true or false:
```
b2b.FAHandledByB2B
```
Caution:
This property should not be set using Oracle Enterprise Manager Fusion Middleware Control Console. Use the Functional Ack Handled by B2B configuration parameter on the Administration > Configuration tab. Settings on the Configuration tab override properties set using the Oracle Enterprise Manager Fusion Middleware Control Console.

When the b2b.FAHandledByB2B property is set to false, then for an inbound EDI message, B2B does not generate a functional acknowledgment (FA).

If the FA is marked as expected in an agreement, then the message is placed into the MSG_WAIT_FA state and the back-end application is expected to generate the FA and push it to B2B as an outbound message back to the partner.

The following limitations apply when generating the FA from the back-end application:
- The FA is correlated with the original message based on the ReferToMsgID value set in the enqueue properties. The FA is correlated based on control numbers also.
- If the FA indicates that there was an error in the received message, the status of the correlated message is not updated to indicate an error. The correlated message is updated to MSG_COMPLETE.
These limitations are not present when the FA is generated by B2B (that is, when b2b.FAHandledByB2B is true).
To specify how errors are flagged, set this parameter to true or false:
```
b2b.outboundOneErrorAllError
```
For outbound messages, b2b.outboundOneErrorAllError can be set to true or false. The default is false. If the parameter is set to true, then for outbound messages, even with a single message in error, all outbound batch messages are set to the error state. None of the batched messages are sent to the trading partner.

When using the b2b.outboundOneErrorAllError parameter, inbound messages behave as if b2b.outboundOneErrorAllError is set to false; that is, if an error occurs during an inbound message process, then only that message is flagged with the error and other messages are passed. There is no option to flag every message as failed.
To turn on payload obfuscation, set this property to true:
```
b2b.payloadObfuscation
```
See Section 1.4.1, "Payload Obfuscation," for more information.
To ignore interchange validation errors for EDI messages, use this property:
```
b2b.edi.ignoreValidation
```
If you add or update this flag, a server restart is not needed. However, if you remove the flag, the server must be restarted for the change to take effect.
To check for duplicate messages, use this property:
```
b2b.checkDuplicate
```
If this property is set to false, a check for a duplicate of the incoming business message is not performed. By default, Oracle B2B checks for duplicate messages based on the business message ID of the incoming message.

B.2 Using the configmbeanutil Utility

You can also use the configmbeanutil utility to set properties.

To use the configmbeanutil utility:

Note:

To access the Fusion Middleware directory, you must provide an mbean property file (mbeanutil.properties) that contains host, port, user, and password information. For example,

host=myfmw.com
port=7001
user=weblogic
password=mypwd

Set the MW_HOME environment variable to point to the Fusion Middleware installation directory. For example,
```
setenv MW_HOME /scratch/$user/fmwhome
```

Set the JAVA_HOME environment variable. For example,

setenv JAVA_HOME ${MW_HOME}/jdk160_14_R27.6.4-18

Add the Java bin directory to the PATH environment variable. For example,
```
setenv PATH ${JAVA_HOME}/bin:${PATH}
```

Example B-1, Example B-2, Example B-3, and Example B-4 show uses for this utility.

Example B-1 To Print All Properties to the Console

java -cp $MW_HOME/AS11gR1SOA/soa/modules/oracle.soa.b2b_11.1.1/b2b.jar:$MW_HOME/
wlserver_10.3/server/lib/wljmxclient.jar:$MW_HOME/modules/
glassfish.jaxb_1.2.0.0_2-1-7.jar oracle.tip.b2b.utility.ConfigMBeanUtility

Example B-2 To Add a Property

java -cp $MW_HOME/AS11gR1SOA/soa/modules/oracle.soa.b2b_11.1.1/b2b.jar:$MW_HOME/
wlserver_10.3/server/lib/wljmxclient.jar:$MW_HOME/modules/
glassfish.jaxb_1.2.0.0_2-1-7.jar oracle.tip.b2b.utility.ConfigMBeanUtility add b2b.test cool ok

Example B-3 To Update a Property

java -cp $MW_HOME/AS11gR1SOA/soa/modules/oracle.soa.b2b_11.1.1/b2b.jar:$MW_HOME/
wlserver_10.3/server/lib/wljmxclient.jar:$MW_HOME/modules/
glassfish.jaxb_1.2.0.0_2-1-7.jar oracle.tip.b2b.utility.ConfigMBeanUtility 
update b2b.test thru

Example B-4 To Remove a Property

java -cp $MW_HOME/AS11gR1SOA/soa/modules/oracle.soa.b2b_11.1.1/b2b.jar:$MW_HOME/
wlserver_10.3/server/lib/wljmxclient.jar:$MW_HOME/modules/
glassfish.jaxb_1.2.0.0_2-1-7.jar oracle.tip.b2b.utility.ConfigMBeanUtility 
remove b2b.test