Performing operations on running objects using wsdmin.sh

We can use scripting to invoke operations on running objects.

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

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

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

   • Jacl:

     $AdminControl completeObjectName name

   • Jython:

     AdminControl.completeObjectName(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.

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

   • Jacl:

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

   • Jython:

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

   description. Run the completeObjectName command

   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

3. Invoke the operation. For example:

   • Jacl:

     $AdminControl invoke $s1 stop

   • Jython:

     AdminControl.invoke(s1, 'stop')

   the invoke command with the server identifier and

   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 specified in step number 3
   stop	is an operation to invoke on the server

Example

The following example is for operations that require parameters:

• Jacl:

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

• Jython:

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

Related tasks

Start the wsadmin scripting client

Use the wsadmin scripting AdminControl object for scripted administration

Modify attributes on running objects using wsdmin.sh

Commands for the AdminControl object