PURPOSE

TPADVERTISE - routine for advertising service names

SYNOPSIS


01  SVC-NAME   PIC X(15).
01  PROGRAM-NAME   PIC X(32).
01  TPSTATUS-REC.
    COPY TPSTATUS.
CALL "TPADVERTISE" USING SVC-NAME PROGRAM-NAME TPSTATUS-REC.

DESCRIPTION

TPADVERTISE allows a server to advertise the services that it offers. By default, a server's services are advertised when it is booted and 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.

TPADVERTISE advertises SVC-NAME for the server (or the set of servers sharing the caller's MSSQ set). SVC-NAME should be 15 characters or less, but cannot be SPACES. (See *SERVICES section of ubbconfig(5)) Longer names are truncated to 15 characters. Users should make sure that truncated names do not match other service names. PROGRAM-NAME is the name of a System/T service program. This program will be invoked whenever a request for SVC-NAME is received by the server. PROGRAM-NAME cannot be SPACES.

If SVC-NAME is already advertised for the server and PROGRAM-NAME matches its current program, then TPADVERTISE returns success (this includes truncated names that match already advertised names). However, if SVC-NAME is already advertised for the server but PROGRAM-NAME does not match its current program, then an error is returned (this can happen if truncated names match already advertised names).

RETURN VALUES

TPADVERTISE Upon successful completion, TPADVERTISE sets TP-STATUS to [TPOK].

ERRORS

Under the following conditions, TPADVERTISE fails and sets TP-STATUS to:

[TPEINVAL]: Either SVC-NAME or PROGRAM-NAME is SPACES, or PROGRAM-NAME is not a name of a valid program.
[TPELIMIT]: SVC-NAME cannot be advertised because of space limitations. (See MAXSERVICES in the *RESOURCES section of ubbconfig(5))
[TPEMATCH]: SVC-NAME is already advertised for the server but with a program other than PROGRAM-NAME. Although TPADVERTISE fails, SVC-NAME remains advertised with its current program (that is, PROGRAM-NAME does not replace the current program).
[TPEPROTO]: TPADVERTISE was called in an improper context.
[TPESYSTEM]: A System/T error has occurred. The exact nature of the error is written to a log file.
[TPEOS]: An operating system error has occurred.

PORTABILITY