WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Comando mqsicvp

Utilize o comando mqsicvp para executar testes de verificação em um broker, ou para verificar conexões ODBC.

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 platformNo 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.

Finalidade

O comando mqsicvp conclui 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 platformUNIX platformNos 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 se o broker não tiver acesso para lê-lo ou gravar nele
    • Se o ODBCSYSINI não estiver configurado
    • 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
  • Linux platformUNIX platformNos sistemas Linux e UNIX, se a verificação de ambiente ODBC for bem-sucedida, o comando se conectará a todas as origens de dados listadas nos arquivos odbc.ini e que estavam associadas ao broker usando o comando mqsisetdbparms.

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

Chamada para verificar o broker

Quando você executar o comando mqsicvp apenas com o nome do broker, e nenhum outro parâmetro, o comando executará as verificações a seguir:
  • Verifica se o ambiente do broker está configurado corretamente (por exemplo, o nível instalado de Java é suportado).
  • Verifica se as filas do WebSphere MQ estão definidas e acessíveis.
  • Linux platformUNIX platformNos sistemas Linux e UNIX apenas, o comando verifica se o ambiente ODBC (se especificado) está configurado corretamente. Se a variável de ambiente IE02_PATH não estiver configurada, a verificação do ambiente ODBC será ignorada. Se a verificação do ambiente ODBC for concluída com sucesso, então o comando tentará se conectar a todas as origens de dados listadas nos arquivos odbc.ini em que o comando mqsisetdbparms foi usado para associar a origem de dados ao broker.
Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsicvp--brokername-----------------------------------------><

Sintaxe

Chamada na qual os nomes da origem de dados não foram associados ao broker

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 do ODBC. É possível usar o comando para exibir informações úteis sobre uma origem de dados do usuário ou comparar duas origens de dados do usuário. Nos sistemas Linux e UNIX apenas, 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.

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--primaryDatasource------------------------------>

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

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

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

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

Sintaxe

Chamada em que Nomes de Origem de Dados Estavam 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 na qual nomes de origem de dados não foram associados ao broker.

Ao utilizar o comando mqsisetdbparms, você pode especificar o nome da origem de dados diretamente ou incluir um dos seguintes prefixos:
  • dsn::
  • odbc::
Esses prefixos identificam o tipo de identidade que está sendo criado no mqsisetdbparms e devem ser omitidos ao usar esta identidade como a origem de dados no mqsicvp. Por exemplo:
  • mqsisetdbparms MB7BROKER -n dsn::myDsn -u username -p password
  • mqsicvp MB7BROKER -n myDsn
Se você utilizar mqsisetdbparms para configurar uma identidade de nível do grupo de execução para uma origem de dados, a identidade não pode ser utilizada no mqsicvp. Além disso, o mqsicvp não pode utilizar um ID do usuário e senha padrão configurados para todas as origens de dados.

Linux platformUNIX platformNos sistemas Linux e UNIX apenas, 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.

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 platformUNIX platformTodos 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 específicas a 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: Sem acesso ao banco de dados (impossível conectar-se)
  • 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>
  • 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 o arquivo.
  • 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 o arquivo.
  • BIP8290I: Verificação aprovada para o ambiente ODBC.
  • BIP8291W: A variável de ambiente IE02_PATH não está configurada.
  • BIP8292I: As origens de dados do usuário 'insert1' não foram verificadas, porque não possuem credenciais do mqsisetdbparms.
  • BIP8294I: A verificação do ambiente ODBC foi ignorada porque a variável de ambiente ODBCINI não está configurada.
  • BIP8295E: As variáveis de ambiente ODBCINI não estavam configuradas ou são inválidas.
  • BIP8296W: A variável de ambiente ODBCSYSINI não está configurada.
  • BIP8297W: 'environment_variable_name' o arquivo 'file_name' está vazio.
  • 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, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:31:33


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