alarm_submit_event

	status.i4.v = alarm_submit_event(device_index.i4.v, alarm_type.i4.v,
					 text.i1a.r, text_length.i4.v,
					 reading.r4.v, good_bad.i4.v,
					 high_low.i4.v, display_window.i4.v)

	This routine allows a process to report an alarm event 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)
	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)
	display_window	alarm display window in which this alarm should
			be posted
			(ALARM_DEFAULT_WINDOW -> display in default window
						 for this node,
			 ALARM_SYSTEM_WINDOW -> display in the system window)

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid parameter passed for alarm type,
				good/bad status, high/low status, or
				display window
	DIO_NOATT		requested alarm property does not exist
	DIO_xxx			error retrieving alarm node
	ACNET_xxx		ACNET communication error
	OAC_NO_SUCH		device/alarm type is not in the alarm scan
	OAC_NOATT		alarm block is not of type event

	This function requires the following include files:

	clib_h, acnet_errors_h

	Related functions:

	alarm_report, alarm_rptw_text, alarm_send_message_c,
	alarm_cancel_message_c

	C/C++ usage:

	static const char	text[] = "Rome is burning!";
	int	status;
	int	device_index = 27235;		// M:OUTTMP
	int	alarm_type = DIO_ANALOG;
	int	text_length = 0;
	int	good_bad = ALARM_BAD;
	int	high_low = ALARM_NO_LOHI;
	int	display_window = ALARM_DEFAULT_WINDOW;
	float	reading = 0.0;

	status = alarm_submit_event(device_index,alarm_type,text,text_length,
				    reading,good_bad,high_low,display_window);