Getting the short status of a service

You can view the status of a service as a short status message from the command line.

About this task

The Java™ class RootAdmin has a public interface that enables you to provide command options to get certain information about each service type and to perform specific activities that are associated with each service. Besides, the administration of the services, the following useful information can be captured by using the public interface of the RootAdmin class:
  • Memory usage (service and connection pool)
  • Connection pool status (size of connection pool, current connection usage)
  • Database pool status (connections in use, maximum connections possible)
  • Thread names and count per service / process
  • Session cache information

Running the RootAdmin class without options, shows the following usage information:

$JAVA_RT com.ibm.ccd.admin.common.RootAdmin

Usage: RootAdmin -cmd=<cmd> [-host=<host>] [-svc=<svc name>] [-type=<type>]
See config file: <WPC INSTALL DIR>/etc/default/admin_properties.xml
1/ to start a service: -cmd=start -host=<host> -svc=<svc name> -type=<svc type>
   where <svc type> is:
         -admin
         -appsvr
         -eventprocessor
         -queuemanager
         -scheduler
         -workflowengine
   and <host> is:
         -jonas1
2/ to stop a service: -cmd=stop -svc=<svc name>
3/ to stop a thread: -cmd=stop_thread -svc=<svc name> -thread=<thread number>
4/ to abort a service: -cmd=abort -svc=<svc name>
5/ to check a service: -cmd=check -svc=<svc name>
6/ to get the status of a service: -cmd=status -svc=<svc name>
7/ to get the list of services: -cmd=rmi_status
8/ to unbind a service: -cmd=unbind -svc=<svc name>
9/ to stop all local services: -cmd=stop_local

Procedure

Run the rootadmin.sh shell script that is in the $TOP/bin/go directory:
Syntax
rootadmin.sh -cmd=status -svc=service_name
Parameters
-cmd=status
Specifies the script command where status can be one of the following commands:
  • check
  • stop
  • stop_thread
  • abort
  • rmi_status
  • stop_local
Use check to display the short status.
-svc=service_name
Specifies the service where service_name is the service name.

The service name for the option -svc can be found by going to $TOP/logs/. This directory provides the names of the respective service types, which include the hostname.

Short status messages
Running
The service is running and responding.
Not found
The service is not found. The service might not be started or it might have stopped.
Found but not responding
The service was found as registered with the RMI registry, but the service is not responding to the "heartbeat" function. The service might need to be restarted.

Example

In this example, the scheduler short status for the service displays.
rootadmin.sh -cmd=check -svc=scheduler
In this following example, the directory for the appserver process under $TOP/logs has the name "appsvr_Jonas1", and this name needs to be supplied to the option "-svc".
$JAVA_RT com.ibm.ccd.admin.common.RootAdmin -cmd=status -svc=appsvr_Jonas1
The resulting HTML output from this command can be put into a file and is readable by an Internet browser.
Memory usage: 107102k

connection pool status
	local date:Wed Jun 03 12:00:58 CEST 2009
	memory (in kb): used:118400,free:154226,total:272628
	service type:appsvr
	db instance:pimdb
	db user:wpcfp11
	broker size:10
	broker in use:0
	conn file:/opt/wpc/envs/jonas15/wpc_532_FP11_DB2/logs/appsvr_JONAS1/db_pool/db_pool.txt.28-MAY_11_48_43_176

db pool status(size:2)
name:default
used:0
max:26

name:system
used:0
max:4

db tread status(size:7) <td>true<td>true<td>truetrue
name:Thread-21
create time:Thu May 28 11:48:44 CEST 2009
pool:default
block:false
blocked:false

name:memorymonitor_daemon1
create time:Thu May 28 11:48:44 CEST 2009
pool:system
block:true
blocked:false

name:dst_worker_1
create time:Thu May 28 11:49:28 CEST 2009
pool:default
block:false

name:qmgr_deamon
create time:Thu May 28 11:49:28 CEST 2009
pool:system
block:true
blocked:false

name:dst_worker_0
create time:Thu May 28 11:49:28 CEST 2009
pool:default
block:false

name:dst_worker_2
create time:Thu May 28 11:49:28 CEST 2009
pool:default
block:false

name:email_deamon
create time:Thu May 28 11:49:28 CEST 2009
pool:system
block:false

db connection status(size:0)

Status Information for Session Cache
	CtgViewMgr:Admin[1252476390]
		Type:View, Name:RegView
		Type:View, Name:RegView
		Type:View, Name:[System Default]
		Type:View, Name:RegView

What to do next

If the service status shows that the service has failed or is unresponsive, you can stop or abort the service, see either Stopping a service or Aborting a service.