Comando mqsicvp
Use o comando mqsicvp para executar testes de verificação em um nó de integração ou servidor de integração independente para verificar ODBCe para executar o processamento de referência da CPU.
Plataformas Suportadas
- Windows
- Linux®
- AIX®
- IBM® z/OS® Extensões de contêineres ( zCX ). Execute esse comando modificando e enviando o JCL fornecido ou usando um comando de console IBM z/OS.
mqsistart INODEPara obter mais informações, consulte o comando mqsistart e o comando mqsistart - plataformas Windows, Linux e AIX.Você pode executar o comando mqsicvp em um nó de integração ou em um servidor de integração independente. O nó de integração ou servidor deve ser interrompido se ele usar um cofre.
Propósito
O comando mqsicvp conclui as seguintes ações:
- O comando verifica se o ambiente para o nó de integração ou servidor de integração independente é configurado corretamente; por exemplo, que o nível instalado de Java™ é suportado.

Sobre Linux e AIX o comando verifica se o ambiente ODBC (se especificado) está configurado corretamente.Se a variável de ambiente ODBCINI for configurada, o comando mqsicvp escreve mensagens de aviso para o syslog nas seguintes circunstâncias:- Se o arquivo para o qual a variável de ambiente ODBCINI aponta não existir, ou o nó de integração não tiver acesso para lê-lo ou gravar nele
- Se o ODBCSYSINI não estiver configurado
- Se ODBCSYSINI estiver configurado, mas o diretório para o qual esses pontos de variáveis não contêm um arquivo denominado odbcinst.iniou o nó de integração não tiver acesso para ler ou gravar nesse arquivo
- Se a variável de ambiente IE02_PATH não estiver configurada

Sobre Linux e AIX se a verificação do ambiente ODBC for bem-sucedida, o comando se conectará a todas as fontes de dados listadas nos arquivos odbc.ini e que foram associadas ao nó de integração usando o comando mqsisetdbparms . Exemplo:
Para obter mais informações, consulte o comando mqsisetdbparms.mqsisetdbparms INODE -n USERDB1 -u myuserid1 -p mypassword1

No Windows, Linux e AIX o comando pode ser executado para realizar o processamento de benchmark no sistema, de modo que o desempenho esperado possa ser comparado entre dois ou mais sistemas.
Uso do Comando para Fornecer Informações sobre Origens de Dados do Usuário
As origens de dados que estão descritas são aqueles que você definiu ao configurar o banco de dados ODBC. Consulte Habilitação de conexões ODBC com os bancos de dados.
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 invocações do comando são discretas a partir da chamada básica do comando mqsicvp , e não são executadas na inicialização do nó de integração.
Quando você usa o comando mqsicvp como uma ferramenta de teste ODBC , o comando emite uma mensagem informativa para uma conexão bem-sucedida, fornecendo o nome da fonte de dados, tipo de banco de dados e versão. Se uma fonte de dados secundária for fornecida, o comando mqsicvp emite uma segunda mensagem informativa para uma conexão bem-sucedida a essa fonte de dados, com as mesmas informações sobre a origem de dados secundários, 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 fontes de dados são equivalentes e elegíveis para serem usadas no mesmo nó de processamento de mensagens. Para obter mais informações, consulte Acesso a bancos de dados a partir do ESQL.
Sintaxe 1: Verificação de um nó de integração
- Verifica se o ambiente do nó de integração é configurado corretamente (por exemplo, o nível instalado de Java é suportado).
- Se um gerenciador de filas padrão estiver configurado, o comando verifica se o gerenciador de filas IBM MQ está acessível.

