VariableConfiguration
Use the Jython or Jacl scripting languages to configure servers with wsadmin. The commands and parameters in the VariableConfiguration group can be used to remove variable definitions from the system, to set values for variables, or to query for variable values with a specific scope.
The VariableConfiguration includes the following commands:
removeVariable
Use the removeVariable command to remove a variable definition from the system. A variable is a configuration property that we can use to provide a parameter for some values in the system.
Target object
None
Parameters and return values
- -variableName
- The name of the variable. (String, required)
- -scope
- The scope of the variable definition. The default is Cell. (String, optional)
- The syntax of the scope parameter is Type=value
- Supported types are Cell, Node, Servers, Application and Cluster, for example:
- Node=node1
- Node=node1, Server=server1
- Application=app1
- Cluster=cluster1
- Cell=cell1
- -node
- The name of the node. This parameter is only needed for server scopes that do not have unique name across nodes. (String, optional)
Examples
Interactive mode example usage:
- Jacl...
$AdminTask removeVariable {-interactive}- Use Jython string:
AdminTask.removeVariable ('[-interactive]')- Use Jython list:
AdminTask.removeVariable (['-interactive'])
setVariable
Use the setVariable command to set the value for a variable. A variable is a configuration property that we can use to provide a parameter for some values in the system.
Target object
None
Parameters and return values
- -variableName
- The name of the variable. (String, required)
- -scope
- The scope of the variable definition. The default is Cell. (String, optional)
- The syntax of the scope parameter is Type=value...
- Node=node1
- Node=node1,Server=server1
- Application=app1
- Cluster=cluster1
- Cell=cell1
.
- -node
- The name of the node. This parameter is only needed for server scopes that do not have unique name across nodes. (String, optional)
- -variableValue
- The value of the variable. (String, optional)
- -variableDescription
- The description of the variable. (String, optional)
Examples
Batch mode example usage:
- Jacl...
$AdminTask setVariable {-variableName varname1 -scope Cell=localhostNode01Cell,Node=localhostNode01}- Use Jython string:
AdminTask.setVariable('[-variableName varname1 -scope Cell=localhostNode01Cell,Node=localhostNode01]')- Use Jython list:
AdminTask.setVariable(['-variableName', 'varname1', '-scope', 'Cell=localhostNode01Cell,Node=localhostNode01'])
Interactive mode example usage:
- Jacl...
$AdminTask setVariable {-interactive}- Use Jython string:
AdminTask.setVariable ('[-interactive]')- Use Jython list:
AdminTask.setVariable (['-interactive'])
showVariables
Use the showVariables command to list variable values under a scope.
Target object
None
Parameters and return values
- - scope
- The scope of the variable definition. The default is Cell. (String, optional)
- The syntax of the scope parameter is Type=value
- Supported types are Cell, Node, Servers, Application and Cluster, for example:
- Node=node1
- Node=node1, Server=server1
- Application=app1
- Cluster=cluster1
- Cell=cell1
- -node
- The name of the node. This parameter is only needed for server scopes that do not have unique name across nodes. (String, optional)
- -variableName
- The name of the variable. If we specify this parameter, the value of this variable is returned. If we do not specify this parameter, all variables defined under the scope will return in list format where each element is a variable name and value pair. (String, optional)
Examples
Interactive mode example usage:
- Jacl...
$AdminTask showVariables {-interactive}- Use Jython string:
AdminTask.showVariables ('[-interactive]')- Use Jython list:
AdminTask.showVariables (['-interactive'])
Related tasks
Use AdminTask for scripted administration
Related
Commands for AdminTask