For how to configure Oracle Coherence, see Configuring Oracle Coherence.

If there is no Oracle Coherence Cluster is running, start your own cluster, making sure you configure the path of the configuration files into the Java Class Path and ahead of where coherence.jar is. See the following listing for an example.

See Configuring Oracle Tuxedo Java Server for instruction.

Configure TMJAVASVR on UBBCONFIG. TMJAVASVR uses multi-threaded configuration to improve performance. Multi-instances configuration is also used to gain higher availability.

Listing UBBCONFIG for TMJAVASVR

*RESOURCE
...
MODEL       SHM
...
*MACHINES
"m1"        LMID=L1
...
*GROUPS
JGRP1   LMID=L1 GRPNO=10
 
...
TMJAVASVR   SRVGRP=JGRP1   SRVID=10
            MINDISPATCHTHREADS=4 MAXDISPATCHTHREADS=4 MIN=2 MAX=2
            CLOPT="-- -c /home/scott/tuxedo/dom1/config/tdcsvr_coh.xml"    
...

On Oracle Tuxedo native client or workstation client, use TDC API tpgetcache and tpcacheput to put an Oracle Tuxedo buffer associated with a key into an Oracle Tuxedo cache. For more information about tpgetcache and tpcacheput, see Oracle Tuxedo Distributed Caching (TDC) Related ATMI APIs.

Listing Put an Oracle Tuxedo buffer associated with a key into an Oracle Tuxedo cache

...
    TCACHE* mycache = NULL;
    char mykey[128];
    char* databuf = NULL;
 
    tpinit(NULL);
    databuf = tpalloc("STRING", NULL, 256);
 
    mycache = tpgetcache("tc");
    strcpy(mykey, "myname");
    strcpy(databuf, "scott");
    tpcacheput(mycache, mykey, databuf, 0, 0L);
 
    tpfree(databuf);
...

On Oracle Tuxedo native client or workstation client, use TDC API tpgetcache and tpcacheget to get an Oracle Tuxedo buffer associated with a key into an Oracle Tuxedo cache. For more information about tpgetcache and tpcacheget, see Oracle Tuxedo Distributed Caching (TDC) Related ATMI APIs.

Listing Get an Oracle Tuxedo buffer from an Oracle Tuxedo cache according to the key

...
    TCACHE* mycache = NULL;
    char mykey[128];
    char* databuf = NULL;
 
    tpinit(NULL);
    databuf = tpalloc("STRING", NULL, 256);
 
    mycache = tpgetcache("tc");
    strcpy(mykey, "myname");
    tpcacheget(mycache, mykey, &databuf, NULL, 0L); 

    tpfree(databuf);
...

• Prepare tangosol-coherence-override.xml in ${APPDIR}/config. See the following listing.

  Configure Oracle Coherence cluster coherence_tux whose multicast port number is 51697 and unicast port number is 51687.

• Prepare coherence-cache-config.xml in ${APPDIR}/config. See the following listing.

  Configure Oracle Coherence cache tux_distributed.

Listing Prepare tangosol-coherence-override.xml

<?xml version='1.0'?>

<coherence xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns="http://xmlns.oracle.com/coherence/coherence-operational-config"

xsi:schemaLocation="http://xmlns.oracle.com/coherence/coherence-operational-co
nfig coherence-operational-config.xsd">
   <cluster-config>
      <member-identity>
          <cluster-name 
system-property="tangosol.coherence.cluster">coherence_tux</cluster-name>
    </member-identity>
    <unicast-listener>
      <address 
system-property="tangosol.coherence.localhost">localhost</address>

       <port system-property="tangosol.coherence.localport">51687</port>
    </unicast-listener> 
    <multicast-listener>
          <port system-property="tangosol.coherence.clusterport">51697</port>
       </multicast-listener>
   </cluster-config>
</coherence>

Listing Prepare coherence-cache-config.xml

<?xml version="1.0"?>

<cache-config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xmlns="http://xmlns.oracle.com/coherence/coherence-cache-config"

xsi:schemaLocation="http://xmlns.oracle.com/coherence/coherence-cache-config 
coherence-cache-config.xsd">

