ENDHOSTSVR (End Host Server)
ENDHOSTSVR Command syntax diagram
Purpose
The End Host Server (ENDHOSTSVR) command is used to end the optimized host server daemons. One or more server daemons can be ended and the server mapper daemon can be ended. Optionally, active connections to the *DATABASE and *FILE servers can be ended with this command.>
If a server daemon is ended, and there are servers of that type that have active connections to client applications, the server jobs will remain active until communication with the client application is ended, unless the optional ENDACTCNN parameter is specified. Subsequent connection requests from the client application to that server daemon will fail however until the server daemon is started again.
If the server mapper daemon is ended, any existing client connections to the server jobs are unaffected. Subsequent requests from a client application to connect to the server mapper daemon (to obtain a server's port number) will fail however until the server mapper is started again.
A request to end *ALL host server daemons will end any active daemons.
The ENDACTCNN parameter may be specified in order to end active connections to the *DATABASE and *FILE servers. This will cause the server jobs which are servicing these connections to be ended. The active connections can only be ended if the corresponding daemon job is also being ended. If the *DATABASE keyword is specified, the QZDASOINIT and QZDASSINIT jobs which have active connections will be ended. If the *FILE keyword is specified, the QPWFSERVSO and QPWFSERVSS jobs which have active connections will be ended.
Required Parameters
- SERVER
- Specifies the server daemons to be ended.
*ALL: All of the server daemons and the server mapper daemon are ended.
*CENTRAL: The central server daemon in the QSYSWRK subsystem, if active, is ended.
*DATABASE: The database server daemon in the QSERVER subsystem, if active, is ended.
*DTAQ: The data queue server daemon in the QSYSWRK subsystem, if active, is ended.
*FILE: The file server daemon in the QSERVER subsystem, if active, is ended.
*NETPRT: The network print server daemon in the QSYSWRK subsystem, if active, is ended.
*RMTCMD: The remote command and distributed program call server daemon in the QSYSWRK subsystem, if active, is ended.
*SIGNON: The signon server daemon in the QSYSWRK subsystem, if active, is ended.
*SVRMAP: The server mapper daemon in the QSYSWRK subsystem, if active, is ended.
Optional Parameter
- ENDACTCNN
- Specifies whether or not the active connections for the specified servers
will be ended.
Single Value
*NONE: No active connections will be ended.
Specific Server Values
*DATABASE: The active connections being serviced by the QZDASOINIT and QZDASSINIT server jobs will be ended. The server jobs servicing these connections will be ended.
*FILE: The active connections being serviced by the QPWFSERVSO and QPWFSERVSS server jobs will be ended. The server jobs servicing these connections will be ended.
Examples for ENDHOSTSVR
Example 1: Ending All Host Server Daemons
ENDHOSTSVR SERVER(*ALL)
This command ends all active server daemons and the server mapper daemon. Any active connections to client applications with the server jobs are unaffected. Ending all host server daemons prevents any subsequent client connection requests from succeeding.
Example 2: Ending Specific Server Daemons
ENDHOSTSVR SERVER(*CENTRAL *SVRMAP)
This command ends the central server daemon and the server mapper daemon. Both daemon jobs run in the QSYSWRK subsystem.
Example 3: Ending Specific Server Daemons and Active Connections
ENDHOSTSVR SERVER(*CENTRAL *DATABASE) ENDACTCNN(*DATABASE)
This command ends the central server daemon in the QSYSWRK subsystem and the
database server daemon in the QSERVER subsystem. Additionally, the active
connections to the *DATABASE server, and the QZDASOINIT and QZDASSINIT server
jobs which are servicing these connections, will be ended.