tpunadvertise-routine for unadvertising a service name
#include <atmi.h>
int tpunadvertise(char *svcname)
tpunadvertise() allows a server to unadvertise a service that it offers. By default, a server's services are advertised when it is booted and they are unadvertised when it is shutdown.
All servers belonging to a multiple server, single queue (MSSQ) set must offer the same set of services. These routines enforce this rule by affecting the advertisements of all servers sharing an MSSQ set.
tpunadvertise() removes svcname as an advertised service for the server (or the set of servers sharing the caller's MSSQ set). svcname cannot be NULL or the NULL string (""). Also, svcname should be 15 characters or less. (See *SERVICES section of ubbconfig(5)). Longer names will be accepted and truncated to 15 characters. Care should be taken such that truncated names do not match other service names.
tpunadvertise() returns \-1 on error and sets tperrno to indicate the error condition.
Under the following conditions, tpunadvertise() fails and sets tperrno to:
TPEINVAL]
svcname is NULL or the NULL string ("").
TPENOENT]
svcname is not currently advertised by the server.
TPEPROTO]
tpunadvertise() was called in an improper context (for example, by a client).
TPESYSTEM]
TPEOS]
tpadvertise(3)