| Programming Guide | |
Advertises services offered by a server to a client
advertise {ALL | SERVICEserviceName| GROUPserviceGroup}
- ALL
- Advertise all services defined in the JIF.
- SERVICE
serviceName- Advertise a service that is defined in the JIF, where
serviceNamecan be up to 15 characters long. The JIF is consulted to validate the service name.GROUPserviceGroup- Advertise all services belonging to the named group, as defined in the JIF, where
serviceGroupcan be up to 31 characters long.
JetNet, Oracle Tuxedo
Server
The
advertisecommand reads the specified services from the JIF and advertises them to clients. If a service is already advertised, its JIF definition is reread and the service is readvertised. This might occur during development or maintenance when a server is reinitialized after a JIF entry is updated or corrected. If successful,advertisesets thetp_returnproperty to the number of services advertised.You can advertise individual services, all services in a group, or all services. For example, the following code advertises service
transfer:advertise SERVICE "transfer"This code advertises all services in the
emp_accountgroup:advertise GROUP "emp_account"The next example advertises all services and logs a message:
proc adv_and_log
vars messageadvertise ALL
message = @app()->tp_return##" services advertised."
log message
Execution of
advertisecan raise the following exceptions: