dio_alarms_monitored_by_user_c

	status.i4.v = dio_alarms_monitored_by_user_c(user_name.i1a.r,
						     max_return.i4.v,
						     num_alarms.i4.r,
						     device_indices.i4a.r,
						     alarm_type.i4a.r)

	This routine returns the alarms which are being montored by a user.

	user_name	null terminated user name to search for
			(up to USER_NAME_LEN characters)
	max_return	maximum number of alarms to return
	num_alarms	returned number of alarms monitored by user
	device_indices	returned alarm device indices
			(A value of NULL can be passed for this argument
			 if the device indices are not needed.)
	alarm_types	returned alarm type(s)
			(DIO_ANALOG -> analog alarm,
			 DIO_DIGITAL -> digital alarm)
			(A value of NULL can be passed for this argument
			 if the alarm types are not needed.)

	This function returns ACNET status values as follows:

	OK			success
	SQL_xxx			error retrieving monitored alarms

	This function requires the following include files:

	diolib_h, acnet_errors_h

	Related functions:

	dio_users_monitoring_alarm_c

	C/C++ usage:

	static const char	user_name[USER_NAME_LEN+1] = "HENDRICKS";
	int	status;
	int	max_return = MAX_RETURN;
	int	num_alarms;
	int	device_indices[MAX_RETURN];
	int	alarm_types[MAX_RETURN];

	status = dio_alarms_monitored_by_user_c((char *) user_name,max_return,
						&num_alarms,device_indices,
						alarm_types);