Comando mqsicvp

Use o comando mqsicvp para executar testes de verificação em um broker.

Plataformas Suportadas

  • Windows
  • Sistemas Linux e UNIX

Quando você inicia um broker usando o comando mqsistart, esse comando é executado automaticamente para verificar o componente.

No z/OS®, os mesmos procedimentos de verificação são executados automaticamente quando você inicia um broker.

É possível executar esse comando em um broker que está ou não em execução. Se o broker não estiver em execução, os testes de verificação serão executados, mas o broker não será iniciado.

Propósito

O comando mqsicvp:

  • Verifica se o ambiente do broker está configurado corretamente; por exemplo, se o nível de Java instalado é suportado.
  • Verifica se as filas do WebSphere® MQ estão definidas e acessíveis.

O comando mqsicvp conclui todas estas verificações e falhará se uma ou mais verificações falharem. Ele relata todos os erros no log do sistema ou na linha de comandos, ou em ambos.

Usando o Comando para Fornecer Informações Relacionadas às Origens de Dados do Usuário

Chamadas extras do comando mqsicvp foram incluídas para fornecer a função Ferramenta de Teste de ODBC que:
  • Fornece informações úteis e diagnósticos sobre uma origem de dados do usuário ou
  • Compara duas origens de dados do usuário para equivalência.
Observe que estas chamadas são diferentes da chamada existente do comando mqsicvp e não são executadas na inicialização do broker.

Entretanto, a chamada existente, e a inicialização do broker, também foram aprimoradas nos sistemas Linux e UNIX, para incorporar esta função de teste ODBC para novas origens de dados do usuário que foram associadas ao broker, ao usar o WebSphere Message Broker Database Extender SupportPac para conectividade do banco de dados, juntamente com o comando mqsisetdbparms.

Ao usar o comando mqsicvp como uma Ferramenta de Teste de ODBC, o comando emite uma mensagem informativa na conexão bem-sucedida, fornecendo o nome da origem de dados, o tipo de banco de dados e a versão. Se uma origem de dados secundária for fornecida, o comando mqsicvp emitirá uma segunda mensagem informativa na conexão bem-sucedida com essa origem de dados, com as mesmas informações concernentes à origem de dados secundária e informando que uma comparação deve ser executada.

Ao executar em uma origem de dados, a ferramenta executa várias verificações na interface ODBC para averiguar quais tipos de dados e funções são suportados, juntamente com informações sobre os nomes e tamanhos desses tipos de dados. Se quaisquer tipos de dados ou funções não forem suportados, eles serão resumidos em uma mensagem informativa final.

Ao executar em duas origens de dados, esses mesmos testes são executados em ambas as origens de dados e ambos os resultados são exibidos na tela. Uma mensagem informativa final o informa se as duas origens de dados são equivalentes e elegíveis para serem usadas no mesmo nó de processamento de mensagem; consulte Acessando Bancos de Dados do ESQL para obter informações adicionais.

Sintaxe

Chamada Existente

Read syntax diagramSkip visual syntax diagram
>>-mqsicvp--brokername-----------------------------------------><

Sintaxe

Nova Chamada Usando Nomes de Origem de Dados Totalmente Especificados

Cada Nome da Origem de Dados (DSN) é totalmente especificado com um nome de usuário e senha.

Essa chamada não depende de uma associação entre o broker e a origem de dados, e retorna informações sobre a origem de dados mesmo quando não há associação com um broker.

Read syntax diagramSkip visual syntax diagram
>>-mqsicvp-- -n--primaryDatasourceName-------------------------->

>-- -u--primaryDatasourceUserId--------------------------------->

>-- -p--primaryDatasourcePassword------------------------------->

>--+------------------------------------------------------------------------------------------------+-->
   '- -c--secondaryDatasourceName-- -i--secondaryDatasourceUserId-- -a--secondaryDatasourcePassword-'   

>--+-----+-----------------------------------------------------><
   '- -v-'   

Sintaxe

Nova Chamada em que Nomes de Origem de Dados foram Associados ao Broker

Essa chamada requer uma associação entre o broker e o nome da origem de dados (DSN). Para usar com êxito essa chamada, você deve primeiro executar o comando mqsisetdbparms para identificar um ID e senha de usuário específicos para o broker a serem usados ao conectar-se à origem de dados. A saída dessa chamada é a mesma da saída da chamada que usa nomes de origem de dados totalmente especificados.

Read syntax diagramSkip visual syntax diagram
>>-mqsicvp--brokername-- -n--primaryDatasource------------------>

>--+--------------------------+--+-----+-----------------------><
   '- -c--secondaryDatasource-'  '- -v-'   

Parâmetros

brokername
(Necessário - se você estiver usando uma chamada contendo brokername) Especifique um nome do broker para verificação ou o nome do broker ao qual primaryDatasource está associado.

Linux platformUNIX platform Todos os nomes fazem distinção entre maiúsculas e minúsculas em sistemas Linux e UNIX.

-n primaryDatasource
(Necessário se estiver usando uma chamada contendo primaryDatasource) Nome da conexão ODBC para verificação.
-u primaryDatasourceUserId
(Obrigatório se você não tiver associado anteriormente o nome da origem de dados ao broker) Nome do usuário com o qual conectar-se ao primaryDatasource.
-p primaryDatasourcePassword
(Obrigatório se você não tiver associado anteriormente o nome da origem de dados ao broker) Senha usada com primaryDatasourceUserId.
-c secondaryDatasource
(Opcional) Se duas origens de dados estiverem sendo comparadas para equivalência, este é o segundo nome de conexão ODBC.
-i secondaryDatasourceUserId
(Opcional) Nome de usuário com o qual se conectar ao secondaryDatasource.
-a secondaryDatasourcePassword
(Opcional) Senha usada com o secondaryDatasourceUserId.
-v
(Opcional) Causa diagnósticos extras não traduzidos, relacionados aos CASTS suportados a serem enviados pelo comando.

