ftp_start_plot_from_file_c
status.i4.v = ftp_start_plot_from_file_c(console_number.i4.v,
sa_slot.i4.v,
system_name.i1a.r, file.g.v,
options.u4.v)
This routine starts up a fast time plot using a saved plot setup
file.
console_number console number to run Fast Time Plot on
(A value of zero can be used for the local console.)
sa_slot SA slot to run Fast Time Plot 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,
AVAILABLE_SA_SLOT -> choose available SA slot)
system_name null terminated file system name
file file to plot which depends upon the option selected
(FTP_OPT_NONE -> null terminated file name,
FTP_OPT_BY_FILE_NUMBER -> file number (starts at 1))
options plot options
(FTP_OPT_NONE -> no options selected ("file" is
interpreted as a file name),
FTP_OPT_BY_FILE_NUMBER -> file specified by
file number,
FTP_OPT_NO_ERASE -> don't erase current plot before
starting new plot)
This function returns ACNET status values as follows:
OK success
CLIB_INVARG null pointers were passed for either the
system name or file specification
CLIB_NO_SUCH no program slot available or requested
file doesn't exist
SQL_xxx error reading file
This function requires the following include files:
cnsparam_h, cns_data_structs_h, tclk_events_h, cbslib_h, acnet_errors_h
Related functions:
ftp_start_plot_c, ftp_start_plot_by_name_c, ftp_read_plot_setup_file_c,
ftp_file_menu_c, ftp_start, ftp_setup, fstplt, ftp_calculated_trace_c,
snp_start_plot_from_file_c, snp_read_plot_setup_file_c,
snp_file_menu_c, snp_start_plot_c, snp_setup, snp_start, snpplt,
snp_set_sda_info_c, snp_export_data
C/C++ usage:
static const char system_name[] = "Recycler";
static const char file[] = "Slip plot";
int status;
int console_number = LOCAL_CONSOLE;
int sa_slot = AVAILABLE_SA_SLOT;
unsigned int options = FTP_OPT_NONE;
status = ftp_start_plot_from_file_c(console_number,sa_slot,
system_name,(void *) file,
options);