cmappmgr(1m)															      cmappmgr(1m)

NAME

       cmappmgr - launches and monitors an application process on a node

SYNOPSIS

       cmappmgr -node node_name [-cmappserver_timeout number_of_seconds] -service service_name

DESCRIPTION

       cmappmgr  launches  and monitors the specified application process on a specified node.	The cmappserver(1m) daemon process must be running
       on the specified node, and there must be a routable TCP/IP network between the specified node and the local host where cmappmgr(1m) is run.
       cmappmgr exits when the application process exits.

   Options
       cmappmgr supports the following options:

	      -node node_name
			Name of the node on which to launch the application process.

	      -cmappserver_timeut number_of_seconds
			The  number  of  seconds that must elapse before cmappmgr times out the connection with cmappserver on the specified node.
			This is optional.  The default value is 10 seconds.  The maximum value that can be specified is 600 seconds, and the mini-
			mum value is 1 second.

	      -service service_name
			The  full command line for the application or process to be launched.  Note that -service must be the last argument speci-
			fied for cmappmgr as all strings following the argument are considered as part of the command line to launch the  applica-
			tion process. Quotation marks ("") are not required.

RETURN VALUE

       cmappmgr returns the following value upon completion:

	       0   Successful completion.
	      >= 1 One	or  more  error  conditions occurred.  The value generally reflects the exit code of the process.  If, for any reason, the
		   process fails to launch on the specified node (for example, because of an error connecting to cmappserver), cmappmgr exits with
		   1.

EXAMPLES

       To launch an xclock application on the node v-smp1:

	      cmappmgr -node v-smp1 -service /usr/bin/X11/xclock -display 16:89:255:19:0.0

AUTHOR

       cmappmgr was developed by HP.

SEE ALSO

       cmappserver(1m).

       Designing high-availability solutions with HP Serviceguard and HP Integrity Virtual Machines

						      Requires Optional Serviceguard Software					      cmappmgr(1m)