<caching-scheme-mapping>

  <cache-mapping>

     <cache-name>tux_distributed</cache-name>
     <scheme-name>distributed</scheme-name>
   </cache-mapping>
</caching-scheme-mapping>
 
<caching-schemes>
  <distributed-scheme>
    <scheme-name>distributed</scheme-name>  
    <service-name>DistributedCache</service-name>
      <lease-granularity>member</lease-granularity>
    <backing-map-scheme>
       <local-scheme/>
     </backing-map-scheme>
      <autostart>true</autostart>
    </distributed-scheme>
  </caching-schemes>
</cache-config>

If no Oracle Coherence cluster is running, you can start your own cluster.

java -server -showversion $JAVA_OPTS -Dtangosol.coherence.mode=prod -cp 
${APPDIR}/config: ${COHERENCE_HOME}/lib/coherence.jar 
com.tangosol.net.DefaultCacheServer

• Preparing tdcsvr_coh.xml for Oracle Tuxedo java server
  
• Prepare tdcsvr_coh.conf for TDC property file
  

Configure TMJAVASVR in UBBCONFIG.

See the following Listing, where multi-threaded configuration is enabled and TMJAVASVR configuration file tdcsvr_coh.xml is set.

Listing Configure TMJAVASVR in UBBCONFIG

*RESOURCES
...
MODEL SHM
...
*MACHINES

"m1"      LMID=L1
...
*GROUPS
JGRP1     LMID=L1 GRPNO=10
 
...
TMJAVASVR SRVGRP=JGRP1 SRVID=10
           MINDISPATCHTHREADS=4 MAXDISPATCHTHREADS=4 MIN=2 MAX=2
           CLOPT="-- -c /home/scott/tuxedo/dom1/config/tdcsvr_coh.xml"
...

Put an Oracle Tuxedo STRING buffer associated with a key mykey into an Oracle Tuxedo cache tc.

Listing Put an Oracle Tuxedo buffer

...
      TCACHE* mycache = NULL;
      char mykey[128];
      char* databuf = NULL;
 
      tpinit(NULL);
      databuf = tpalloc("STRING", NULL, 256);
 
      mycache = tpgetcache("tc");
      strcpy(mykey, "myname");
      strcpy(databuf, "scott");
      tpcacheput(mycache, mykey, databuf, 0, 0L);  
 
      tpfree(databuf);
...
 

Get an Oracle Tuxedo typed buffer from an Oracle Tuxedo cache tc according to a key mykey.

Listing Get an Oracle Tuxedo buffer

...

    TCACHE* mycache = NULL;
    char mykey[128];
    char* databuf = NULL;
 
    tpinit(NULL);
    databuf = tpalloc("STRING", NULL, 256);
 

    mycache = tpgetcache("tc");
    strcpy(mykey, "myname");
    tpcacheget(mycache, mykey, &databuf, NULL, 0L);  

    tpfree(databuf);
...

See Configuring Oracle Coherence for instruction.

If there is no Oracle Coherence Cluster is running, start your own cluster, making sure you configure the path of the configuration files into the Java Class Path and ahead of where coherence.jar is. See the following Listing for an example.

See Configuring Oracle Tuxedo Java Server for instruction.

Configure TDC on UBBCONFIG.

• SERVICES Section
• CACHING Section

• SERVICES Section
  
• CACHING Section
  

You can use MIB to dynamically make changes for TDC.

For more information, see Oracle Tuxedo Distributed Caching (TDC) Related MIB Attributes.

Configure your VIEWTABLE. See the following Listing, where the buffer type is VIEW and the subtype is mystruct1.

Listing Configure VIEWTABLE

...
VIEW mystruct1
# type     cname     fbname     count     flag     size     null
string     name         -         1         -       31       -
string     address      -         1         -       255      -
char       age          -         1         -        -       -
END
...

Configure your UBBCONFIG. See the following Listing, where

TMJAVASVR is configured

Multi-threaded configuration is enabled and the configuration file tdcsvr_coh.xml is set.

Caching is enabled

