IBM WebSphere Application ServerTM
Release 7

com.ibm.websphere.ant.tasks
Class StopServer

java.lang.Object
  extended by org.apache.tools.ant.ProjectComponent
      extended by org.apache.tools.ant.Task
          extended by com.ibm.websphere.ant.tasks.ServerControl
              extended by com.ibm.websphere.ant.tasks.StopServer

public class StopServer
extends ServerControl

The wsStopServer task enables you to stop a standalone server instance. This is not used to stop a server controlled by DeploymentManager. Therefore, this task is useful for the Base Application Server, and to stop the Node Agent and/or DeploymentManager. If you wish to stop a server managed by the Deployment Manager, use the wsadmin task to execute a scripting command. The structure of the wsStopServer task is shown below:

<wsStopServer server="name of the server to stop" profileName="the profile name of the desired server" noWait="true | false" quiet="true | false" logFile="name of the file to log to" replaceLog="true | false" trace="true | false" timeout="amount of time to wait for the server to stop" statusPort="port for the server to send status messages to" conntype="SOAP | RMI" port="admin port of the server you wish to stop" username="name of the admin userid id to authenticate with" password="password of the admin user to authenticate with" wasHome="WebSphere Installation directory" failonerror="true | false" fileEncoding="UTF8"/> The server attribute is required and contains the name of the server you wish to stop
The profileName attribute is optional and it contains the name of the server profile to be used
The noWait attribute is optional. If true, the task with return immediately without waiting for the server to stop (default is false).
The quiet attribute is optional. If true, the task will not print any status information (default is false).
The logFile attribute is optional and specifies the name of the file to log the server start information to.
The replaceLog attribute is optional. If true, the task with erase an existing log file, instead of appending (default is false).
The trace attribute is optional. If true, the task with print trace information (default is false).
The timeout attribute is optional and specified the amount of time to wait for the server to successfully stop.
The statusPort attribute is optional and specifies the TCP Port the server should send status messages to.
The conntype attribute is optional and specifies the admin transport type to connect to the server with.
The username attribute is optional and specifies the id of the admin user to authenticate with for administrative access.
The password attrubute is optional and specifies the password of the admin user to authenticate with for administrative access
The wasHome attribute is optional and it specifies the WebSphere installation directory
The failonerror attribute is optional and if set to true causes the build to stop if the task has an error (default is false).
The fileEncoding attribute is optional and sets the file.encoding System Property for the underlying VM.

To use this task, add the following to your Ant build.xml <taskdef name="wsStopServer" classname="com.ibm.websphere.ant.tasks.StopServer"/>


Field Summary
 
Fields inherited from class org.apache.tools.ant.Task
description, location, target, taskName, taskType, wrapper
 
Fields inherited from class org.apache.tools.ant.ProjectComponent
project
 
Constructor Summary
StopServer()
           
 
Method Summary
 void addAdditionalArgs(java.util.ArrayList<java.lang.String> args)
           
 void addJvmArgs(org.apache.tools.ant.taskdefs.Java jvm)
           
 java.lang.String getMainClass()
           
 java.lang.String getTaskName()
           
 void setConntype(java.lang.String conntype)
          Sets the conntype.
 void setPort(java.lang.String port)
          Sets the port.
 
Methods inherited from class com.ibm.websphere.ant.tasks.ServerControl
execute, isDebug, runScript, setDebug, setFailonerror, setFileEncoding, setJvmMaxMemory, setLogFile, setNoWait, setPassword, setProfileName, setQuiet, setReplaceLog, setServer, setStatusPort, setTimeout, setTrace, setUsername, setWasHome
 
Methods inherited from class org.apache.tools.ant.Task
getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, maybeConfigure, perform, reconfigure, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType
 
Methods inherited from class org.apache.tools.ant.ProjectComponent
getProject, setProject
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

StopServer

public StopServer()
Method Detail

getMainClass

public java.lang.String getMainClass()
Specified by:
getMainClass in class ServerControl
See Also:
ServerControl.getMainClass()

addAdditionalArgs

public void addAdditionalArgs(java.util.ArrayList<java.lang.String> args)
Specified by:
addAdditionalArgs in class ServerControl
See Also:
ServerControl.addAdditionalArgs(ArrayList)

addJvmArgs

public void addJvmArgs(org.apache.tools.ant.taskdefs.Java jvm)
Specified by:
addJvmArgs in class ServerControl
See Also:
ServerControl.addJvmArgs(Java)

getTaskName

public java.lang.String getTaskName()
Specified by:
getTaskName in class ServerControl
See Also:
Task.getTaskName()

setConntype

public void setConntype(java.lang.String conntype)
Sets the conntype.

Parameters:
conntype - The conntype to set

setPort

public void setPort(java.lang.String port)
Sets the port.

Parameters:
port - The port to set

IBM WebSphere Application ServerTM
Release 7