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_dlogger stop=stop_event Specify the CyFlex event name that will stop the sampling. Example: stop=stop_dlogger rels=release_event Specify the CyFlex event name that will cause floger to exit the system. Example: rels=rels_dlogger done=done_event Specify the CyFlex event name that will be emitted when done sampling. Example: done=dlogger_done interval=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=1000 sync=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_sync enable=variable_name Specify the CyFlex variable name that will enable sampling. Example: enable=enb_dlogger path=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_var ftp_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.

See Also:

Logging Data using dlogger User Guide,  errs