4.34 sddsconvertalarmlog

• description: sddsconvertalarmlog converts sddsalarmlog output to an explicit, array-free SDDS file. It dereferences ControlNameString, AlarmStatusString, and AlarmSeverityString into string columns and computes an epoch Time column from TimeOfDay, StartTime, and StartHour when needed.
• examples:
  sddsconvertalarmlog alarmLog.sdds output.sdds -minimumInterval=10  
  sddsconvertalarmlog alarmLog.sdds snapshot.sdds -snapshot=1700000000 -retain=Time,ControlName,AlarmStatus,AlarmSeverity  
      

• synopsis:
  sddsconvertalarmlog [input-file] [output-file] [-pipe[=input][,output]]  
    [-binary | -ascii] [-float | -double]  
    [-minimumInterval=seconds] [-snapshot=epochtime]  
    [-time=[start=epochtime][,end=epochtime]]  
    [-delete=column-names] [-retain=column-names]  
      

• files: input-file is an SDDS alarm log; output-file is the converted result. The output contains no SDDS arrays.
• switches:
  • -binary or -ascii – set the output file format.
  • -minimumInterval=seconds – discard records closer than the interval.
  • -snapshot=epochtime – output the latest alarm state for each PV at the specified epoch time.
  • -time=start,end – limit records to the given epoch time range.
  • -delete or -retain – remove or keep listed columns.
• see also: sddsconvert(), sddsprocess().
• author: R. Soliday, ANL/APS.