Mandato mqsicvp

Utilice el mandato mqsicvp para realizar pruebas de verificación en un intermediario.

Plataformas soportadas

  • Windows
  • Sistemas Linux y UNIX

Al iniciar un intermediario utilizando el mandato mqsistart, este mandato se ejecuta automáticamente para verificar el componente.

z/OS platform En z/OS, se ejecutan automáticamente los mismos procedimientos de verificación al iniciar un intermediario.

Puede ejecutar este mandato en un intermediario que esté en ejecución o que no esté en ejecución. Si el intermediario no está en ejecución, se realizan las pruebas de verificación, pero el intermediario no se inicia.

Finalidad

El mandato mqsicvp realiza las siguientes acciones:

  • El mandato comprueba que el entorno de intermediario está configurado correctamente; por ejemplo, que el nivel instalado de Java™ está soportado.
  • El mandato verifica que las colas de WebSphere MQ están definidas y son accesibles.
  • Linux platformUNIX platform En sistemas Linux y UNIX, el mandato verifica que el entorno ODBC (si se ha especificado) está configurado correctamente.
    Si la variable de entorno ODBCINI está establecida, el mandato mqsicvp graba mensajes de aviso en el registro del sistema en las siguientes circunstancias:
    • Si el archivo al que apunta la variable de entorno ODBCINI no existe, o el intermediario no tiene acceso para leerlo o escribir en él.
    • Si ODBCSYSINI no está establecida.
    • Si ODBCSYSINI está establecida pero el directorio al que apunta esta variable no contiene un archivo llamado odbcinst.ini, o el intermediario no tiene acceso para leer o escribir en este archivo
    • Si la variable de entorno IE02_PATH no está establecida
  • Linux platformUNIX platform En sistemas Linux y UNIX, si la comprobación del entorno ODBC es satisfactoria, el mandato se conecta a todos los orígenes de datos que están listados en los archivos odbc.ini, y que se asociaron al intermediario utilizando el mandato mqsisetdbparms.

Uso del mandato para proporcionar información sobre orígenes de datos de usuario

Las invocaciones adicionales del mandato mqsicvp proporcionan la función de herramienta de prueba ODBC. Esta función proporciona información útil sobre un origen de datos de usuario, o compara dos orígenes de datos de usuario para determinar su equivalencia. Estas invocaciones del mandato son distintas de la invocación básica del mandato mqsicvp, y no se ejecutan durante el inicio del intermediario.

Cuando se utiliza el mandato mqsicvp como herramienta de prueba ODBC, el mandato emite un mensaje informativo para una conexión satisfactoria, y proporciona el nombre del origen de datos, el tipo de base de datos y la versión. Si se proporciona un origen de datos secundario, el mandato mqsicvp emite un segundo mensaje informativo para una conexión satisfactoria a ese origen de datos, con la misma información sobre el origen de datos secundario, y que indica que se llevará a cabo una comparación.

Cuando la herramienta se ejecuta en un origen de datos, realiza varias comprobaciones en la interfaz ODBC para determinar qué tipos de datos y funciones están soportados, junto con información sobre los nombres y tamaños de dichos tipos de datos. Si alguno de los tipos de datos o funciones no están soportados, se resumen en un mensaje informativo final.

Cuando estas pruebas se ejecutan en dos orígenes de datos, se ejecutan en ambos orígenes de datos, y se muestran ambos conjuntos de resultados. Un mensaje informativo final indica si los dos orígenes de datos son equivalentes y elegibles para ser utilizados en el mismo nodo de proceso de mensajes; para obtener más información, consulte Acceder a bases de datos desde ESQL.

Sintaxis

Cuando se ejecuta el mandato mqsicvp sólo con el nombre de intermediario, y sin ningún otro parámetro, el mandato realiza las siguientes comprobaciones:
  • Comprueba que el entorno de intermediario está configurado correctamente (por ejemplo, que el nivel instalado de Java está soportado).
  • Verifica que las colas de WebSphere MQ están definidas y son accesibles.
  • Linux platformUNIX platform Sólo en sistemas Linux y UNIX, el mandato verifica que el entorno ODBC (si se ha especificado) está configurado correctamente. Si la variable de entorno ODBCINI no está establecida, la verificación del entorno ODBC se pasa por alto. Si la comprobación del entorno ODBC se realiza satisfactoriamente, el mandato intenta entonces conectarse a todos los orígenes de datos que están listados en los archivos odbc.ini en los que se ha utilizado el mandato mqsisetdbparms para asociar el origen de datos al intermediario.
Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsicvp--nombreIntermediario--------------------------------><

Sintaxis

Invocación que utiliza nombres de origen de datos totalmente especificados

Cuando se ejecuta el mandato mqsicvp con los parámetros que se muestran en el siguiente diagrama de sintaxis, el mandato proporciona la función de herramienta de prueba ODBC. Puede utilizar el mandato para visualizar información útil sobre un origen de datos de usuario, o comparar dos orígenes de datos de usuario. Sólo en sistemas Linux y UNIX, las invocaciones del mandato que utilizan estos parámetros también verifican que el entorno ODBC (si se ha especificado) está configurado correctamente. En estos casos, el mandato comprueba que las variables ODBCINI, ODBCSYSINI e IE02_PATH están establecidas.

