1. Programming an Oracle Tuxedo ATMI Application Using C
  2. Writing Servers
  3. Advertising and Unadvertising Services
  4. Advertising Services
  5. tpadvertisex()

5.6.1.2 tpadvertisex()

Use the following signature to call the tpadvertisex(3c) function: 

int
tpadvertisex(char *svcname, void (*func)(TPSVCINFO *), (long flags)

The following table describes the arguments to the tpadvertisex() function.

Table 5-5 tpadvertisex( ) Function Arguments

Argument Description
svcname Pointer to the name of the service to be advertised. The service name must be a character string of up to 127 characters. Names longer than 127 characters are truncated. The NULL string is not a valid value. If it is specified, an error (TPEINVAL) results.
func Pointer to the address of an Oracle Tuxedo system function that is called to perform a service. Frequently, this name is the same as the name of the service. The NULL string is not a valid value. If it is specified, an error results.
long flags

Note:

If "long flags" is null, this function is same as tpadvertise( ).
TPSINGLETON: This service can only be advertised by a single server at a time in the current domain. TPSECONDARYRQ: This service is advertised on the secondary request queue instead of the primary request queue. If this flag does not set and the secondary request queue is set in UBB, the Tuxedo service will be advertised on both the primary request queue and the secondary request queue.

Parent topic: Advertising Services