Sobre Linux e AIX 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 sucesso, o comando então tenta se conectar a todas as fontes de dados que estão listadas nos arquivos odbc.ini onde o comando mqsisetdbparms ou mqsicredentials foi usado para associar a origem de dados ao nó de integração.
Parâmetros para a Sintaxe 1: Verificação de um nó de integração
- integrationNodeName
- Nome de um nó de integração definido localmente.
- -e |--integration-server integrationServerName
- Nome do servidor de integração. (Necessário se estiver usando o vault e o benchmark).
- --vault-key arg
- (Opcional). A chave do cofre a ser usada para acessar o cofre que é de propriedade do nó de integração ou do servidor de integração. Não há suporte para cofres de diretórios externos.
- --vaultrc-location directoryPath
- (Opcional). O caminho do diretório para o arquivo .mqsivaultrc que é usado para localizar a chave do vault. Não há suporte para cofres de diretórios externos.
- --trace traceFileName
- Enviar rastreio interno detalhado para o arquivo especificado.
Exemplos de sintaxe 1: verificação de um nó de integração
mqsicvp INODESintaxe 2: Verificação de uma fonte de dados do usuário a ser usada em um nó de integração
Essa chamada requer uma associação entre o nó de integração e o nome da origem de dados (DSN). Para usar com sucesso esta chamada, você deve primeiro executar o comando mqsisetdbparms ou mqsicredentials para identificar um ID e senha de usuário específicos para o nó de integração a ser usado ao se conectar à origem de dados. O resultado dessa invocação é o mesmo que o resultado da invocação em que os nomes das fontes de dados não estão associados ao nó de integração.
Ao usar o comando mqsisetdbparms ou mqsicredentials , você pode especificar o nome da fonte de dados diretamente ou adicionar o prefixo odbc::.
mqsisetdbparms INODE -n odbc::myDsn -u username -p passwordmqsicvp INODE -n myDsnSe você usa mqsisetdbparms para configurar uma identidade de nível de servidor de integração para uma fonte de dados, a identidade não pode ser usada em mqsicvp.Para obter mais informações, consulte a seção " ODBC Nomes de fontes de dados" no comando mqsicredentials ou no comando mqsisetdbparms.

