Performing operations on running objects using the wsadmin scripting tool

You can use scripting to invoke operations on running objects.

Before you begin

Before starting this task, the wsadmin tool must be running. See the topic about starting the wsadmin scripting client.

About this task

You can run wsadmin commands that obtain the object names of running objects and perform operations:

Procedure

Obtain the object name of the running object. For example:

Using Jacl:
```
$AdminControl completeObjectName name
```
Using Jython:
```
AdminControl.completeObjectName(name)
```

Table 1. AdminControl completeObjectName command description . Run the completeObjectName command with an object name.
Element	Description
`$`	is a Jacl operator for substituting a variable name with its value
`AdminControl`	is an object that enables the manipulation of MBeans running in a product process
`completeObjectName`	is an AdminControl command
`name`	is a fragment of the object name. It is used to find the matching object name. For example: `type=Server,name=serv1,*`. It can be any valid combination of domain and key properties. For example, type, name, cell, node, process, etc.

Set the s1 variable to the running object, for example:

Using Jacl:

set s1 [$AdminControl completeObjectName type=Server,name=server1,*]

Using Jython:

s1 = AdminControl.completeObjectName('type=Server,name=server1,*')

Table 2. AdminControl completeObjectName with type command description . Run the completeObjectName command with an object type and name.
Element	Description
`set`	is a Jacl command
`s1`	is a variable name
`$`	is a Jacl operator for substituting a variable name with its value
`AdminControl`	is an object that enables the manipulation of MBeans running in a product process
`completeObjectName`	is an AdminControl command
`type`	is the object name property key
`Server`	is the name of the object
`name`	is the object name property key
`server1`	is the name of the server where the operation is invoked

Invoke the operation. For example:

Using Jacl:
```
$AdminControl invoke $s1 stop
```
Using Jython:
```
AdminControl.invoke(s1, 'stop')
```

Table 3. AdminControl invoke command description . Run the invoke command with the server identifier and stop operation.
Element	Description
`$`	is a Jacl operator for substituting a variable name with its value
`AdminControl`	is an object that enables the manipulation of MBeans running in a product process
`invoke`	is an AdminControl command
`s1`	is the ID of the server that is specified in step number 3
`stop`	is an operation to invoke on the server

Example

The following example is for operations that require parameters:

Using Jacl:

set traceServ [$AdminControl completeObjectName type=TraceService,process=server1,*]
$AdminControl invoke $traceServ appendTraceString "com.ibm.ws.management.*=all=enabled"

Using Jython:

traceServ = AdminControl.completeObjectName('type=TraceService,process=server1,*')
AdminControl.invoke(traceServ, 'appendTraceString',  "com.ibm.ws.management.*=all=enabled")