Scripting objects

The wsadmin tool operates on configurations and running objects through the following set of management objects: AdminConfig, AdminControl, AdminApp, and Help. Each of these objects has commands that you can use to perform administrative tasks. The wsadmin tool requires that you specify a scripting object, a command, and command arguments.

WebSphere Application Server System Management separates administrative functions into two categories: functions that deal with the configuration of WebSphere Application Server installations, and functions that deal with the currently running objects in WebSphere Application Server installations.

Scripts deal with both categories of objects. For example, an application server is divided into two distinct entities. One entity represents the configuration of the server which resides persistently in a repository on permanent storage. You can create, query, change, or remove this configuration without starting an appserver process. The AdminConfig and AdminApp objects handle configuration functionality. You can invoke configuration functions with or without being connected to a server.

The second entity represents the running instance of an appserver by a Java Management Extensions (JMX) MBean. This instance can have attributes that you can interrogate and change, and operations that you can invoke. These operational actions taken against a running appserver do not have an effect on the persistent configuration of the server. The attributes that support manipulation from an MBean differ from the attributes the corresponding configuration supports. The configuration can include many attributes that you cannot query or set from the live running object. The WebSphere Application Server scripting support provides functions to locate configuration objects, and live running objects.

Note: Objects in the configuration do not always represent objects that are currently running. The AdminControl object manages running objects.

You can use the Help object to obtain information about the AdminConfig, AdminApp and AdminControl objects, and to obtain interface information about running MBeans.


Related concepts
Jacl
Related reference
Help object for scripted administration
AdminApp object for scripted administration
AdminControl object for scripted administration
AdminConfig object for scripted administration
Wsadmin tool