2.26 sddspvasaverestore

• description: sddspvasaverestore saves or restores EPICS process variable values using the EPICS PVA interface. It reads an SDDS input file listing process variables and either writes current values to an output file or sets the PVs to values from the input file. Options allow daemon operation, run control integration, trigger PVs, and waveform handling.
• examples:
  sddspvasaverestore pvlist.sdds snapshots/sr -save -dailyFiles -logFile=save.log

• synopsis:
  usage: sddspvasaverestore <inputfile> <outputRoot> [-pipe=[input|output]]  
    [-save] [-restore[=verify]]  
    [-daemon]  
      [-inputFilePV=<pvname>,<provider>] [-outputFilePV=<pvname>,<provider>]  
      [-triggerPV=<string>,<provider>]  
      [-description=<string>|pv=<pvname>,provider=<provider>]  
    [-interval=<seconds>] [-pendIOTime=<seconds>]  
    [-dailyFiles] [-semaphore=<filename>] [-logFile=<filename>]  
    [-unique] [-pidFile=<pidFile>] [-verbose]  
    [-waveform=[rootname=<string>][,directory=<string>][,extension=<string>][,pingTimeout=<seconds>]  
      [,onefile][,savewaveformFile][,fullname]]  
    [-numerical]  
    [-runControlPV={string=<string>|parameter=<string>},pingTimeout=<value>,pingInterval=<value>]  
    [-runControlDescription={string=<string>|parameter=<string>}]

• files:
  • input file: SDDS file listing PVs to save or restore, including columns ControlName and ValueString for restoring.
  • output file: SDDS file receiving saved PV values when -save is used.
• switches:
  • -save — read PV values and write them to the output file.
  • -restore[=verify] — write values from the input file to PVs; optional verify reads back each value.
  • -daemon — run in background, waiting for file changes or trigger PV activity.
  • -dailyFiles — append the current date to the output filename.
  • -interval=<seconds> — loop interval when in daemon mode or when checking a trigger PV.
  • -triggerPV=<pv>,<provider> — PV that causes a save when it changes from 0 to 1.
  • -inputFilePV=<pv>,<provider> — PV providing the input filename.
  • -outputFilePV=<pv>,<provider> — PV receiving the output filename.
  • -description=<string>|pv=<pv>,provider=<provider> — snapshot description or PV supplying it.
  • -waveform=[...] — configure saving or restoring waveform PV data.
  • -runControlPV=string=<string>|parameter=<string>,pingTimeout=<value>,pingInterval=<value> — run control record and ping settings.
  • -runControlDescription=string=<string>|parameter=<string> — description string for run control logging.
  • -numerical — output numeric strings for enumerated PV types.
  • -pendIOTime=<seconds> — maximum time to wait for connections and value returns.
  • -semaphore=<filename> — flag file written when connections are complete.
  • -pidFile=<file> — file to store process ID.
  • -logFile=<file> — log file for program messages.
  • -unique — remove duplicate PVs from the input file.
  • -verbose — print progress messages.
  • -pipe[=input][,output] — standard SDDS Toolkit pipe option.
• see also:
  • sddssnapshot()
• author: Hairong Shang, Robert Soliday, ANL/APS.