Oracle Tuxedo Distributed Caching (TDC) Programming

This topic contains the following sections:

•	Use Oracle Tuxedo Distributed Caching (TDC) Related ATMI APIs

•	Put An Oracle Tuxedo Buffer to Cache

•	Get An Oracle Tuxedo Buffer from Cache

•	Remove Oracle Tuxedo Buffer(s) from Cache

Use Oracle Tuxedo Distributed Caching (TDC) Related ATMI APIs

 

Table 3‑1 Oracle Tuxedo Distributed Caching (TDC) Related ATMI APIs

Name	Description
tpgetcache(3c)	Get an Oracle Tuxedo Cache handle according to the configuration
tpcacheput(3c)	Put an Oracle Tuxedo typed buffer into a cache, associating that buffer with a key
tpcacheget(3c)	Get the Oracle Tuxedo typed buffer associated with the key from a cache
tpcacheremove(3c)	Remove the cache entry associated with the parameter key from a cache
tpcachemremove(3c)	Remove cache entries associated with the parameter keyarray from a cache
tpcacheremoveall(3c)	Remove all cache entries from a cache

For more information about the above APIs, see Section 3c - C Functions.

Put An Oracle Tuxedo Buffer to Cache

TDC APIs tpgetcache and tpcacheput can be used in an Oracle Tuxedo client or server to put an Oracle Tuxedo buffer associated with a key into an Oracle Tuxedo cache.

For more information about tpgetcache and tpcacheput, see Use Oracle Tuxedo Distributed Caching (TDC) Related ATMI APIs.

Listing 3‑1 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);

...

 

Get An Oracle Tuxedo Buffer from Cache

TDC APIs tpgetcache and tpcacheget can be used in an Oracle Tuxedo client or server to get an Oracle Tuxedo typed buffer from an Oracle Tuxedo cache according to a key.

For more information about tpgetcache and tpcacheget, see Use Oracle Tuxedo Distributed Caching (TDC) Related ATMI APIs.

Listing 3‑2 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);

...

 

Remove Oracle Tuxedo Buffer(s) from Cache

TDC APIs tpgetcache and tpcacheremove can be used in an Oracle Tuxedo client or server to remove an Oracle Tuxedo buffer associated with a key from an Oracle Tuxedo cache. See Listing 3‑3 for an example.

Also, you can use TDC API tpcachemremove to remove several Oracle Tuxedo buffers at one time, or use TDC API tpcacheremoveall to remove all the Oracle Tuxedo buffers from an Oracle Tuxedo cache. For more information about these TDC APIs, see Use Oracle Tuxedo Distributed Caching (TDC) Related ATMI APIs.

Listing 3‑3 Remove An Oracle Tuxedo Buffer Associated with A Key from 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");

tpcacheremove(mycache, mykey,0L);

 

tpfree(databuf);

...