ATMI COBOL Function Reference
TPUNADVERTISE()
- routine for unadvertising service names
01
SVC-NAME
PIC X(15).
01TPSTATUS-REC
.
COPY TPSTATUS.
CALL "TPUNADVERTISE" USINGSVC-NAME
TPSTATUS-REC
.
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 shut down.
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 SVC-NAME
as an advertised service for the server (or the set of servers sharing the caller's MSSQ set). SVC-NAME
cannot be SPACES
. Also, SVC-NAME
should be 15 characters or less. (See the 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.
Upon successful completion, TPUNADVERTISE()
sets TP-STATUS
to [TPOK
].
Under the following conditions, TPUNADVERTISE()
fails and sets TP-STATUS
to: