CL Command Reference - STRHOSTSVR
CL Command List > STRHOSTSVR Reference
Description:
The Start Host Server (STRHOSTSVR) command is used to start the optimized host server daemons and the server mapper daemon.
There is one server daemon for each of the host server types. In addition, there is one server mapper daemon for all host servers which provides support for client applications to obtain a particular host server daemonĄ¯s port number. This port number is then used by the client application to connect to the host serverĄ¯s daemon. The daemon accepts the incoming connection request and routes it to the server job for further processing.
The daemons are batch jobs submitted to either the QSYSWRK or QSERVER subsystem, depending on the value or values specified for the SERVER keyword. All daemon jobs are submitted to the QSYSWRK subsystem with the exception of the *DATABASE and *FILE server daemons which are submitted to the QSERVER subsystem.
In order for the server daemons and the server mapper daemon to start successfully, the QSYSWRK subsystem and, for *DATABASE and *FILE server, the QSERVER subsystem must be active. If the required subsystem is not active, then the submission of the daemon job will fail. Additionally, the QUSRWRK subsystem or the user-defined subsystem must be active in order to start the associated server jobs. All associated server jobs can run in the QUSRWRK subsystem or a user-defined subsystem, except for the following:
. Server jobs QPWFSERVSO and QPWFSERVSS - these jobs run in the QSERVER subsystem or a user-defined subsystem
. Server job QPWFSERVS2 - this job runs in the QSERVER subsystem
. Server job QIWVPPJT - this job runs in the QSYSWRK subsystem
. Server job QTFPJTCP - this job runs in the QSERVER subsystem.
There are no server jobs associated with the server mapper daemon.
The server daemons must be active in order to allow client applications to establish a connection with the host server using sockets communication support. Once started, the server daemons and the server mapper daemon remain active until they are ended explicitly using the End Host Server (ENDHOSTSVR) command or an error occurs.
Restrictions:
. This command is used only for enabling client applications to communicate with any of the host servers using sockets communication support. This command does not start any of the APPC host servers; these are started as a result of a program start request.
. Only one server daemon can be active for a specific server type. Requests to start a server daemon that is already active will result in an informational message to the user issuing this command.
Examples:
None.