Stop the WebSphere Application Server environment

This topic describes how to shutdown the WebSphere Application Server subsystem in order to completely shutdown the WebSphere Application Server environment. For information about stopping individual servers, nodes and deployment managers, see Start and stop WebSphere Application Server. In all cases, it is important to end the job gracefully so that the job can finish any tasks that are currently in progress, clean up any open connections, and end multiple threads in an appropriate order.

You can stop (end) the WebSphere Application Server environment by invoking the End Subsystem (ENDSBS) OS/400 CL command specifying the QWAS6 subsystem:

ENDSBS SBS(QWAS6) OPTION(*CNTRLD) DELAY(adequateNumberOfSeconds)

where adequateNumberOfSeconds is appropriate for the amount of time it takes to stop the WebSphere Application Server servers running on your iSeries server.

You can also use the End Job (ENDJOB) OS/400 CL command on against the jobs running in the QWAS6 subsystem:

ENDJOB JOB(jobNumber/QEJBSVR/jobName) OPTION(*CNTRLD) DELAY(adequateNumberOfSeconds)

To determine what is an adequate number of seconds, end the subsystem in a controlled fashion with DELAY(*NOLIMIT). The job logs for all WebSphere Application Server servers running in subsystem QWAS6 include message WAS0107 indicating that the server running in the job has ended. If the job is ended due to a SIGTERM signal (the signal is issued when commands such as ENDJOB, ENDSBS, etc are issued that result in the job being ended), the message contains the number of seconds required to gracefully end the application server. However, if the application server does not have enough time to end the application server gracefully, no message is issued.

If no message is found in the job log, it is a good indication that you need to increase the amount of time specified on the ENDSBS or ENDJOB command.

If use the ENDSBS OPTION(*IMMED) command or ENDJOB OPTION(*IMMED), it is recommended that you set the amount of time available for handling the job termination signal to an appropriate value. In V5R3, the value is represented by the QENDJOBLMT system value. To set the value in V5R2, create a data area that specifies the number of seconds for the handler to wait. For example:

CRTDTAARA DTAARA(QSYS/QENDJOBLMT) TYPE(*DEC) LEN(5 0) VALUE(600) TEXT('TIME LIMIT IN SECONDS')