find_processes_c

	status.i4.v = find_processes_c(search_type.i4.v, search_value.g.v,
				       num_processes.i4.r, processes.sp.r
				       [,node.i4.v])

	This routine finds processes running on the host computer.

	search_type	type of process search
			(PROC_SEARCH_TYPE_NONE -> return all processes,
			 PROC_SEARCH_CHILDREN -> return all first generation
						 child processes for a
						 given process,
			 PROC_SEARCH_ALL_CHILDREN -> return all child processes
						     (all generations) for a
						     given process,
			 PROC_SEARCH_BY_USER_NAME -> return all processes
						     belonging to a given user
						     (by name),
			 PROC_SEARCH_BY_USER_ID -> return all processes
						   belonging to a given user
						   (by ID),
			 PROC_SEARCH_BY_NAME -> return all processes matching
						a name string,
			 PROC_SEARCH_BY_COMMAND_LINE -> return all processes
							matching a command
							line string,
			 PROC_SEARCH_BY_STARTED_BEFORE -> return all processes
							  started before a
							  requested UTC time,
			 PROC_SEARCH_BY_STARTED_AFTER -> return all processes
							 started on or after a
							 requested UTC time,
			 PROC_SEARCH_BY_STATE -> return all processes in a
						 particular state,
			 PROC_SEARCH_BY_MEMORY_SIZE -> return all processes
						       having a memory size of
						       at least a certain size
						       in bytes,
			 PROC_SEARCH_BY_CPU_TIME -> return all processes that
						    have used at least a certain
						    amount of CPU time in ticks)
	search_value	process search value (depends on the search type)
	num_processes	returned number of processes
	processes	returned matching processes
			(array of structures of type OS_PROCESS_ENTRY)
			(The memory for this argument is allocated by this
			 routine and should be freed by the caller.)
	[node]		node of interest
			(default is LOCAL)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid search type passed
	CLIB_MEMFAIL		memory allocation failure
	CLIB_NO_SUCH		no matching processes found

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	process_information, process_name_to_pid_c, pid_to_process_name_c,
	process_info_by_pid_c, pid_process_exists_c

	C/C++ usage:

	int	status;
	int	search_type = PROC_SEARCH_TYPE_NONE;
	int	num_processes;
	int	node = LOCAL;
	void	*search_value = (void *) NULL;
	OS_PROCESS_ENTRY	*processes;

	status = find_processes_c(search_type,search_value,&num_processes,
				  &processes,node);