Autorização

Em todos os sistemas Windows, você deve executar esse comando como o ID de usuário que está definido como o ID de usuário de serviço do broker. Você especificou o ID de usuário de serviço no parâmetro -i quando criou o broker usando o comando mqsicreatebroker.

Portanto, no Windows Vista e Windows Server 2008, o ID do usuário do serviço deve ser um membro do grupo Administradores se você executar este comando.

Nos sistemas Linux e UNIX, execute esse comando como o ID de usuário com o qual você iniciou, ou iniciará o broker usando o comando mqsistart.

Respostas

  • BIP8040W: Sem acesso ao banco de dados (impossível conectar-se)
  • BIP8267W: Aviso. Pode haver problemas ao usar esta origem de dados. Consulte a preceding messages para obter informações adicionais.
  • BIP8268I: As duas origens de dados fornecidas são compatíveis e podem ser usadas no mesmo nó Cálculo.
  • BIP8269W: As duas origens de dados fornecidas não são compatíveis e não devem ser usadas no mesmo nó Cálculo.
  • BIP8270I: Conectado à origem de dados <..múltiplas inserções..>
  • BIP8271I: Conectado à segunda origem de dados <..múltiplas inserções..> para comparação.
  • BIP8272W: A origem de dados especificada não está associada ao broker.
  • BIP8273I: Os seguintes tipos de dados e funções não são nativamente suportados pela origem de dados '&1': <..múltiplas inserções..>
  • BIP8274W: Os tipos de dados e funções a seguir podem causar problemas ao usar a origem de dados '&1' com WebSphere Message Broker: <..múltiplas inserções..>
  • BIP8873I: Iniciando a verificação do componente para o broker 'broker_name'.
  • BIP8874I: A verificação do componente para 'broker_name' foi concluída com sucesso.
  • BIP8875W: A verificação do componente para 'broker_name' foi conluída, mas uma ou mais verificações falharam.
  • BIP8876I: Iniciando a verificação do ambiente para o broker 'broker_name'.
  • BIP8877W: A verificação do ambiente para o broker 'broker_name' foi concluída, nas uma ou mais verificações falharam.
  • BIP8878I: A verificação do ambiente para o broker 'broker_name' foi concluída com sucesso.
  • BIP8882I: Iniciando a verificação do WebSphere MQ para o broker 'broker_name'.
  • BIP8883W: A verificação do WebSphere MQ para o broker 'broker_name' foi concluída, mas uma ou mais verificações falharam.
  • BIP8884I: A verificação do WebSphere MQ para o broker 'broker_name' foi concluída com sucesso.
  • BIP8885E: A verificação falhou. Falha ao conectar-se ao gerenciador de filas 'queue_manager_name'. MQRC: return_code MQCC: completion_code
  • BIP8886I: Verificação bem-sucedida para a fila 'queue_name' no gerenciador de filas 'queue_manager_name'.
  • BIP8887E: A verificação falhou para a fila 'queue_name' no gerenciador de filas 'queue_manager_name' ao emitir 'operation'. MQRC: return_code MQCC: completion_code
  • BIP8888E: A verificação falhou. Falha ao desconectar-se do gerenciador de filas 'queue_manager_name'. MQRC: return_code MQCC: completion_code
  • BIP8892E: A verificação falhou. O nível Java instalado 'level_installed' não atende o nível Java necessário 'level_supported'.
  • BIP8893E: A verificação falhou para a variável de ambiente 'variable_name'. Não é possível acessar o arquivo 'file_name' com o ID do usuário 'user_ID'. Informações adicionais para suporte IBM®: data1 data2.
  • BIP8894I: A verificação foi aprovada para 'broker_name'.
  • BIP8895E: A verificação falhou. A variável de ambiente 'variable_name' está incorreta ou ausente.
  • BIP8896E: A verificação falhou. Não é possível acessar o registro com o ID do usuário 'user_ID'. Informações adicionais para suporte IBM: data1 data2
  • BIP8897E: A verificação falhou. A variável de ambiente 'variable_name' não corresponde ao nome do broker 'broker_name'.
  • BIP8900I: Verificação de Autorização de APF bem-sucedida para o arquivo 'file_name'.
  • BIP8903E: A verificação falhou. A verificação de Autorização de APF para o arquivo 'file_name' falhou.
  • BIP8904E: A verificação falhou. Falha ao emitir stat no arquivo 'file_name1' com o código de retorno 'return_code' e número do erro 'error_number'.

Exemplos

Execute os testes de verificação no broker denominado MB8BROKER:
mqsicvp MB8BROKER
O Nome da Origem de Dados (DSN) MyDB está associado ao broker MB8BROKER usando o comando mqsisetdbparms:
mqsicvp MB8BROKER -n MyDB
DSNMyDB é comparado com relação a um DSN secundário MyDB2 associado ao broker MB8BROKER usando o comando mqsisetdbparms:
mqsicvp MB8BROKER -n MyDB -c MyDB2
O DSN completo MyDB é comparado com um DSN completo secundário MyDB2 usando os IDs do usuário e senhas primários e secundários:
mqsicvp –n MyDB –u username –p password –c MyDB2 –i username2 –a password2
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:04:21


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.1 | an07235_