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.

z/OS platform 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 executa as ações a seguir:

  • O comando verifica se o ambiente do broker está configurado corretamente; por exemplo, se o nível de Java™ instalado é suportado.
  • O comando verifica se as filas do WebSphere MQ estão definidas e acessíveis.
  • Linux platform UNIX platform Início da mudança Nos sistemas Linux e UNIX, o comando verifica se o ambiente ODBC (se especificado) está configurado corretamente.
    Se a variável de ambiente ODBCINI estiver configurada, o comando mqsicvp gravará mensagens de aviso no syslog nestas circunstâncias:
    • Se o arquivo para o qual a variável de ambiente ODBCINI aponta não existir, ou o broker não tiver acesso para lê-lo ou gravar nele
    • Se ODBCSYSINI não estiver configurada
    • Se ODBCSYSINI estiver configurada, mas o diretório para o qual essa variável aponta não contiver um arquivo chamado odbcinst.ini, ou o broker não tiver acesso para ler esse arquivo ou gravar nele
    • Se a variável de ambiente IE02_PATH não estiver configurada
    Fim da mudança
  • Linux platform UNIX platform Início da mudança Nos sistemas Linux e UNIX, se a verificação do ambiente ODBC for bem-sucedida, o comando se conectará a todas as origens de dados listadas nos arquivos odbc.ini e que foram associadas ao broker usando o comando mqsisetdbparms. Fim da mudança

Uso do comando para fornecer informações sobre origens de dados do usuário

Chamadas extras do comando mqsicvp fornecem função de ferramenta de teste ODBC. Essa função oferece informações úteis sobre uma origem de dados do usuário, ou compara duas origens de dados do usuário para obter equivalência. Essas chamadas do comando são distintas da chamada básica do comando mqsicvp e não são executadas na inicialização do broker.

Ao usar o comando mqsicvp como uma ferramenta de teste do ODBC, o comando emite uma mensagem informativa no caso de uma 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 no caso de uma conexão bem-sucedida com essa origem de dados, com as mesmas informações sobre a origem de dados secundária e informando que uma comparação será feita.

Quando a ferramenta é executada com relação a uma origem de dados, ela faz diversas verificações na interface ODBC para determinar quais tipos de dados e funções são suportados, 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.

Quando esses testes são executados com relação a duas origens de dados, eles serão executados em ambas as origens de dados e ambos os conjuntos de resultados são mostrados. Uma mensagem informativa final informa se as duas origens de dados são equivalentes e elegíveis para serem usadas no mesmo nó de processamento de mensagem; para obter informações adicionais, consulte Acessando Bancos de Dados do ESQL.

Sintaxe

Início da mudança
Quando você executa o comando mqsicvp com apenas o nome do broker e nenhum outro parâmetro, o comando conclui as verificações a seguir:
  • 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.
  • Linux platform UNIX platform Somente nos sistemas Linux e UNIX, o comando verifica se o ambiente ODBC (se especificado) está configurado corretamente. Se a variável de ambiente ODBCINI não estiver configurada, a verificação do ambiente ODBC será ignorada. Se a verificação do ambiente ODBC for concluída com êxito, o comando então tentará se conectar a todas as origens de dados que estão listadas nos arquivos odbc.ini onde o comando mqsisetdbparms foi utilizado para associar a origem de dados ao broker.
Fim da mudança
Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsicvp--brokername-----------------------------------------><

Sintaxe

Chamada que usa nomes completos de origem de dados

Início da mudança Quando você executa o comando mqsicvp com os parâmetros mostrados no diagrama de sintaxe a seguir, o comando fornece a função de ferramenta de teste ODBC. É possível utilizar o comando para exibir informações úteis sobre uma origem de dados do usuário, ou comparar duas origens de dados do usuário. Somente nos sistemas Linux e UNIX, as chamadas do comando que usam esses parâmetros também verificam se o ambiente ODBC (se especificado) está configurado corretamente. Nesses casos, o comando verifica se as variáveis ODBCINI, ODBCSYSINI e IE02_PATH estão configuradas. Fim da mudança

Cada nome de origem de dados (DSN) é especificado totalmente com um nome de usuário e uma 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.

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsicvp-- -n--primaryDatasourceName-------------------------->

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

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

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

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

Sintaxe

Chamada na qual 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 essa chamada com êxito, você deve primeiro executar o comando mqsisetdbparms para identificar um ID e senha de usuário específicos para o broker a serem usados na conexão com a origem de dados. A saída dessa chamada é a mesma da saída da chamada que usa nomes de origem de dados totalmente especificados.

Linux platform UNIX platform Início da mudança Somente nos sistemas Linux e UNIX, as chamadas do comando que usam os parâmetros no diagrama de sintaxe a seguir também verificam se o ambiente ODBC (se especificado) está configurado corretamente. Nesses casos, o comando verifica se as variáveis ODBCINI, ODBCSYSINI e IE02_PATH estão configuradas. Fim da mudança

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsicvp--brokername-- -n--primaryDatasource------------------>

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

Parâmetros

brokername
(Necessário - se você estiver usando uma chamada que contém brokername.) Especifique um nome de broker a ser verificado ou o nome do broker ao qual primaryDatasource está associado.

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

