Comando mqsistop

Plataformas Suportadas

  • Windows
  • Sistemas Linux e UNIX
  • z/OS

Finalidade

Utilize o comando mqsistop para parar um componente do WebSphere Message Broker.No z/OS o controlador deve estar em execução.

Início da mudançaA tabela a seguir distingue entre os comandos stop (/P) e stopcomponent e lista as opções disponíveis:
  • Utilize o comando stop (/P) para colocar um componente em um estado no qual é possível executar o comando change apropriado.
  • utilize o comando stopcomponent para parar um intermediário, o Configuration Manager ou o Servidor de Nome de Usuário quando seu controlador (processo de controle) já está em execução.
Componente Comando Descrição
Intermediário
  • /P <nomeDoIntermediário>
  • /F <nomeDoIntermediário>,P
  • /F <nomeDoIntermediário>,PC
  • Parar o intermediário.
  • Parar o intermediário; é o mesmo que /P. Também é possível utilizar /F <nomeDoIntermediário>,STOP
  • Parar o componente do intermediário. Isso p[ara o processo do intermediário (incluindo qualquer espaço de endereço de grupo de execução), mas deixa o servidor de comandos do console do intermediário de mensagem em execução no espaço de endereço do controlador. Isso permite executar o comando de console Comando mqsichangebroker. Reinicie o intermediário posteriormente executando o comando de console Comando mqsistart (SC).
Configuration Manager
  • /P <nomeDoGerDeConfig>
  • /F <nomeDoGerDeConfig>,P
  • /F <nomeDoGerDeConfig>,PC
  • Pare a Configuration Manager.
  • Parar o Configuration Manager; isso é o mesmo que /P. Você também pode utilizar /F <configMgrName>,STOP
  • Parar o componente do Configuration Manager. Isso pára o processo do Configuration Manager, mas deixa o servidor de comandos do console do intermediário de mensagem em execução no espaço de endereço do controlador. Isso permite executar o comando de console Comando mqsichangeconfigmgr. Reinicie o intermediário posteriormente executando o comando de console Comando mqsistart (SC).
Servidor de Nome de Usuário
  • /P <Servidor de Nome de UsuárioName>
  • /F <Servidor de Nome de Usuário>,P
  • /F <Servidor de Nome de Usuário>,PC
  • Pare a Servidor de Nome de Usuário.
  • Parar o Servidor de Nome de Usuário; isso é o mesmo que /P. Você também pode utilizar /F <Servidor de Nome de Usuário>,STOP
  • Parar o componente do Servidor de Nome de Usuário. Isso pára o processo do Servidor de Nome de Usuário, mas deixa o servidor de comandos do console do intermediário de mensagem em execução no espaço de endereço do controlador. Isso permite executar o comando de console Comando mqsichangeusernameserver. Reinicie o intermediário posteriormente executando o comando de console Comando mqsistart (SC).
Fim da mudança

Sintaxe

Plataformas Windows, Sistemas Linux e UNIX

z/OS

Sinônimo: pc

Parâmetros

componente
(Obrigatório - sistemas Windows, Linux e UNIX) Deve ser um nome de intermediário, um nome do Gerenciador de Configuração ou um dos seguintes valores fixos:
  • UserNameServer ou DatabaseInstanceMgr em plataformas Windows
  • UserNameServer nos sistemas Linux e UNIX
Todos os nomes fazem distinção entre maiúsculas e minúsculas em sistemas Linux e UNIX.

Não utilize esse comando em um DatabaseInstanceMgr, a menos que esteja utilizando o banco de dados Derby.

-q
(Opcional - Apenas sistemas Windows, Linux e UNIX) Pare o gerenciador de filas do WebSphere MQ associado a esse componente doWebSphere Message Broker.

Especifique esse sinalizador apenas se o componente do WebSphere Message Broker for o último (ou único) componente ativo do WebSphere Message Broker nesse gerenciador de filas. Esse comando inicia um encerramento controlado do gerenciador de filas e informará a outros usuários do gerenciador que ele está sendo fechado.

Se você não parar os outros componentes do WebSphere Message Broker que utilizam esse gerenciador de filas antes de emitir esse comando com essa opção, pare-os posteriormente ou inicie o gerenciador novamente.

Se você utilizar essa opção, lembre-se de que qualquer listener associado a esse gerenciador de filas não será parado com ele. Pare-os manualmente depois de emitir esse comando.

-i
(Opcional) Pára imediatamente o intermediário.

Especifique esse sinalizador apenas se já tiver tentado e falhado parar o intermediário em um modo controlado utilizando o mqsistop sem o sinalizador -i.

No z/OS, esse comando será rejeitado pelo servidor de comandos do console do Broker de Mensagens, se um comando de parada anterior não conseguir ser concluído. Isso pode ocorrer, por exemplo, se um ou mais espaços de endereço do grupo de execução não puder ser encerrado.

Autorização

Em plataformas Windows, o ID do usuário utilizado para chamar esse comando deve pertencer ao grupo de Administradores.

Em sistemas Linux e UNIX, o ID do usuário utilizado para chamar esse comando deve adequar-se aos seguintes requisitos:
  • Ele também deve ser membro do grupo mqbrkrs.
  • O ID do usuário deve ser raiz ou o mesmo especificado no parâmetro -i quando o componente foi criado.
  • Se você especificar o parâmetro -q, o ID do usuário deverá ser um membro do grupo mqm.

Os requisitos de segurança para utilizar esse comando são resumidos em Requisitos de Segurança para Plataformas Windows e Requisitos de Segurança para Plataformas Linux e UNIX.

Respostas

Apenas sistemas Windows, Linux e UNIX:
  • BIP8012 Impossível conectar aos componentes do sistema
  • BIP8013 O componente não existe
  • BIP8016 O componente não pode ser parado
  • BIP8019 Componente parado
  • BIP8030 Incapaz de modificar os privilégios do usuário
  • BIP8049 Incapaz de parar o gerenciador de filas
  • BIP8093 Gerenciador de filas sendo criado
  • BIP8094 Gerenciador de filas parando

Exemplos

Windows
Para parar um gerenciador de Instância do Banco de Dados:
mqsistop DatabaseInstanceMgr
Sistemas Windows, Linux e UNIX.
Para parar o intermediário, mybroker e o gerenciador de filas WebSphere MQ associado a ele:
mqsistop mybroker -q
z/OS
Para parar um intermediário chamado MQ00BRK:
F MQ00BRK,pc
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an07240_