alarm_send_message_c

	status.i4.v = alarm_send_message_c(device_index.i4.v, alarm_type.i4.v,
					   event_type.i4.v,
					   text.i1a.r, text_length.i4.v,
					   reading.r8.v, good_bad.i4.v,
					   high_low.i4.v)

	This routine allows a process to send an alarm message with
	an accompanying text message.

	device_index	device index to submit alarm for
	alarm_type	type of alarm
			(DIO_ANALOG -> analog alarm,
			 DIO_DIGITAL -> digital alarm)
	event_type	type of alarm event
			(ALARM_EXCEPTION -> exception type alarm (bad/good),
			 ALARM_EVENT -> event type alarm)
	text		text string to be included in the alarm report
			as a parameter (included into the display message
			by the "!TX" formatting directive) (a maximum
			of ALARM_TEXT_LEN characters can be used)
	text_length	length of alarm text string (If this argument
			has a value of zero, the routine will determine
			the length of the string.)
	reading		"reading" value which is primarily used to
			provide numeric information for alarm text
			formatting directives
	good_bad	value to set the GOOD/BAD bit in the alarm status
			(ALARM_GOOD -> alarm is going good,
			 ALARM_BAD -> alarm is going bad)
	high_low	setting for HI/LO bits in the alarm status
			(ALARM_LOW -> low alarm,
			 ALARM_NO_LOHI -> alarm is neither low nor high,
			 ALARM_HIGH -> high alarm)

	This function returns status values as follows:

	OK			success
	CLIB_INVARG		invalid parameter passed for alarm type,
				event type, good/bad status, high/low status
	DIO_NOATT		requested alarm property does not exist
	DIO_INVDEV		requested device is not a software alarm device
	DIO_xxx			error retrieving alarm node
	ACNET_xxx		ACNET communication error

	This function requires the following include files:

	clib_h, acnet_errors_h

	Related functions:

	alarm_cancel_message_c, alarm_report, alarm_rptw_text,
	alarm_submit_event

	C/C++ usage:

	static const char	text[] = "Rome is burning!";
	int	status;
	int	device_index = 223330;		// G:ACLALM
	int	alarm_type = DIO_ANALOG;
	int	event_type = ALARM_EVENT;
	int	text_length = 0;
	int	good_bad = ALARM_BAD;
	int	high_low = ALARM_NO_LOHI;
	double	reading = 0.0;

	status = alarm_send_message_c(device_index,alarm_type,event_type,
				      text,text_length,reading,good_bad,
				      high_low);