-n primaryDatasource
(Necessário se você estiver usando uma chamada que contém primaryDatasource.) O nome da conexão ODBC a ser verificado.
-u primaryDatasourceUserId
(Necessário se você não associou anteriormente o nome da origem de dados ao broker.) O nome do usuário com o qual conectar-se ao primaryDatasource.
-p primaryDatasourcePassword
(Necessário se você não associou anteriormente o nome da origem de dados ao broker.) A senha usada com o primaryDatasourceUserId.
-c secondaryDatasource
(Opcional) Se duas origens de dados estiverem sendo comparadas para obter equivalência, esta origem de dados será o segundo nome de conexão ODBC.
-i secondaryDatasourceUserId
(Opcional) O nome de usuário com o qual conectar-se ao secondaryDatasource.
-a secondaryDatasourcePassword
(Opcional) A senha usada com o secondaryDatasourceUserId.
-v
(Opcional) Esse parâmetro faz com que informações extras, não traduzidas, de diagnóstico que estão relacionadas aos CASTS suportados sejam mostradas pelo comando.

Autorização

Para obter informações sobre autorizações que são específicas dos sistemas operacionais, consulte os tópicos a seguir: Se você tiver ativado a segurança de administração do broker, também deverá configurar a autoridade descrita em Tarefas e Autorizações para Segurança de Administração.

Respostas

  • BIP8040W: Nenhum acesso ao banco de dados (impossível se conectar).
  • BIP8267W: Aviso; pode haver problemas ao usar esta origem de dados. Para obter mais informações, consulte as mensagens anteriores.
  • BIP8268I: As duas origens de dados fornecidas são compatíveis e podem ser usadas no mesmo nó de Cálculo.
  • BIP8269W: As duas origens de dados fornecidas não são compatíveis e não devem ser usadas no mesmo nó de Cálculo.
  • BIP8270I: Conectado à origem de dados <inserções múltiplas>
  • BIP8271I: Conectado à segunda origem de dados <inserções múltiplas> para comparação.
  • BIP8272W: A origem de dados especificada não está associada ao broker.
  • BIP8273I: Os tipos de dados e funções a seguir não são nativamente suportados pela origem de dados '&1': <inserções múltiplas>
  • BIP8274W: Os tipos de dados e funções a seguir podem causar problemas ao usar a origem de dados '&1' com o WebSphere Message Broker: <inserções múltiplas>
  • Início da mudança BIP8288W: Não é possível ler o arquivo ODBCINI 'file_name'. Verifique se este arquivo existe e se o ID do usuário do broker tem permissão para ler e gravar este arquivo. Fim da mudança
  • Início da mudança BIP8289W: Não é possível ler o arquivo ODBCSYSINI no diretório especificado 'directory_name'. Verifique se este arquivo existe e se o ID do usuário do broker tem permissão para ler e gravar este arquivo. Fim da mudança
  • Início da mudança BIP8290I: Verificação aprovada para o ambiente ODBC. Fim da mudança
  • Início da mudança BIP8291W: A variável de ambiente IE02_PATH não está configurada. Fim da mudança
  • Início da mudança BIP8292I: As origens de dados do usuário 'insert1' não foram verificadas porque não têm credenciais mqsisetdbparms. Fim da mudança
  • Início da mudança BIP8294I: A verificação do ambiente ODBC foi ignorada porque a variável de ambiente ODBCINI não está configurada. Fim da mudança
  • Início da mudança BIP8295E: as variáveis de ambiente ODBCINI não foram configuradas ou são inválidas. Fim da mudança
  • Início da mudança BIP8296W: A variável de ambiente ODBCSYSINI não está configurada. Fim da mudança
  • Início da mudança BIP8297W: 'environment_variable_name' arquivo 'file_name' está vazio. Fim da mudança
  • BIP8873I: Iniciando a verificação do componente para o broker 'broker_name'.
  • BIP8874I: A verificação de componente para 'broker_name' foi concluída com sucesso.
  • BIP8875W: A verificação de componente para 'broker_name' foi concluída, mas uma ou mais verificações falharam.
  • BIP8876I: Iniciando a verificação do ambiente para o broker 'broker_name'.
  • BIP8877W: A verificação de ambiente para o broker 'broker_name' foi concluída, mas uma ou mais verificações falharam.
  • BIP8878I: A verificação de 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: A verificação foi aprovada 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 o 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 o 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 verificações no broker denominado: MB8BROKER
mqsicvp MB8BROKER
O nome da origem de dados (DSN) MyDB é associado ao broker MB8BROKER usando o comando mqsisetdbparms:
mqsicvp MB8BROKER -n MyDB
O DSN MyDB é comparado com um DSN MyDB2 secundário associado ao broker MB8BROKER usando o comando mqsisetdbparms:
mqsicvp MB8BROKER -n MyDB -c MyDB2
O DSN completo MyDB é comparado com um DSN MyDB2 completo secundário usando IDs de usuário e senha 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, 2013Copyright IBM Corporation 1999, 2013.

        
        Última atualização:
        
        Última atualização: 2013-09-23 05:07:50


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.3 | bn07236_