Oracle Tuxedo service mysvc1 uses caching entry svccache1 to improve performance. svccache1 uses Oracle Tuxedo cache tc1 to cache the service result. The corresponding key of the response is the value of the request data.

Listing Configure UBBCONFIG

...
*GROUPS
JGRP1 LMID=L1 GRPNO=10
 
...
TMJAVASVR       SRVGRP=JGRP1 SRVID=10
                MINDISPATCHTHREADS=4 MAXDISPATCHTHREADS=4 MIN=2 MAX=2
                CLOPT="-- -c /home/scott/tuxedo/dom1/config/tdcsvr_coh.xml"
...
*SERVICES
mysvc1
        ...
        CACHING="svccache1"
...
*CACHING
svccache1
       CACHENAME="tc1"
       KEY=$request
...

Configure on server side. See the following Listing, where the request of mysvc1 is set as STRING and the response of mysvc1 is a VIEW32 mystruct1.

Listing Configure on Server Side

...
struct mystruct1* rsp;
int tpsvrinit(int argc, char *argv[])
{
       rsp = tpalloc("VIEW32", "mystruct1", sizeof(struct mystruct1));
}
...
void mysvc1(TPSVCINFO *rqst)
{
      int ret = 0;
      /*rqst->data is the name, getrsp will get data from the database and 
store into rsp*/
      ret = getrsp(rqst->data, rsp);
      if(ret < 0){
              tpreturn(TPFAIL, 0, NULL, 0L, 0);
      }
      tpreturn(TPSUCCESS, 0, rsp, 0L, 0);
}
...

Assume a data file is like this:

Listing Data File Example

...
Scott
Mike
Andy
Scott
Ben
Brian
Scott
Clark
...

Set on your client set like the following Listing.

At the first time where Scott is taken as the request, mysvc1 is invoked and the response is sent back and the response is cached into Oracle Tuxedo cache tc1 with a key Scott. As long as the data in the cache tc1 is not expired, all following requests for Scott to service mysvc1 will get response from the cache tc1 instead of invoking the service itself.

Listing Set on Client Set

...
struct mystruct1* rsp;
char* req;
int main(int argc, char *argv[])
{
      int ret;
      long olen = 0;
      rsp = tpalloc("VIEW32", "mystruct1", sizeof(struct mystruct1));
      req = tpalloc("STRING", NULL, 32);
      /*get name from the data file*/
      while(getname(req) == 0){
            tpcall("mysvc1",req, 0, &rsp, &olen,0);
}
}
...

tpgetcache - Get an Oracle Tuxedo Cache handle according to the configuration

#include "atmi.h"

TCACHE* tpgetcache(const char* name);

tpgetcache(3c) gets an Oracle Tuxedo cache handle according to Oracle Tuxedo cache name, which indicates the name of Oracle Tuxedo cache to be retrieved. The name must be 78 characters or less in length. tpgetcache(3c) is a thread-level API. The return handle TCACHE can only be used in the same thread.

Upon success, tpgetcache(3c) returns a handle typed TCACHE while is an internal structure.

Upon failure, tpgetcache(3c) returns NULL and sets tperrno to indicate the error condition. If a call fails with a particular tperrno value, a subsequent call to tperrordetail(3c), with no intermediate ATMI calls, may provide more detailed information about the generated error. Refer to the tperrordetail(3c) reference page for more information.

[TPEINVAL]

Invalid arguments were given (for example, conf is NULL).

[TPENOENT]

The requested cache does not exist.

[TPETIME]

This error code indicates that a timeout has occurred

[TPESYSTEM]

An Oracle Tuxedo system error has occurred. The exact nature of the error is added to the ULOG.

[TPEOS]

An operating system error has occurred.

[TPESVCFAIL]

The Oracle Tuxedo cache server meets an error. tpurcode contains the exact error value. The possible values of tpurcode are list below:

TDC_ERR_CACHE_NOTEXIST

The error code indicates the requested Oracle Tuxedo cache does not exist.

TDC_ERR_CACHE_UNAVAIL

The error code indicates the requested Oracle Tuxedo cache is unavailable.

TDC_ERR_CACHENAME_INVALID

The error code indicates the requested Oracle Tuxedo cache is invalid.

