Invoking an administrative command in batch mode using wsadmin.sh

WAS v8.5 > Script the application serving environment (wsadmin) > Use the wsadmin scripting AdminTask object for scripted administration
Invoking an administrative command in batch mode using wsadmin.sh

Use AdminTask commands to invoke an administrative command in batch mode. This topic describes how to invoke an administrative command in batch mode using wsadmin.sh.
To invoke an administrative command in interactive mode, see the topic on invoking a command in interactive mode.
Invoke AdminTask commands interactively, in a script, or use the wsadmin -c command from an operating system command prompt.
See the topic on starting the wsadmin scripting client.
Issue one of the following commands:
If an administrative command does not have a target object and an argument, use the following command:
Jacl:
$AdminTask commandName

Jython:
AdminTask.commandName()

AdminTask description. Invoke an AdminTask command from a wsadmin command line.

Element Description

$ is a Jacl operator for substituting a variable name with its value
AdminTask is an object allowing administrative command management
commandName is the name of the administrative command to invoke

If an administrative command includes a target object but does not include any arguments or steps, use the following command:
Jacl:
$AdminTask commandName targetObject

Jython:
AdminTask.commandName(targetObject)

AdminTask targetObject description. Invoke an AdminTask command from a wsadmin command line.

Element Description

$ is a Jacl operator for substituting a variable name with its value
AdminTask is an object that supports administrative command management
commandName is the name of the administrative command to invoke
targetObject is the target object string for the invoked administrative command. The expect target object varies with each administrative command. View the online help for the invoked administrative command to learn more about what you should specify as the target object.
If an administrative command includes an argument or a step but does not include a target object, use the following command:
Jacl:
$AdminTask commandName options

Jython:
AdminTask.commandName(options)
AdminTask options description. Invoke an AdminTask command from a wsadmin command line.
Element Description
$ is a Jacl operator for substituting a variable name with its value
AdminTask is an object that supports administrative command management
commandName is the name of the administrative command to invoke
options
is the option string for the invoked administrative command. Depending on which administrative command you are invoking, the administrative command can have required or optional option values. The options string is different for each administrative command. View the online help for the invoked administrative command to obtain more information about which options are available. Arguments and steps listed on the online administrative command help are specified as options in the option string.
Each option consists of a dash followed immediately by an option name, and then followed by an option value if the option requires a value. If the invoked administrative command includes target objects, arguments, or steps, then the –interactive option is available to enter interactive mode. For example, using the output of the following online help for the listDataSource command:
WASX8006I: Detailed help for command: exportServer

Description: export the configuration of a 
server to a config archive.

Target object: None

Arguments:
*serverName - the name of a server *nodeName - the name of a node. This parameter 
becomes optional if the specified server name 
is unique across the cell.
*archive - the fully qualified file path of 
a config archive.

Steps:
None
Option names are specified with a dash before the names. Three options are required for this administrative command. The required options are -serverName, -nodename, and -archive. In addition, the -interactive option is available. Options are specified in the option string, which is enclosed by a pair of braces ({}) in Jacl and a pair of brackets ([]) in Jython.
If an administrative command includes a target object, and arguments or steps:
Jacl:
$AdminTask commandName targetObject options

Jython:
AdminTask.commandName(targetObject, options)
AdminTask targetObject with options description. Invoke an AdminTask command from a wsadmin command line.
Element Description
$ is a Jacl operator for substituting a variable name with its value
AdminTask is an object that supports administrative command management
commandName is the name of the administrative command to invoke
targetObject
is the target object string for the invoked administrative command. The expected target object varies with each administrative command. View the online help for the invoked administrative command to obtain information about what to specify as a target object. For example, using the output of the following online help for createJ2CConnectionFactory:
WASX8006I: Detailed help for command: 
createJ2CConnectionFactory

Description: Create a J2C connection factory

*Target object: The parent J2C resource adapter of 
the created J2C connection factory.

Arguments:
*connectionFactoryInterface - A connection factory 
interface defined in the deployment 
description of the parent J2C resource adapter.
*name - The name of the J2C connection factory.
*jndiName - The JNDI name of the created J2C 
connection factory.
description - The description for the created 
J2C connection factory.
authDataAlias - the authentication data alias of 
the created J2C connection factory.

