dlogger
Purpose:
-
Start a fast DARTS (Data Storage, Analysis and Reporting System) data logging operation.
Enter:
- dlogger [dlogger_spec_file] [options]
Where:
-
dlogger_spec_file Optional. Specify the name of DARTS logger specification file.
Default: dlogger_spec.nnn (nnn = test cell number)options Any option specified on the command line overrides the same option in the spec file. Specify any of the following:
start=strt_event Specify the CyFlex event name that will start the sampling.
Example: start=start_dloggerstop=stop_event Specify the CyFlex event name that will stop the sampling.
Example: stop=stop_dloggerrels=release_event Specify the CyFlex event name that will cause floger to exit the system.
Example: rels=rels_dloggerdone=done_event Specify the CyFlex event name that will be emitted when done sampling.
Example: done=dlogger_doneinterval=interval Specify the time interval between data samples. Units must be supplied.
Example: interval=1[sec]n=max scans Specify the maximum number of data samples or scans to be collected.
Example: n=1000sync=sync_event Specify the CyFlex event name that will cause the start the sampling. If specified, this is used in place of the timer, therefore no interval should be specified.
Example: sync=dlogger_syncenable=variable_name Specify the CyFlex variable name that will enable sampling.
Example: enable=enb_dloggerpath=directoryPath Specify the directory path to contain the output file. The entry may also be a STRING_VARIABLE that contains the directory path of the output file.
Default: /data/dlog
Example: path=dlogger_path_varftp_event=event_name Specify the CyFlex event name to use to signal that the output file should be FTP’d to the ftp_path.
Default: FTP_write
Example: ftp_event=dlogger_xfer+H Specify this flag to create a new data file when the “enable” variable goes TRUE.
Example:
-
dlogger /specs/dlog1 n =1000 interval = 1(sec) &
The above command causes the file /specs/dlog1 to be processed. The number of samples is set to 1000 and the samples are taken every second. The output file that is specified in the spec file will be overwritten. The number of samples and the interval specified in the spec will be overridden by the command line arguments.
Notes:
-
The dlogger command starts a data logger and causes the data logger package to be configured with the specified logger specification file. Multiple loggers may be operating simultaneously.
When the values for all variables that are specified in the spec file are sampled, that is considered ‘one’ sample or one scan. The ‘interval’ is the time between obtaining the values of all the specified variables. The ‘n=’ option refers to the number of times all specified variables are sampled.
The ‘start event’ and ‘stop event’ only apply when an interval is specified via the command line or the spec file.
If no ‘start event’, ‘sync event’, or ‘interval’ is specified, then the sampling starts immediately.
If ‘maximum number of scans’ was not specified, then the sampling will continue until the stop or release events are received or the task is slayed.
Use the errs command to check for errors after using this command.