OpenTP1 Version 7 Programming Reference COBOL Language
TPUNADVERTISE - Unadvertise a service name
Format
01 SERVICE-NAME PIC X(15). 01 TPSTATUS-REC. COPY TPSTATUS. CALL "TPUNADVERTISE" USING SERVICE-NAME TPSTATUS-REC. |
Description
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.
TPUNADVERTISE removes SERVICE-NAME as an advertised service for the server. SERVICE-NAME cannot be SPACES. Also, SERVICE-NAME should be 15 characters or fewer. Longer names are accepted and truncated to 15 characters. Care should be taken such that truncated names do not match other service names.
<<Data areas>>
<<SERVICE-NAME
Specify the service name of the service.>>
<<TPSTATUS-REC
Will be assigned the return value indicating the result of TPUNADVERTISE execution.>>
Return value
Upon successful completion, TPUNADVERTISE sets TP-STATUS to TPOK.
Errors
Under the following conditions, TPUNADVERTISE fails and sets TP-STATUS to one of the following values:
See also
TPADVERTISE.
<<Notes on use with OpenTP1>>
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.