Steps:
None
The target object is a configuration object name of a J2C resource adapter.
options
is the option string for the invoked administrative command. Depending on which administrative command you are invoking, the administrative command can have required or optional option values. The options string is different for each administrative command. View the online help for the invoked administrative command to obtain more information about which options are available. Arguments and steps listed on the online administrative command help are specified as options in the option string. Each option consists of a dash followed immediately by an option name, and then followed by an option value if the option requires a value. If the invoked administrative command includes target objects, arguments, or steps, then the –interactive option is available to enter interactive mode. For example, using the output of the following online help for listDataSource:
WASX8006I: Detailed help for command: 
createJ2CConnectionFactory

Description: Create a J2C connection factory

*Target object: The parent J2C resource adapter of 
the created J2C connection factory.

Arguments:
*connectionFactoryInterface - A connection factory 
interface defined in the deployment 
description of the parent J2C resource adapter.
*name - The name of the J2C connection factory.
*jndiName - The JNDI name of the created J2C 
connection factory.
description - The description for the created J2C 
connection factory.
authDataAlias - the authentication data alias of 
the created J2C connection factory.

Steps:
None
Option names are specified with a dash before the names. The required options for this administrative command include: -connectionFactoryInterface, -name, and -jndiName. The optional options include: -description and -authDataAlias. In addition, we can also use the -interactive option. Options are specified in the option string, which is enclosed by a pair of braces ({}) in Jacl and a pair of brackets ([]) in Jython.
Example
The following example invokes an administrative command with no target object, argument, or step:
Jacl:
$AdminTask listNodes

Jython:
print AdminTask.listNodes()

Example output:

myNode
The following example invokes an administrative command with a target object string:
Jacl:
set s1 [$AdminConfig getid /Server:server1/]
$AdminTask showServerInfo $s1
Jython:
s1 = AdminConfig.getid('/Server:server1/')
print AdminTask.showServerInfo(s1)
Example output:
{cell myCell}
{serverType APPLICATION_SERVER}
{com.ibm.websphere.baseProductv6.0.0.0}
{node myNode}
{server server1}
The following example invokes an administrative command with an option string:
Jacl:
$AdminTask getNodeMajorVersion {-nodeName myNode}

Jython:
print AdminTask.getNodeMajorVersion('[-nodeName myNode]')

Example output:
6
The following example invokes an administrative command with a target object and non-step option strings:
Jacl:
set ra [$AdminConfig getid /J2CResourceAdapter:myResourceAdapter/]
$AdminTask createJ2CConnectionFactory $ra {-name myJ2CCF -jndiName j2c/cf -connectionFactoryInterface 
javax.resource.cci.ConnectionFactory}
Jython:
ra = AdminConfig.getid('/J2CResourceAdapter:myResourceAdapter/') 
AdminTask.createJ2CConnectionFactory(ra, '[-name myJ2CCF -jndiName j2c/cf -connectionFactoryInterface 
javax.resource.cci.ConnectionFactory]')
Example output:
myJ2CCF(cells/myCell/nodes/myNode|resources.xml#J2CConnectionFactory_1069690568269)
The following example invokes an administrative command with a target object and a step option:
Jacl:
set serverCluster [$AdminConfig getid /ServerCluster:myCluster/]
$AdminTask createClusterMember $serverCluster {-memberConfig {{myNode myClusterMember "" "" false false}}}
Jython:
serverCluster = AdminConfig.getid('/ServerCluster:myCluster/')
AdminTask.createClusterMember(serverCluster, '[-memberConfig [[myNode myClusterMember "" "" false false]]]') 
Example output:
myClusterMember(cells/myCell/nodes/myNode|cluster.xml#ClusterMember_3673839301876)
Related

Invoking an administrative command in interactive mode using wsadmin.sh
Start the wsadmin scripting client using wsadmin.sh

+
Search Tips | Advanced Search

Element	Description
$	is a Jacl operator for substituting a variable name with its value
AdminTask	is an object allowing administrative command management
commandName	is the name of the administrative command to invoke

Element	Description
$	is a Jacl operator for substituting a variable name with its value
AdminTask	is an object that supports administrative command management
commandName	is the name of the administrative command to invoke
targetObject	is the target object string for the invoked administrative command. The expect target object varies with each administrative command. View the online help for the invoked administrative command to learn more about what you should specify as the target object.