tpcacheput - put an Oracle Tuxedo typed buffer into a cache, associating that buffer with a key

#include "atmi.h"
int tpcacheput(TCACHE* tc, char* key, char* data, long len, long flags);

tpcacheput(3c) puts an Oracle Tuxedo typed buffer into a cache, associating that buffer with a key. tc is returned by tpgetcache(3c). data points to the tuxedo typed buffer allocated by tpalloc(3c). len is the length of the data. If the type of the data does not require a length to be specified (for example, an FML fielded buffer), len is ignored (and may be 0). flags is reserved and must be 0L.

Upon success, tpcacheput(3c) returns 0.

Upon failure, tpcacheput(3c) returns -1 and sets tperrno to indicate the error condition. If a call fails with a particular tperrno value, a subsequent call to tperrordetail(3c), with no intermediate ATMI calls, may provide more detailed information about the generated error. Refer to the tperrordetail(3c) reference page for more information.

[TPEINVAL]

Invalid arguments were given.

[TPENOENT]

The requested cache does not exist.

[TPETIME]

This error code indicates that a timeout has occurred

[TPESYSTEM]

An Oracle Tuxedo system error has occurred. The exact nature of the error is added to the ULOG.

[TPEOS]

An operating system error has occurred.

[TPESVCFAIL]

The Oracle Tuxedo cache server meets an error. tpurcode contains the exact error value. The possible values of tpurcode are list below:

TDC_ERR_CACHE_NOTEXIST

The error code indicates the requested Oracle Tuxedo cache does not exist.

TDC_ERR_CACHE_UNAVAIL

The error code indicates the requested Oracle Tuxedo cache is unavailable.

TDC_ERR_CACHENAME_INVALID

The error code indicates the requested Oracle Tuxedo cache is invalid.

tpcacheget - get the Oracle Tuxedo typed buffer associated with the key from a cache

#include "atmi.h"
int tpcacheget(TCACHE* tc, char* key, char** odata, long* olen, long flags);

tpcacheget(3c) gets the Oracle Tuxedo typed buffer associated with the key from a cache. tc is returned by tpgetcache(3c). odata is the address of a pointer to the buffer where the data of the key is read into. It must point to a buffer originally allocated by tpalloc(3c). olen points to the length of the data. flags is reserved and must be 0L .

Upon success, tpcacheget(3c) returns 0.

Upon failure, tpcacheget(3c) returns -1 and sets tperrno to indicate the error condition. If a call fails with a particular tperrno value, a subsequent call to tperrordetail(3c), with no intermediate ATMI calls, may provide more detailed information about the generated error. Refer to the tperrordetail(3c) reference page for more information.

[TPEINVAL]

Invalid arguments were given.

[TPENOENT]

The requested cache does not exist.

[TPETIME]

This error code indicates that a timeout has occurred.

[TPESYSTEM]

An Oracle Tuxedo system error has occurred. The exact nature of the error is added to the ULOG.

[TPEOS]

An operating system error has occurred.

[TPESVCFAIL]

The Oracle Tuxedo cache server meets an error. tpurcode contains the exact error value. The possible values of tpurcode are list below:

TDC_ERR_CACHE_NOTEXIST

The error code indicates the requested Oracle Tuxedo cache does not exist.

TDC_ERR_CACHE_UNAVAIL

The error code indicates the requested Oracle Tuxedo cache is unavailable.

TDC_ERR_CACHENAME_INVALID

The error code indicates the requested Oracle Tuxedo cache is invalid.

TDC_ERR_KEY_NOTEXIST

The error code indicates the requested entry does not exist according to the specified key.

tpcacheremove - remove the cache entry associated with the parameter key from a cache

#include "atmi.h"
int tpcacheremove(TCACHE* tc, char* key, long flags);

tpcacheremove(3c) removes the cache entry associated with the parameter key from a cache. tc is returned by tpgetcache(3c). flags is reserved and must be 0L.

Upon success, tpcacheremove(3c) returns 0.

