win32_start_service_ctrl_dispatcher(3) [php man page]

WIN32_START_SERVICE_CTRL_DISPATCHER(3)					 1				    WIN32_START_SERVICE_CTRL_DISPATCHER(3)

win32_start_service_ctrl_dispatcher - Registers the script with the SCM, so that it can act as the service with the given name

SYNOPSIS

       mixed win32_start_service_ctrl_dispatcher (string  $name)

DESCRIPTION

	When  launched	via  the  Service Control Manager, a service process is required to "check-in" with it to establish service monitoring and
       communication facilities. This function performs the check-in by spawning a thread to handle the lower-level communication with the service
       control manager.

	Once  started,	the service process should do 2 things. The first is to tell the Service Control Manager that the service is running. This
       is achieved by calling win32_set_service_status(3) with the WIN32_SERVICE_RUNNING constant. If you need to  perform  some  lengthy  process
       before  the  service  is actually running, then you can use the WIN32_SERVICE_START_PENDING constant. The second is to continue to check-in
       with the service  control  manager  so  that  it  can  determine  if  it  should  terminate.  This  is  achieved  by  periodically  calling
       win32_get_last_control_message(3) and handling the return code appropriately.

PARAMETERS

	      o $name
		- The short-name of the service, as registered by win32_create_service(3).

RETURN VALUES

	Returns TRUE on success, FALSE if there is a problem with the parameters or a Win32 Error Code on failure.

EXAMPLES

       Example #1

	      A win32_start_service_ctrl_dispatcher(3) example

	       Check if the service is runnig under the SCM.

	      <?php
	      if (!win32_start_service_ctrl_dispatcher('dummyphp')) {
		die("I'm probably not running under the service control manager");
	      }

	      win32_set_service_status(WIN32_SERVICE_START_PENDING);

	      // Some lengthy process to get this service up and running.

	      win32_set_service_status(WIN32_SERVICE_RUNNING);

	      while (WIN32_SERVICE_CONTROL_STOP != win32_get_last_control_message()) {
		# do some work here, trying not to take more than around 30 seconds
		# before coming back into the loop again
	      }
	      ?>

SEE ALSO

       win32_set_service_status(3), win32_get_last_control_message(3), Win32 Error Codes.

PHP Documentation Group 										    WIN32_START_SERVICE_CTRL_DISPATCHER(3)

clusvcadm(8)						       Red Hat Cluster Suite						      clusvcadm(8)

NAME

       clusvcadm - Cluster User Service Administration Utility

SYNOPSIS

       clusvcadm [-d <service> ] [-e <service> ] [-l] [-u] [-S] [-m <member> ] [-r <service> ] [-R <service> ] [-M <service> ] [-Z <service> ] [-U
       <service> ] [-s <service> ] [-v]

DESCRIPTION

       The clusvcadm command allows an administrator to enable, disable, relocate, and restart user services in a cluster.  In	order  to  perform
       cluster service operations, the cluster daemons must be running (and have quorum) on the member system on which the command is invoked.

OPTIONS

       -d <service>
	      Stops and disables the user service named service

       -e <service>
	      Enables and starts the user service named service

       -l     Lock services in preparation for cluster shutdown.  This should only be used if the administrator intends to perform a global, clus-
	      ter wide shutdown.  This prevents services from starting (but not stopping, like -Z does).  Once the cluster  quorum  is	dissolved,
	      this state is reset.  If a new instance of rgmanager boots while others are locked, the behavior is undefined.

       -u     Unlock resource group managers.  This allows services to start again.

       -S     Display  whether	the  resource group managers are locked or not.  This can be used to verify the correct operation of the -l and -u
	      options, but is only useful for debugging.

       -m <member>
	      When used in conjunction with either the -e or -r options, this specifies the preferred target member on which to start the service.

       -r <service>
	      Relocates the user service named service to another cluster member.

       -R <service>
	      Restarts the user service named service on the cluster member on which it is currently running.

       -M <service>
	      Use a special "migration" operation to move the user service named service to another cluster member.  Currently, this is only  use-
	      ful  for virtual machines.  Use of migration usually requires special configuration of the local virtual machine manager in order to
	      work correctly.

       -Z <service>
	      Freezes the service named service on the cluster member on which it is currently running.  This will prevent status  checks  of  the
	      service as well as failover in the event the node fails or rgmanager is stopped.

       -U <service>
	      Unfreezes the user service named service on the cluster member on which it is currently running.	This will re-enable status checks.

       -s <service>
	      Stops the service named service until a member transition or until it is enabled again.

       -v     Display version information and exit.

NOTES

       Executing  -U (unfreeze) on a service which was frozen in the started state while the service owner is offline results in an undefined (and
       possibly dangerous) condition.  Manually ensure all resources are clear before doing this.

SEE ALSO

       clustat(8)

								     Jan 2005							      clusvcadm(8)