dio_alarm_dnom(_c)

	status.i4.v = dio_alarm_dnom(device_index.i4.r, nominal.i4a.r,
				     mask.i4a.r [,ftd.i2.r]
				     [,start_block.i4.r] [,max_blocks.i4.r]
				     [,num_blocks.i4.r])

	status.i4.v = dio_alarm_dnom_c(device_index.i4.v, nominal.i4a.r,
				       mask.i4a.r [,ftd.i2.v]
				       [,start_block.i4.v] [,max_blocks.i4.v]
				       [,num_blocks.i4.r])

	This routine returns the digital alarm block nominal and mask
	for a device.

	device_index	device index of interest
	nominal		returned nominal value
	mask		returned mask value
	[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
	otherwise		ACNET format error

	This function requires the following include files:

	diolib_h, acnet_errors_h, tclk_events_h, macro_h

	Related functions:

	dio_alarm_dnom_lst, dio_salarm_dnom(_c), dio_alarm_limits(_c),
	dio_alarm_flags(_c), dio_alarm_events(_c), dio_alarm_tries(_c),
	dio_extract_alarm_info_c

	C/C++ usage:

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

	status = dio_alarm_dnom_c(device_index,&nominal,&mask,ftd,
				  start_block,max_blocks,&num_blocks);