Upon failure, tpcacheremove(3c) returns -1 and sets tperrno to indicate the error condition. If a call fails with a particular tperrno value, a subsequent call to tperrordetail(3c), with no intermediate ATMI calls, may provide more detailed information about the generated error. Refer to the tperrordetail(3c) reference page for more information.

[TPEINVAL]

Invalid arguments were given.

[TPENOENT]

The requested cache does not exist.

[TPETIME]

This error code indicates that a timeout has occurred.

[TPESYSTEM]

An Oracle Tuxedo system error has occurred. The exact nature of the error is added to the ULOG.

[TPEOS]

An operating system error has occurred.

[TPESVCFAIL]

The Oracle Tuxedo cache server meets an error. tpurcode contains the exact error value. The possible values of tpurcode are list below:

TDC_ERR_CACHE_NOTEXIST

The error code indicates the requested Oracle Tuxedo cache does not exist.

TDC_ERR_CACHE_UNAVAIL

The error code indicates the requested Oracle Tuxedo cache is unavailable.

TDC_ERR_CACHENAME_INVALID

The error code indicates the requested Oracle Tuxedo cache is invalid.

tpcachemremove - remove cache entries associated with the parameter keyarray from a cache

#include "atmi.h"
int tpcachemremove(TCACHE* tc, char* keyarray[], int size, long flags);

tpcachemremove(3c) removes cache entries associated with the parameter keyarray from a cache. tc is returned by tpgetcache(3c). keyarray is an array of keys to be removed. size is the size of the keyarray. flags is reserved and must be 0L.

Upon success, tpcachemremove(3c) returns 0.

Upon failure, tpcachemremove(3c) returns -1 and sets tperrno to indicate the error condition. If a call fails with a particular tperrno value, a subsequent call to tperrordetail(3c), with no intermediate ATMI calls, may provide more detailed information about the generated error. Refer to the tperrordetail(3c) reference page for more information.

[TPEINVAL]

Invalid arguments were given.

[TPENOENT]

The requested cache does not exist.

[TPETIME]

This error code indicates that a timeout has occurred

[TPESYSTEM]

An Oracle Tuxedo system error has occurred. The exact nature of the error is added to the ULOG.

[TPEOS]

An operating system error has occurred.

[TPESVCFAIL]

The Oracle Tuxedo cache server meets an error. tpurcode contains the exact error value. The possible values of tpurcode are list below:

TDC_ERR_CACHE_NOTEXIST

The error code indicates the requested Oracle Tuxedo cache does not exist.

TDC_ERR_CACHE_UNAVAIL

The error code indicates the requested Oracle Tuxedo cache is unavailable.

TDC_ERR_CACHENAME_INVALID

The error code indicates the requested Oracle Tuxedo cache is invalid.

tpcacheremoveall - remove all cache entries from a cache

#include "atmi.h"
int tpcacheremoveall(TCACHE* tc, long flags);

tpcacheremoveall(3c) removes all entries from a cache. tc is returned by tpgetcache(3c). flags is reserved and must be 0L.

Upon success, tpcacheremoveall(3c) returns 0.

Upon failure, tpcacheremoveall(3c) returns -1 and sets tperrno to indicate the error condition. If a call fails with a particular tperrno value, a subsequent call to tperrordetail(3c), with no intermediate ATMI calls, may provide more detailed information about the generated error. Refer to the tperrordetail(3c) reference page for more information.

[TPEINVAL]

Invalid arguments were given.

[TPENOENT]

The requested cache does not exist.

[TPETIME]

This error code indicates that a timeout has occurred.

[TPESYSTEM]

An Oracle Tuxedo system error has occurred. The exact nature of the error is added to the ULOG.

[TPEOS]

An operating system error has occurred.

[TPESVCFAIL]

The Oracle Tuxedo cache server meets an error. tpurcode contains the exact error value. The possible values of tpurcode are list below:

TDC_ERR_CACHE_NOTEXIST

The error code indicates the requested Oracle Tuxedo cache does not exist.

TDC_ERR_CACHE_UNAVAIL

The error code indicates the requested Oracle Tuxedo cache is unavailable.

TDC_ERR_CACHENAME_INVALID

The error code indicates the requested Oracle Tuxedo cache is invalid.