Cada nombre de origen de datos (DSN) está totalmente especificado con un nombre de usuario y contraseña.

Esta invocación no se basa en una asociación entre el intermediario y el origen de datos, y devuelve información sobre éste aunque no exista ninguna asociación con un intermediario.

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsicvp-- -n--nombreOrigenDatosPrincipal--------------------->

>-- -u--idUsuarioOrigenDatosPrincipal--------------------------->

>-- -p--contraseñaOrigenDatosPrincipal-------------------------->

>--+-------------------------------------------------------------------------------------------------------------+-->
   '- -c--nombreOrigenDatosSecundario-- -i--idUsuarioOrigenDatosSecundario-- -a--contraseñaOrigenDatosSecundario-'   

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

Sintaxis

Invocación en la que nombres de origen de datos estaban asociados al intermediario

Esta invocación requiere que exista una asociación entre el intermediario y el nombre de origen de datos (DSN). Para utilizar esta invocación de forma satisfactoria, primero debe ejecutar el mandato mqsisetdbparms para identificar un ID de usuario y una contraseña específicos, que el intermediario utilizará cuando se conecte al origen de datos. La salida de esta invocación es la misma que la salida de la invocación que utiliza nombres de origen de datos totalmente especificados.

Linux platformUNIX platform Sólo en sistemas Linux y UNIX, las invocaciones del mandato que utilizan los parámetros del siguiente diagrama de sintaxis también verifican que el entorno ODBC (si se ha especificado) está configurado correctamente. En estos casos, el mandato comprueba que las variables ODBCINI, ODBCSYSINI e IE02_PATH están establecidas.

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsicvp--nombreIntermediario-- -n--origenDatosPrincipal------>

>--+----------------------------+--+-----+---------------------><
   '- -c--origenDatosSecundario-'  '- -v-'   

Parámetros

nombreIntermediario
(Necesario - si va a utilizar una invocación que contiene nombreIntermediario.) Especifique un nombre de intermediario para verificar, o el nombre de intermediario al que está asociado el origenDatosPrincipal.

Linux platformUNIX platform Todos los nombres son sensibles a las mayúsculas y minúsculas en los sistemas Linux y UNIX.

-n origenDatosPrincipal
(Necesario si va a utilizar una invocación que contiene origenDatosPrincipal.) El nombre de la conexión ODBC para verificar.
-u idUsuarioOrigenDatosPrincipal
(Necesario si no ha asociado anteriormente el nombre de origen de datos al intermediario.) El nombre de usuario con el que conectarse al origenDatosPrincipal.
-p contraseñaOrigenDatosPrincipal
(Necesario si no ha asociado anteriormente el nombre de origen de datos al intermediario.) La contraseña que se utiliza con el idUsuarioOrigenDatosPrincipal.
-c origenDatosSecundario
(Opcional) Si se van a comparar dos orígenes de datos para determinar su equivalencia, este origen de datos es el segundo nombre de conexión ODBC.
-i idUsuarioOrigenDatosSecundario
(Opcional) El nombre de usuario con el que conectarse al origenDatosSecundario.
-a contraseñaOrigenDatosSecundario
(Opcional) La contraseña que se utiliza con el idUsuarioOrigenDatosSecundario.
-v
(Opcional) Este parámetro hace que el mandato muestre información de diagnóstico adicional, no traducida, que está relacionada con transformaciones CASTS soportadas.

Autorización

Para obtener información sobre autorizaciones que son específicas de los sistemas operativos, consulte los temas siguientes: Si ha habilitado la seguridad de administración de intermediario, también debe configurar la autorización que se describe en Tareas y autorizaciones para la seguridad de administración.

