dio_get_alarm(_c)

	status.i4.v = dio_get_alarm(device_index.i4.r, alarm_type.i4.r,
				    alarm_block.i1a.r [,ftd.i2.r]
				    [,start_block.i4.r] [,max_blocks.i4.r]
				    [,num_blocks.i4.r])

	status.i4.v = dio_get_alarm_c(device_index.i4.v, alarm_type.i4.v,
				      alarm_block.i1a.r [,ftd.i2.v]
				      [,start_block.i4.v] [,max_blocks.i4.v]
				      [,num_blocks.i4.r])

	This routine retrieves alarm blocks from a front end.

	device_index	device index of interest
	alarm_type	type of alarm
			(DIO_ANALOG -> analog alarm,
			 DIO_DIGITAL -> digital alarm)
	alarm_block	returned alarm blocks (20 bytes per block)
			(structures of type ANALOG_ALARM_BLOCK or
			 DIGITAL_ALARM_BLOCK)
	[ftd]		frequency time descriptor
			(FTD_ONESHOT -> one shot (default),
			 FTD_DEFAULT -> use database default FTD,
			 FTD_1HZ -> 1 Hz request,
			 FTD_EVENT_MASK OR'ed with TCLK event value -> read
			 on TCLK event (event constants are in tclk_events)
			 (can use the macro BUILD_EVENT_FTD(event) or
			  BUILD_EVENT_PLUS_DELAY_FTD(event,delay) in 'macro'))
	[start_block]	starting block to return (starts at 0)
			(default is 0) (maximum is DIO_MAX_ALARM_BLOCKS - 1)
	[max_blocks]	maximum number of blocks to return per device
			(default is 1) (maximum is DIO_MAX_ALARM_BLOCKS)
	[num_blocks]	returned number of blocks returned (default is NULL)

	This function returns ACNET status values as follows:

	OK			success
	DIO_BADARG		invalid starting block or maximum number
				of blocks
	DIO_NO_SUCH		requested alarm block does not exist
	otherwise		ACNET format error

	This function requires the following include files:

	diolib_h, cns_data_structs_h, acnet_errors_h, tclk_events_h, macro_h

	Related functions:

	dio_get_alrm_lst, dio_cancel_alarm(_c), dio_extract_alarm_info_c,
	dio_get_db_alarm(_c), DIO_ALARM_IS_ABORT, DIO_ALARM_IS_ABORT_INHIBIT,
	DIO_ALARM_IS_DISPLAYED, DIO_ALARM_IS_LOGGED, DIO_ALARM_IS_EVENT,
	DIO_ALARM_IS_HIGH, DIO_ALARM_IS_LOW, DIO_ALARM_LIMIT_CLASS,
	DIO_ALARM_IS_DIGITAL, DIO_ALARM_LIMIT_SIZE, DIO_ALARM_IS_BAD,
	DIO_ALARM_IS_ENABLED

	C/C++ usage:

	short	ftd = FTD_ONESHOT;
	int	status;
	int	device_index = 14430;
	int	alarm_type = DIO_ANALOG;
	int	nominal;
	int	mask;
	int	start_block = 0;
	int	max_blocks = 1;
	int	num_blocks;
	ANALOG_ALARM_BLOCK	alarm_block;

	status = dio_get_alarm_c(device_index,alarm_type,(char *) &alarm_block,
				 ftd,start_block,max_blocks,&num_blocks);