remote_program_build_method_c

	status.i4.v = remote_program_build_method_c(program_name.i1a.r,
						    message_buffer.g.v,
						    buffer_length.i4.v,
						    method.i1a.r,
						    method_object.i1a.r,
						    method_qual.i1a.r,
						    copy_options.sa.r,
						    num_options.i4.v,
						    terminate.i4.v,
						    message_length.u4.r)

	This routine builds a remote program method 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
	method		null terminated method to execute
			(maximum length is REMOTE_METHOD_NAME_LEN)
	method_object	null terminated method object
			(maximum length is REMOTE_METHOD_OBJECT_LEN)
	method_qual	null terminated method qualifier
			(maximum length is REMOTE_METHOD_QUALIFIER_LEN)
	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 method program disposition
			(TRUE -> terminate program after method has been
				 completed,
			 FALSE -> program will continue running after
				  the method has 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_pgm_build_script_list_c,
	run_remote_program_c, remote_program_check, remote_program_get_method,
	remote_program_get_script

	C/C++ usage:

	static const char	program_name[] = "SA1082";
	char			message_buffer[CMD_LIN_SIZ];
	static const char	method[] = "display image";
	static const char	method_object[] = "BLDGTEMP";
	static const char	method_qual[] = "";
	int			status;
	int			num_options = 1;
	int			terminate = FALSE;
	int			message_length;
	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_program_build_method_c(program_name,
					       (void *) message_buffer,
					       sizeof(message_buffer),
					       method,method_object,method_qual,
					       &copy_options,num_options,
					       terminate,&message_length);