2.2 cavput

• description: cavput sends values to EPICS process variables using Channel Access or PVAccess. It supports vector puts, delta mode, ramping, and numerical or char array data modes, making it useful for scripting accelerator operations.
• examples: Set all storage ring quadrupoles to zero.
      cavput -list=S -range=begin=1,end=40,format=\%ld  
        -list=AQ,BQ -range=begin=1,end=5 -list=:CurrentAI=0  
  

  Configure slow beam history for S1A BPMs and 4080 samples.

      cavput -list=S:bpm -range=begin=1,end=40,format=\%ld -list=:SlowBh:  
        -list=MI=0,sizeAO=4080,modeBO=1,enableBO=1  
  

• synopsis:
  usage: cavput [-list=<string>[=<value>][,<string>[=<value>]...]]  
        [-range=begin=<integer>,end=<integer>[,format=<string>][,interval=<integer>]]  
        [-pendIoTime=<seconds>] [-dryRun] [-deltaMode[=factor=<value>]] [-ramp=step=<n>,pause=<sec>]  
        [-numerical] [-charArray] [-blunderAhead[=silently]]  
        [-provider=\{ca|pva\}]  
  

• switches:
  • -list — Specify PV name components with optional values. Repeating -list concatenates the components to form each PV name, and forms like -list=:Set=5 assign the value 5.
  • -range — Generate PV names from a range.
    For example, -list=Q -range=begin=1,end=4,format=%02d -list=:Set=0
    creates Q01:Set through Q04:Set with value 0.
  • -pendIoTime — Maximum time to wait for connections and return values (default 1.0 s).
  • -dryRun — Show PV names and values without sending to IOCs.
  • -deltaMode — Treat values as deltas from current PV values; optional factor.
  • -ramp — Ramp to the value in steps with an optional pause.
  • -numerical — Force conversion to numeric mode.
  • -charArray — Use string mode for char array PVs.
  • -blunderAhead — Continue puts even if some PVs fail to connect; silently suppresses errors.
  • -provider — Select Channel Access (ca) or PVAccess (pva).
• author: Michael Borland, Robert Soliday, ANL/APS.