Comando stopServer
O comando stopServer lê o arquivo de configuração para o processo de servidor especificado. Este comando envia um comando JMS (Java™ management extensions) para o servidor informando-o a fechar.
O processo do servidor pode ser um servidor de aplicativos, um DMZ Secure Proxy Server for IBM® WebSphere Application Server, um servidor de agente administrativo ou um servidor de gerenciador de tarefas
Por padrão, o comando stopServer não retorna o controle à linha de comandos até que o servidor conclua o processo de encerramento. Há uma opção -nowait de retornar imediatamente e outras opções para controlar o comportamento do comando stopServer. Para obter informações adicionais sobre onde executar esse comando, consulte o tópico Utilizando ferramentas de linha de comandos.
Se você estiver executando o produto em um sistema operacional
Microsoft Windows
e tiver o servidor em execução como um serviço do sistema operacional
Windows,
o comando stopServer irá parar o serviço do
Windows
que é responsável por iniciar o servidor.
Apesar do comando stopServer retornar o controle quando o servidor conclui o encerramento, ele poderá retornar antes do processo do IBM i ter sido concluído. Dependendo da quantidade de memória que a Java virtual
machine (JVM) deve retornar para o conjunto de memórias, o processo pode demorar alguns segundos ou minutos para terminar completamente. Você não deve tentar iniciar o servidor novamente até o processo ter terminado. Utilize o comando WRKACTJOB SBS(subsystem) CL para determinar se o processo está completamente terminado. Por padrão, o subsistema é QWAS85.
Se a segurança estiver ativada, você deverá usar um nome de usuário e senha porque o comando chama um método MBean no servidor.
Os parâmetros de nome de usuário e senha não são necessários com o comando stopServer. Os parâmetros são automaticamente transmitidos ao script que o serviço do sistema operacional Windows usa para fechar o sistema.

Sintaxe
A sintaxe de comando é uma das seguintes:
stopServer <server_name> [options]
em que server_name é o nome do diretório de configuração do servidor de aplicativos ou o DMZ Secure Proxy Server for IBM WebSphere Application Server que você deseja parar.
Esse argumento é obrigatório.
Este argumento é opcional. Se o perfil padrão está sendo utilizado, o servidor será padronizado como server1. Se o
nome do perfil não for o padrão, o servidor será padronizado como o nome do perfil.
stopServer <adminagent_name>
em que adminagent_name é o nome do agente administrativo que você deseja parar.
stopServer <job_manager>
em que job_manager é o nome do gerenciador de tarefas que você deseja parar.
Executar Como
As opções a seguir estão disponíveis para o comando stopServer:
- -nowait
- Instrui ao comando stopServer para não aguardar um encerramento bem-sucedido do processo de servidor.
- -quiet
- Suprime as informações de progresso que o comando stopServer imprime no modo normal.
- -logfile <Nome_do_arquivo>
- Especifica o local do arquivo de log no qual as informações de rastreio são gravadas. Por padrão, o arquivo de log é denominado stopServer.log e é criado no diretório logs.
- -profileName
- Define o perfil do processo do servidor em uma instalação de vários perfis. A opção -profileName não é requerida para execução em um ambiente de perfil único. O padrão para essa opção é o perfil padrão.
- -replacelog
- Substitui o arquivo de log ao invés de anexar o log atual.
- -trace
- Gera informações de rastreio em um arquivo para propósitos de depuração. A saída de rastreio é gravada no arquivo stopServer.log que está localizado no diretório profile_root/logs/server.
- -timeout <seconds>
- Especifica o tempo de espera para o encerramento do servidor antes do tempo limite e retorna um erro.
- -statusport <Número_da_porta>
- Um parâmetro opcional que permite que um administrador configure o número de porta para o retorno de chamada de status do servidor. A ferramenta abre essa porta e aguarda pelo retorno de chamada de status do servidor imediatamente antes do servidor ser parado. Se o parâmetro não estiver configurado, uma porta não utilizada será automaticamente alocada.
- -conntype <tipo>
- Especifica o tipo de conector JMX a ser utilizado para conexão com o gerenciador de implementação. Os tipos válidos são SOAP ou RMI (Remote Method Invocation).
- -port <número_da_porta>
- Especifica a porta JMX do servidor para usar explicitamente, para que você pode evitar a leitura dos arquivos de configuração para obter as informações.
- -username <nome>
- Especifica o nome de usuário para autenticação, caso a segurança esteja ativada. Age da mesma forma que a opção -user.
- -user <nome>
- Especifica o nome de usuário para autenticação, caso a segurança esteja ativada. Age da mesma forma que a opção -username.
- -password <password>
- Especifica a senha para autenticação se a segurança estiver ativada no servidor.
Evitar Problemas: Se você estiver executando em um ambiente seguro, mas não tiver fornecido um ID do usuário e senha, você receberá a seguinte mensagem de erro:
Para solucionar esse problema, forneça as informações de ID do usuário e senha.gotchaADMN0022E: Acesso negado para a operação stop no Server MBean devido a credenciais insuficientes ou vazias.
- -help
- Imprime uma instrução de uso.
- -?
- Imprime uma instrução de uso.
Cenário de uso
Os exemplos a seguir demonstram a sintaxe correta:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
stopServer server1
stopServer server1 -nowait
stopServer server1 -trace (produz o arquivo stopserver.log)
stopServer adminagent
stopServer jobmgr
stopServer proxy1 (para o perfil de proxy seguro)
![[IBM i]](../images/iseries.gif)
stopServer server1 (pára o servidor server1 para o perfil padrão)
stopServer server1 -nowait
stopServer server1 -trace (produz o arquivo stopserver.log)
stopServer -profileName mytest (pára o servidor mytest
configurado para o perfil mytest)
stopServer AdminAgent01
stopServer JobMgr01
stopServer proxy1 (nome do servidor padrão para o perfil SecureProxySrv01)