Respuestas

  • BIP8040W: No hay acceso a la base de datos (no es posible establecer conexión).
  • BIP8267W: Aviso: es posible que haya problemas al utilizar este origen de datos. Para obtener más información, consulte los mensajes anteriores.
  • BIP8268I: Los dos orígenes de datos especificados son compatibles y pueden utilizarse en el mismo nodo Compute.
  • BIP8269W: Los dos orígenes de datos especificados no son compatibles y no deben utilizarse en el mismo nodo Compute.
  • BIP8270I: Conectado al origen de datos <varias inserciones>
  • BIP8271I: Conectado al segundo origen de datos <varias inserciones> para comparación.
  • BIP8272W: El origen de datos especificado no está asociado al intermediario.
  • BIP8273I: Los siguientes tipos de datos y funciones no están soportados de forma nativa por el origen de datos '&1': <varias inserciones>
  • BIP8274W: Los siguientes tipos de datos y funciones pueden causar problemas cuando se utilice el origen de datos '&1' con IBM® Integration Bus: <varias inserciones>
  • BIP8288W: No se puede leer el archivo ODBCINI 'nombre_archivo'. Compruebe que este archivo existe y que el ID de usuario del intermediario tiene permiso para leer y escribir en el archivo.
  • BIP8289W: No se puede leer el archivo ODBCSYSINI en el directorio especificado 'nombre_directorio'. Compruebe que este archivo existe y que el ID de usuario del intermediario tiene permiso para leer y escribir en el archivo.
  • BIP8290I: El entorno ODBC ha pasado la verificación.
  • BIP8291W: La variable de entorno IE02_PATH no está establecida.
  • BIP8292I: 'insert1' orígenes de datos de usuario no se han verificado porque no tienen credenciales mqsisetdbparms.
  • BIP8294I: Se ha pasado por alto la verificación del entorno ODBC porque la variable de entorno ODBCINI no está establecida.
  • BIP8295E: Las variables de entorno ODBC no se han establecido o no son válidas.
  • BIP8296W: La variable de entorno ODBCSYSINI no está establecida.
  • BIP8297W: El archivo'nombre_variable_entorno' 'nombre_archivo' está vacío.
  • BIP8873I: Iniciando la verificación de componente para el intermediario 'nombre_intermediario'.
  • BIP8874I: La verificación de componente para 'nombre_intermediario' ha finalizado satisfactoriamente.
  • BIP8875W: La verificación de componente para 'nombre_intermediario' ha finalizado, pero una o más comprobaciones no han sido satisfactorias.
  • BIP8876I: Iniciando la verificación de entorno para el intermediario 'nombre_intermediario'.
  • BIP8877W: La verificación de entorno para el intermediario 'nombre_intermediario' ha finalizado, pero una o más comprobaciones no han sido satisfactorias.
  • BIP8878I: La verificación de entorno para el intermediario 'nombre_intermediario' ha finalizado satisfactoriamente.
  • BIP8882I: Iniciando la verificación de WebSphere MQ para el intermediario 'nombre_intermediario'.
  • BIP8883W: La verificación de WebSphere MQ para el intermediario 'nombre_intermediario' ha finalizado, pero uno o más comprobaciones no han sido satisfactorias.
  • BIP8884I: La verificación de WebSphere MQ para el intermediario 'nombre_intermediario' ha finalizado satisfactoriamente.
  • BIP8885E: La verificación ha fallado. No se ha podido conectar al gestor de colas 'nombre_gestor_colas'. MQRC: código_retorno MQCC: código_terminación
  • BIP8886I: La cola 'nombre_cola' en el gestor de colas 'nombre_gestor_colas' ha pasado la verificación.
  • BIP8887E: La verificación ha fallado para la cola 'nombre_cola' en el gestor de colas 'nombre_gestor_colas' al emitir 'operación'. MQRC: código_retorno MQCC: código_terminación
  • BIP8888E: La verificación ha fallado. No se ha podido desconectar del gestor de colas 'nombre_gestor_colas'. MQRC: código_retorno MQCC: código_terminación
  • BIP8892E: La verificación ha fallado. El nivel de Java 'nivel_instalado' no cumple con el nivel de Java necesario 'nivel_soportado'.
  • BIP8893E: La verificación ha fallado para la variable de entorno 'nombre_variable'. No se ha podido acceder al archivo 'nombre_archivo' con el ID de usuario 'ID_usuario'. Información adicional para el soporte de IBM: datos1 datos2.
  • BIP8894I: La verificación ha pasado para 'nombre_intermediario'.
  • BIP8895E: La verificación ha fallado. La variable de entorno 'nombre_variable' es incorrecta o se ha omitido.
  • BIP8896E: La verificación ha fallado. No se ha podido acceder al registro con el ID de usuario 'ID_usuario'. Información adicional para el soporte de IBM: datos1 datos2
  • BIP8897E: La verificación ha fallado. La variable de entorno 'nombre_variable' no coincide con el nombre de intermediario 'nombre_intermediario'.
  • BIP8900I: La comprobación de autorización APF ha sido satisfactoria para el archivo 'nombre_archivo'.
  • BIP8903E: La verificación ha fallado. La comprobación de autorización APF ha fallado para el archivo 'nombre_archivo'.
  • BIP8904E: La verificación ha fallado. No se ha podido iniciar el archivo 'nombre_archivo1' con el código de retorno 'código_retorno' y número de error 'número_error'.

Ejemplos

Ejecutar comprobaciones de verificación en el intermediario llamado: IB9NODE
mqsicvp IB9NODE
El nombre de origen de datos (DSN) MyDB se asocia al intermediario IB9NODE utilizando el mandato mqsisetdbparms:
mqsicvp
IB9NODE -n MyDB
El DSN MyDB se compara con un DSN secundario MyDB2 asociado al intermediario IB9NODE utilizando el mandato mqsisetdbparms:
mqsicvp
IB9NODE -n MyDB -c MyDB2
El DSN totalmente calificado MyDB se compara con un DSN totalmente calificado secundario MyDB2 utilizando los ID de usuario y contraseñas primarios y secundarios:
mqsicvp –n MyDB –u nombreusuario –p contraseña –c MyDB2 –i nombreusuario2 –a contraseña2
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última actualización:
        
        Última actualización: 2013-07-16 12:54:16


Tema de referenciaTema de referencia | IBM Integration Bus Versión 9.0.0.0 | bn07236_