This section describes how to terminate an EntireX Broker Service. Several methods exist.
Use the TS (Terminate
EntireX Broker Service) command of the SYSRPC
utility as described in Terminating
a Server in the SYSRPC
Utility documentation.
Use the button in the Service subtree of the EntireX System Management Hub.
The Application Programming Interface (API) USR2075N
enables you to terminate an EntireX Broker Service from within your
application.
With the command TERMINATE-SERVICE the
interface uses the command and information service of EntireX to fulfill the
task. First of all, it sends a logon request to the EntireX Broker. Then it
gets a list of all servers specified by server class, server name, and service
type. Finally, it sends a shutdown request to each server. A message indicates
how many servers were terminated.
To make use of USR2075N
Copy the subprogram USR2075N from libray
SYSEXT to the library SYSTEM or to the steplib
library or to any application in the server environment.
Using a DEFINE
DATA statement in structured mode or a RESET
statement in reporting mode, specify the following parameters:
| Parameter | Format | I/O | Description | |
|---|---|---|---|---|
FUNCTION |
A18 | I | Specify
TERMINATE-SERVICE.
This sends a shutdown request to each server specified with the
parameters |
|
SRVNODE |
A192 | I | Specify the Broker name or an
asterisk (*) if the server name represents a Location Transparency of EntireX
or a logical Broker node name as
LOGBROKER=nodename).
See the keyword subparameter |
|
SRVCLASS |
A32 | I | Specify the server class. For
Natural RPC servers, this is RPC.
|
|
SRVNAME |
A32/A192 | I | Server name (A32) or EntireX
Location Transparency (A192). See the keyword subparameter
SRVNAME
of profile parameter RPC or
parameter macro
NTRPC.
|
|
SERVICE |
A32 | I | Specify the type of service. For
Natural RPC servers, this is CALLNAT.
|
|
IMMEDIATE |
L | TRUE |
Immediately terminate all conversations for the specified server. | |
FALSE |
Existing conversations are allowed to end normally; no new conversations are accepted. | |||
USER-ID |
A32 | I | Specify the user ID to logon to the EntireX Broker. | |
PASSWORD |
A32 | I | Specify the password for EntireX Broker Security, if it is used on the EntireX Broker side. | |
MSG |
A (dynamic) | O | Message returned. | |
RC |
I2 | O | Response code; possible values: | |
0 |
MSG contains a normal message from the
EntireX Broker.
|
|||
1 |
MSG contains an error message from the
EntireX Broker.
|
|||
3 |
MSG contains an error message from
Natural Security on the client side.
|
|||
Before invoking the API, fill the input variables listed above.
