tpm_varset

Sets the value of a configuration variable.

int

tpm_varset(

ade_id var_id,

char *var_name,

struct resbuf *valres);

Returns RTNORM or an error code.

var_id	Configuration variables ID.
var_name	Variable name.
valres	Variable value contained in a resbuf.

Configuration variables are composed of cleanup variables, cleanup action variables, and topology variables. The variables are initialized to their default values. For a list of these variables and their default values, see Configuration Variables.

Examples of building a resbuf for the valres argument.

rb = acutBuildList(RTSHORT, 4, 0);  // integer value
rb = acutBuildList(RTREAL, 1.0, 0); // real value
rb = acutBuildList(RTSTR, "0", 0);  // string value

You must release the resbuf.

The following sample allocates a set of configuration variables using tpm_varalloc(). A resbuf is created containing the layer name that will be associated with the LINK_LAYER configuration variable. Tpm_varset() is called with all required parameters and the return code is evaluated for the appropriate display message. The resbuf is then released as required.

ade_id varId = tpm_varalloc();
char* pszConfigVarName = "LINK_LAYER";
struct resbuf* pConfigVarsRb = acutBuildList(RTSTR, "Links", 0);
int returnCode = tpm_varset(varId, pszConfigVarName, pConfigVarsRb);
if (RTNORM == returnCode){
    acutPrintf(
        "\nThe specified configuration variable has been set.");
}
else {
    acutPrintf(
        "\nThe specified configuration variable was not set.");
}
acutRelRb(pConfigVarsRb);