Status command

The launcher -status command returns the state of the specified Launcher system or Launcher HTTP Listener. The status returns as a message to the console or as a return code that you can retrieve by using the ECHO command.

Syntax

{launcher.bat | launcher.sh} 
  [-status launchername {system_name | listener_name}]

system_name

Returns the status of the specified Launcher system. The system_name keyword is optional, but you must specify either a system_name or a listener_name for the specified Launcher.

The system status is one of the following:

Table 1. Launcher system return codes and status
Return code	Status
0	Stopped
1	Stopping
2	Pausing
3	Paused
4	Started
5	Starting
6	Not Responding
7	Unknown Error
101	The Launcher (with the specific settings) is not started.
102	The name of the Launcher supplied on the command line is not valid.
103	The user name, password, or both user name and password are not valid.
104	The connection between this utility and the Launcher is lost when trying to retrieve the status. For example, if another user stops the Launcher.
105	The command line supplied is invalid.
106	Launcher is not in a running state.
107	The name of the system (`systemname`) supplied on the command line is invalid, or it is blank and there is no compoundsystem present under the Launcher service.
108	The Launcher raised an exception.
	Unable to connect to the Launcher.

listener_name

Returns the status of the specified Launcher HTTP Listener, as well as the start time and running time (up time) of a running listener. The The listener_name keyword is optional, but you must specify either a system_name or a listener_name for the specified Launcher.

The HTTP Listener status is one of the following:

Table 2. HTTP Listener return codes and status
Return code	Status
0	Stopped
1	Starting
2	Running
3	Not responding

Example

The following example returns the HTTP Listener status as a message to the console and retrieves the status return code.

C:\IBM\WebSphere Transformation Extender
9.0.0>launcher -status MyServer -lsnr LSNRA
Status of the listener "LSNRA" on the server "localhost" and port "5015" is "Listener Running"
Listener "LSNRA" Start Time is 16:24:11 and Up Time is 03:53
C:\IBM\WebSphere Transformation Extender
9.0.0>echo %ERRORLEVEL%
2