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")