SLAC ESD Software Engineering Group
Stanford Linear Accelerator Center

SLC BGRP Set Variable Data Provider Guide

SLAC Detailed
SLAC Computing
Software Home
Software Detailed

This page provides documentation for users and programmers of AIDA's SLC BGRP Set Variable Data Provider. This data provider allows for the setting of a BGRP variable value.

See Also: Basic Users Guide to Aida, REF_AIDASHR; AIDA SLC Peer Programmers Guide

Users Guide

This section describes what an AIDA user should know about using the SLC BGRP Set Variable data provider.For general information on using see Basic Users Guide to Aida, and the Aida javadoc, in particular the classes DaObject and DaReference (and DaReference's parent _DaReference) in aida.lib.da which form Aida's programming interface. One can also use Matlab.

Table 1: Summary of AIDA Data Provider for SLC Set Variable

Supports a set operation to set the value of a specified variable for a specified BGRP.
Status and limitations The data provider is complete and there are no known limitations.
Plan No active plans for extensions.

Schematic Java example. See for two BGRP set variable examples.
String query  = "BGRP//VAL";
da.setParam("BGRP", "LCLS");            /* Required BGRP parameter specifying a BGRP name. */
da.setParam("VARNAME", "T_CAV");        /* Required VARNAME parameter specifying a variable name for the BGRP. */
String setValue = "Y";                  /* New BGRP variable value ("N" or "Y"). */
DaValue inData = new DaValue(setValue); /* Creation of DaValue to hold new BGRP variable set value. */
da.setDaValue(query, inData);           /* Perform BGRP varaible set value operation. */
Java $CD_SOFT/ref/package/aida/test/java/
Matlab $CD_SOFT/ref/package/aida/test/matlab/bgrpDemo.m

Types Description
BGRP Set Variable Request Syntax BGRP//VAL  
Example BGRP//VAL
Instance Attributes
Attribute Description
VAL Sets a BGRP variable to a new value. The parameter data argument (p) is a DaValue containing a String specifying the new variable value ("N" or "Y").
Methods Name* Returns
setDaValue(q, p) Does not return a value.
Parameters Name


Syntax Semantics


The BGRP name.


A BGRP variable name for the specified BGRP.

* See DaObject and DaReference (and DaReference's parent _DaReference) in aida.lib.da for full API and method signatures.

Programmers Guide

The SLC BGRP Set Variable Data Provider is a provider in the AIDA SLC Peer (along with others such as the SLC DB Data Provider, the SLC History Data Provider, the SLC Model Data Provider, the SLC BPM Data Provider, the SLC Magnet Data Provider, the SLC Master Oscillator Data Provider, and the SLC Klystron Data Provider). Development of all these data providers is described in a Programmers Guide here.

[SLAC ESD Software Engineering Group][ SLAC Home Page]

Author:  Bob Hall 12-Dec-2006