acnet_chgpgm

	status.i4.v = acnet_chgpgm(console_number.i4.v, task.i1a.r, slot.i4.v
				   [,command_buf.i1a.r] [,script.i4.v] [,command_buffer_length.i4.v])

	This routine starts up a program on a specified console and slot.

	console_number	console number (e.g. 32)
	task		name of application program (e.g. "PA1014"); or
			null-terminated name of application page (e.g. "D111")
	slot		start it on this console slot number
			(PA_SLOT -> primary application PA,
			 PB_SLOT -> primary application PB,
			 PC_SLOT -> primary application PC,
			 PD_SLOT -> primary application PD,
			 PE_SLOT -> primary application PE,
			 SA_SLOT -> secondary application SA,
			 SB_SLOT -> secondary application SB,
			 SC_SLOT -> secondary application SC,
			 SD_SLOT -> secondary application SD,
			 SE_SLOT -> secondary application SE,
			 ALARM_SLOT -> reserved for alarm system,
			 UTIL_SLOT -> utility window,
			 NONUSER_SLOT -> background user process)
			(Specifying a slot of zero causes the system to
			 select an unused slot from either SA_SLOT,
			 SB_SLOT, SC_SLOT, SD_SLOT, or SE_SLOT.  If all slots
			 are in use, then this is equivalent to a request for
			 SB_SLOT.)
	[command_buf]	optional "command_buffer_length" byte buffer of data to
			be delivered to target program (it receives with a call
			to getcmd(_c)) (default is NULL)  The caller may leave
			portions of this buffer unused/ uninitialized so long as
			the target program treats the buffer it receives in the
			same fashion. (Note: There must actually be memory
			allocated for any such unused portion, since this
			routine will copy the entire buffer elsewhere.  If such
			memory is not actually allocated, the copy's read may
			crash.)
	[script]	if TRUE, the command buffer (assumed to be of type
			do_script_t) will be used to invoke a script
			(see structure do_script_t in 'cns_data_structs')
			(default is FALSE)
	[command_buffer_length] command buffer length in bytes
			(default is CMD_LIN_SIZ)

	This function returns ACNET status values as follows:

	OK			success
	CBS_MEMFAIL		dynamic memory allocation failure
	ACNET_UTIME		reply timed out
	ACNET_xxx		change program request or console node
				translation failed
	CLIB_CHGPGM_BADSLOT	invalid slot number passed
	CLIB_CHGPGM_BUFLOCK	command line buffer is locked

	Function will call error_display if error_imbedded_on has
	been called.

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, cbslib_h, acnet_errors_h

	Related functions:

	chgpgm(_c), getcmd(_c), acnet_send_wait

	C/C++ usage:

	char		command_buffer[CMD_LIN_SIZ];
	static const char	pa_task[] = "D111";
	static const char	sa_task[] = "SA1082";
	int		status;
	int		console_number = 32;
	int		slot = PA_SLOT;
	int		SCRIPT = FALSE;

	status = acnet_chgpgm(console_number,pa_task,slot,command_buffer,
			      SCRIPT);

	slot = SA_SLOT;

	status = acnet_chgpgm(console_number,sa_task,slot,command_buffer,
			      SCRIPT);