lext_start_sa_c (ul_lextools)

	status.i4.v = lext_start_sa_c(name.ch.d, slot.i4.v, mode.i4.v
				      [,console_num.i4.v] [,subst_device.i1a.r]
				      [,num_limits.i4.v] [,caller_limits.r4a.r])

	This routine starts up Lex SA with the requested graphics file.

	name		Lex SA command file name
			(LEXT_SA_NAMLEN characters)
	slot		program slot to run in
			(SA_SLOT -> SA secondary application slot,
			 SB_SLOT -> SB secondary application slot,
			 SC_SLOT -> SC secondary application slot,
			 SD_SLOT -> SD secondary application slot,
			 SE_SLOT -> SE secondary application slot)
	mode		application mode
			(LEXT_ACTIVE_NORMAL -> normal program execution,
			 LEXT_ACTIVE_COPY_IMAGE -> copy image to a GIF file
						   once active objects have
						   updated and terminate)
	[console_num]	console number to start Lex SA on
			(default is LOCAL_CONSOLE which indicates the
			 caller's console)
	[subst_device]	device name substitution string
			(dio_get_terse_name_length characters)
			(For letters in device names that should remain the
			 same, this string should contain an asterisk in the
			 corresponding location.) (A null pointer may be
			 passed if no device substitutions are needed.)
	[num_limits]	number of caller supplied analog object limits
			(default is 0)
	[caller_limits]	array of caller-supplied analog object limits
			(default is NULL)

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid slot number passed
	CBS_INVNAME		invalid file name passed

	This function requires the following include files:

	cnsparam_h, ul_lextools_h:lextuti_h, acnet_errors_h

	Related functions:

	lext_init_active_image, lext_current_active_image, lximag, lxobj

	C/C++ usage:

	static const char	name[LEXT_SA_NAMLEN+] = "BLDGTEMP";
	char	*subst_device = (char *) NULL;
	int	status;
	int	slot = SA_SLOT;
	int	mode = LEXT_ACTIVE_NORMAL;
	int	console_num = 0;
	int	num_limits = 0;
	float	*caller_limits = (float *) NULL;

	status = lext_start_sa_c(name,slot,mode,console_num,subst_device,
				 num_limits,caller_limits);