Sobre Linux e AIX as invocações 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.
Parâmetros para a Sintaxe 2: Verificação de uma fonte de dados do usuário a ser usada em um nó de integração
- integrationNodeName
- Nome de um nó de integração definido localmente.
- --integration-server integrationServerName
- Nome do servidor de integração. (Necessário se estiver usando o vault e o benchmark).
- --vault-key arg
- (Opcional). A chave do cofre a ser usada para acessar o cofre que é de propriedade do nó de integração ou do servidor de integração. Não há suporte para cofres de diretórios externos.
- --vaultrc-location directoryPath
- (Opcional). O caminho do diretório para o arquivo .mqsivaultrc que é usado para localizar a chave do vault. Não há suporte para cofres de diretórios externos.
- -n | --primary-data-source fonte de dados
- O nome da origem de dados para verificar.
- -u |--primary-user-name nome de usuário
- O identificador de usuário a ser usado para se conectar à fonte de dados primária.
- -p |--primary-password senha
- A senha do nome de usuário da fonte de dados primária.
- -c | --secondary-data-source fonte de dados
- (Opcional) O nome da fonte de dados secundária para comparação.
- -i | --secondary-user-name nome de usuário
- (Opcional) O identificador de usuário a ser usado para se conectar à fonte de dados secundária.
- -a | --secondary-password senha
- (Opcional) A senha do nome de usuário do recurso de dados secundário.
- --verbose
- Relata diagnósticos adicionais relacionados à fonte de dados CASTS suportada. Para obter mais informações sobre CASTS, consulte Casts suportados.
- --trace traceFileName
- Enviar rastreio interno detalhado para o arquivo especificado.
Exemplos de Sintaxe 2: Verificação de uma fonte de dados do usuário a ser usada em um nó de integração
MyDB que foi associado ao nó de integração INODE usando o comando mqsisetdbparms :mqsicvp INODE -n MyDBMyDB com um DSN secundário MyDB2 para verificar a equivalência. Ambos os DSNs foram associados ao nó de integração INODE por meio do comando mqsisetdbparms :mqsicvp INODE -n MyDB -c MyDB2Sintaxe 3: Verificar um servidor de integração independente
Parâmetros para a Sintaxe 3: Verificação de um servidor de integração independente
- -w | --work-dir workDirectory
- (Obrigatório) Esse parâmetro especifica o caminho para o diretório de trabalho que é usado por um servidor de integração independente (não um servidor de integração gerenciado por um nó de integração).
- --vault-key arg
- (Opcional). A chave do cofre a ser usada para acessar o cofre que é de propriedade do servidor de integração independente. Não há suporte para cofres de diretórios externos.
- --vaultrc-location directoryPath
- (Opcional). O caminho do diretório para o arquivo .mqsivaultrc que é usado para localizar a chave do vault. Não há suporte para cofres de diretórios externos.
- --trace traceFileName
- Enviar rastreio interno detalhado para o arquivo especificado.
Exemplos de Sintaxe 3: Verificação de um servidor de integração independente
mqsicvp --work-dir C:\myWorkDirSintaxe 4: Verificar uma fonte de dados do usuário a ser usada em um servidor de integração independente
Esta chamada requer uma associação entre o servidor de integração independente e o nome de origem de dados (DSN). Para usar com sucesso esta chamada, você deve primeiro executar o comando mqsisetdbparms ou mqsicredentials para identificar um ID e senha de usuário específicos para o servidor de integração usar ao se conectar à origem de dados. A saída desta chamada é a mesma da saída a partir da chamada em que os nomes de origem de dados não foram associados ao servidor de integração independente. Para obter mais informações, consulte a seção " ODBC Nomes de fontes de dados" no comando mqsicredentials ou no comando mqsisetdbparms.
Ao usar o comando mqsisetdbparms , você pode especificar o nome da fonte de dados diretamente ou adicionar o prefixo odbc::.
mqsisetdbparms --work-dir workDirectory -n odbc::myDsn -u username -p passwordmqsicvp --work-dir workDirectory -n myDsnParâmetros para a Sintaxe 4: Verificação de uma fonte de dados do usuário a ser usada em um servidor de integração independente
- --work-dir diretório de trabalho
- Obrigatório se você estiver usando uma invocação para um servidor de integração independente) Esse parâmetro especifica o caminho para o diretório de trabalho usado por um servidor de integração independente (não um servidor de integração gerenciado por um nó de integração).
- --vault-key arg
- (Opcional). A chave do cofre a ser usada para acessar o cofre que é de propriedade do nó de integração ou do servidor de integração. Não há suporte para cofres de diretórios externos.
- --vaultrc-location directoryPath
- (Opcional). O caminho do diretório para o arquivo . mqsivaultrc que é usado para localizar a chave do vault. Não há suporte para cofres de diretórios externos.
- -n | --primary-data-source fonte de dados
- O nome da origem de dados para verificar.
- -u | --primary-user-name nome de usuário
- O identificador de usuário a ser usado para se conectar à fonte de dados primária.
- -p | --primary-password senha
- A senha do nome de usuário da fonte de dados primária.
- -c |--secondary-data-source fonte de dados
- O nome da fonte de dados secundária para comparação.
- -i | --secondary-user-name nome de usuário
- O identificador de usuário a ser usado para se conectar à fonte de dados secundária.
- -a | --secondary-password | senha
- A senha do nome de usuário da fonte de dados secundária.
- -v | --verbose
- Relata diagnósticos adicionais relacionados a CASTS de fontes de dados compatíveis. Para obter mais informações sobre CASTS, consulte Casts suportados.
- --trace traceFileName
- Enviar rastreio interno detalhado para o arquivo especificado.
Exemplos de Sintaxe 4: Verificação de uma fonte de dados do usuário a ser usada em um servidor de integração independente
mqsicvp --work-dir workDirectory -n myDsnSintaxe 5: Comparar fontes de dados primárias e secundárias quanto à equivalência
Quando você executa o comando mqsicvp com parâmetros que são mostrados no diagrama de sintaxe a seguir, o comando fornece a função da 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. Nos sistemas Linux e AIX 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 fonte de dados (DSN) é totalmente especificado com um nome de usuário e uma senha.
Essa invocação não depende de uma associação entre o nó de integração ou o servidor de integração e a fonte de dados, e retorna informações sobre a fonte de dados mesmo quando não há associação com um nó de integração ou servidor de integração.
Parâmetros para a sintaxe 5: Comparar fontes de dados primárias e secundárias para equivalência
- -n | --primary-data-source fonte de dados
- O nome da origem de dados para verificar.
- -u | --primary-user-name nome de usuário
- O identificador de usuário a ser usado para se conectar à fonte de dados primária.
- -p | --primary-password senha
- A senha do nome de usuário da fonte de dados primária.
- -c |--secondary-data-source fonte de dados
- O nome da fonte de dados secundária para comparação.
- -i | --secondary-user-name nome de usuário
- O identificador de usuário a ser usado para se conectar à fonte de dados secundária.
- -a | --secondary-password | senha
- A senha do nome de usuário da fonte de dados secundária.
- -v | --verbose
- Relata diagnósticos adicionais relacionados a CASTS de fontes de dados compatíveis. Para obter mais informações sobre CASTS, consulte Casts suportados.
- --trace traceFileName
- Enviar rastreio interno detalhado para o arquivo especificado.
Exemplos de sintaxe 5: Comparar fontes de dados primárias e secundárias para equivalência
MyDB com um DSN secundário totalmente qualificado MyDB2 usando os IDs de usuário e senhas primários e secundários:mqsicvp -n MyDB -u username -p password -c MyDB2 -i username2 -a password2Uso do comando para executar o processamento de referência de CPU
O comando mqsicvp pode ser usado para executar uma referência no sistema para CPU e E/S de Disco. O benchmark CPU testa o desempenho da CPU calculando uma sequência aritmética recursiva em um ou mais encadeamentos. Durante o processo de benchmarking, cada thread usado normalmente consome uma CPU lógica inteira no sistema. Consequentemente, o tempo ideal para executar o comando é durante um período de inatividade planejada para que o uso da CPU não afete a execução de cargas de trabalho de produção.
O benchmark Disk i/o testa o desempenho de gravação gravando o número especificado de arquivos no disco de 199 bytes cada. Os arquivos são limpos automaticamente no final do teste. A referência de Rede testa a conectividade com o host de destino especificado no parâmetro da linha de comandos 'ipaddress'. É possível especificar o nome do host como FQDN ou endereço IP.
Sintaxe 6: Benchmarking de fonte de dados
Parâmetros para a sintaxe 6: Benchmarking de fonte de dados
- integrationNodeName
- (Opcional) Especifique o nome de um nó de integração que é definido no sistema.
- -e | --integration-server integrationServerName
- Nome do servidor de integração. (Necessário se estiver usando o vault e o benchmark).
- -b | --check-type referência
- (Necessário) Especifique um valor de
benchmarkpara executar o processamento de referência. O único valor válido é "benchmark". - -o | --options
- (Necessário) Especifique as opções para executar com o comando.
Exemplos de Sintaxe 6: Benchmarking de fonte de dados
mqsicvp -b benchmark -o network-perf,ipaddress=myhostnameA saída do comando é semelhante em formato ao exemplo a seguir:
Running the command to test network connectivity:
Sending Ping Request to : myhostname
Host 'myhostname' is reachable
mqsicvp -b benchmark -o network-perf,ipaddress=otherhostA saída do comando é semelhante em formato ao exemplo a seguir:
Running the command to test network connectivity:
Sending Ping Request to : otherhost
Host 'otherhost' is not reachable
Execute o comando para medir o desempenho do disco / io:
mqsicvp -b benchmark -o disk-io-perf,numberoffiles=100A saída do comando é semelhante em formato ao exemplo a seguir:
Running the command to measure disk/io performance:
Total disk writing time: 6ms to write 100 files of size 199 bytes to disk
Executando o comando para medir o desempenho da CPU:
mqsicvp mqsicvp -b benchmark -o cpu-perf,threads=10,iterations=10,sequence=10A saída do comando é semelhante em formato ao exemplo a seguir:
Running 10.0 threads
ThreadId:20 - Calculating sequence to number 10.0 10.0 times
ThreadId:24 - Calculating sequence to number 10.0 10.0 times
ThreadId:25 - Calculating sequence to number 10.0 10.0 times
ThreadId:21 - Calculating sequence to number 10.0 10.0 times
ThreadId:29 - Calculating sequence to number 10.0 10.0 times
ThreadId:28 - Calculating sequence to number 10.0 10.0 times
ThreadId:27 - Calculating sequence to number 10.0 10.0 times
ThreadId:26 - Calculating sequence to number 10.0 10.0 times
ThreadId:23 - Calculating sequence to number 10.0 10.0 times
ThreadId:22 - Calculating sequence to number 10.0 10.0 times
Total CPU time: 5.0ms for 100.0 calculations
Rating Value:2.0E10
Average Core Value:2.0E9
Autorizaçã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: Conectada à origem de dados < múltiplas inserções>
- BIP8271I: Conectada à segunda origem de dados < múltiplas inserções> para comparação.
- BIP8272W: A origem de dados especificada não está associada ao nó de integração.
- BIP8273I: Os seguintes tipos de dados e funções não são nativamente suportados por fonte de dados '& 1': < múltiplas inserções>
- BIP8274W: Os seguintes tipos de dados e funções podem causar problemas ao usar a fonte de dados '&1' com o ` IBM App Connect Enterprise `: <inserções múltiplas>
- BIP8288W: Não é possível ler o arquivo ODBCINI 'file_name'. Verifique se esse arquivo existe e se o ID do usuário do nó de integração 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 esse arquivo existe e se o ID do usuário do nó de integração 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 fontes de dados do usuário doinsert1não foram verificadas porque não possuem credenciais 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 nó de integração ' integraçãoNodeName '.
- BIP8874I: A verificação do componente para ' integraçãoNodeName ' finalizado com sucesso.
- BIP8875W: A verificação do componente para ' integraçãoNodeName 'concluído, mas uma ou mais verificações falharam.
- BIP8876I: Iniciando a verificação do ambiente para o nó de integração ' integraçãoNodeName '.
- BIP8877W: A verificação do ambiente para o nó de integração ' integraçãoNodeName 'concluído, mas uma ou mais verificações falharam.
- BIP8878I: A verificação do ambiente para o nó de integração ' integraçãoNodeName ' finalizado com sucesso.
- BIP8882I: Iniciando a verificação do ` IBM MQ ` para o nó de integração 'integrationNodeName '.
- BIP8883W: A verificação do IBM MQ para o nó de integração 'integrationNodeName ' foi concluída, mas uma ou mais verificações falharam.
- BIP8884I: A verificação do ` IBM MQ ` para o nó de integração 'integrationNodeName ' foi concluída com sucesso.
- BIP8885E: A verificação falhou. Falha ao conectar-se ao gerenciador de filas 'queue_manager_name'. MQRC: código de retorno MQCC: código de conclusão
- 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: código de retorno MQCC: código de conclusão
- BIP8888E: A verificação falhou. Falha ao desconectar-se do gerenciador de filas 'queue_manager_name'. MQRC: código de retorno MQCC: código de conclusão
- BIP8892E: A verificação falhou. O nível Java instalado 'level_instalado' não atende ao nível Java necessário 'level_suportados'.
- 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 extras para o suporte IBM : data1 data2.
- BIP8894I: A verificação foi aprovada para ' integraçãoNodeName '.
- 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 extras para o suporte IBM : data1 data2
- BIP8897E: A verificação falhou. Variável de ambiente ' nome variável 'não corresponde ao nome do nó de integração' integraçãoNodeName '.
- 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 executar stat no arquivo 'file_name 1' com código de retorno 'return_code' e número do erro 'error_number'.
