clinks_to_special_time_c

	status.i4.v = clinks_to_special_time_c(clinks.u4.v, type.i4.v,
					       options.u4.v, special_time.u4.r)

	This routine converts clinks to a special TIME breakpoint.  Please see
	clinks_now for the definition of clinks.
	
	clinks		TIME in clinks
	type		type of TIME breakpoint desired
			(DATE_START_OF_DAY -> TIME of midnight for the
					      requested clinks,
			 DATE_START_OF_SHIFT -> TIME of the start of shift
						for the requested clinks,
			 DATE_START_OF_WEEK -> TIME of the start of week
					       for the requested clinks,
			 DATE_START_OF_MONTH -> TIME of the start of month
						for the requested clinks,
			 DATE_START_OF_YEAR -> TIME of the start of year
					       for the requested clinks)
	options		date conversion options
			(DATE_OPT_NONE -> no options selected,
			 DATE_OPT_PREVIOUS_TIME -> return the previous
						   TIME interval value,
			 DATE_OPT_NEXT_TIME -> return the next
					       TIME interval value)
	special_time	returned special TIME in clinks

	This function returns ACNET status values as follows:

	CBS_OK			success
	CBS_INVARG		invalid clink value or type value supplied

	This function requires the following include files:

	clib_h

	Related functions:

	clinks_to_day_of_week_c, clinks_now, clinks_to_date, date_to_clinks,
	get_date_clinks, convert_compare_date_to_clinks, db_date_to_clinks,
	db_date_to_date_c, convert_seconds_c

	C/C++ usage:

	int	status;
	int	type = DATE_START_OF_DAY;
	unsigned int	clinks = 937526400;
	unsigned int	options = DATE_OPT_NONE;
	unsigned int	special_time;

	status = clinks_to_special_time_c(clinks,type,options,&special_time);