remote_pgm_build_script_list_c

	status.i4.v = remote_pgm_build_script_list_c(program_name.i1a.r,
						     message_buffer.g.v,
						     buffer_length.i4.v,
						     script_file.i1a.r,
						     replay_speed.r4.v,
						     set_lock.i4.v,
						     fswrite_lock.i4.v,
						     copy_options.sa.r,
						     num_options.i4.v,
						     terminate.i4.v,
						     message_length.u4.r)

	This routine builds a remote program script list playback
	request message.

	program_name	program name (eg "PA0052" or "D44")
			(PROCESS_NAME_LEN characters)
	message_buffer	message buffer to fill
	buffer_length	length of message buffer
	script_file	null terminated name of file name containing
			list of scripts to execute
			(maximum length is SCRIPT_LIST_FILE_LEN characters)
	replay_speed	multiplier on the periodic interrupts
			(1.0 is normal speed)
	set_lock	settings lock
			(TRUE -> prevent device settings,
			 FALSE -> allow settings)
	fswrite_lock	file write lock
			(TRUE -> prevent Filesharing file writes,
   			 FALSE -> allow file writes)
	copy_options	array of program image copy requests
			(array of structures of type REMOTE_COPY_DATA)
			(If no copies are desired, a value of NULL can
			 be passed for this argument.)
	num_options	number of copy options being requested
	terminate	end of script program disposition
			(TRUE -> terminate program after scripts have all been
				 completed,
			 FALSE -> program will continue running after all of
				  the scripts have been completed)
	message_length	returned length of message built (Note: This
			will return the size of the message even if
			the build fails.)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_TOO_MANY		message will not fit in buffer

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, clib_h, acnet_errors_h, tclk_events_h

	Related functions:

	remote_program_build_script_c, remote_program_build_method_c,
	run_remote_program_c, remote_program_check, remote_program_get_method,
	remote_program_get_script

	C/C++ usage:

	static const char	program_name[] = "PA1516";
	static const char	script_file[] = "usera:[hendricks]script_list.txt"
	char			message_buffer[CMD_LIN_SIZ];
	int			status;
	int			set_lock = FALSE;
	int			fswrite_lock = FALSE;
	int			num_options = 1;
	int			terminate = FALSE;
	int			message_length;
	float			replay_speed = 1.0;
	REMOTE_COPY_DATA	copy_options;

	copy_options.screen_id = REMOTE_COPY_GRAPHICS_1;
	copy_options.clock_event = EVENT_NULL;
	copy_options.delay = 0;
	strcpy(copy_options.path,"/scratch/userb/pic/capture/");
	strcpy(copy_options.name,"plot_file_name");
	copy_options.append_date = TRUE;

	status = remote_pgm_build_script_list_c(program_name,
						(void *) message_buffer,
						sizeof(message_buffer),
						script_file,replay_speed,
						set_lock,fswrite_lock,
						&copy_options,num_options,
						terminate,&message_length);