WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Mandato mqsicvp

Utilice el mandato mqsicvp para realizar pruebas de verificación en un intermediario o para verificar las conexiones ODBC.

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 platformEn 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 del intermediario esté configurado correctamente; por ejemplo, que se admite el nivel instalado de Java™.
  • El mandato verifica que las colas de WebSphere MQ estén definidas y sean accesibles.
  • Linux platformUNIX platformEn 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á establecido
    • 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 platformEn sistemas Linux y UNIX, si la comprobación del entorno ODBC es correcta, el mandato se conecta a todos los orígenes de datos listados en los archivos odbc.ini que estaban asociados al intermediario mediante la utilización del mandato mqsisetdbparms.

Utilización del mandato para proporcionar información sobre los 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

Invocación para verificar el intermediario

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

Sintaxis

Invocación donde los nombres de origen de datos no se han asociado con el intermediario

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 de utilidad sobre el origen de datos de usuario, o para comparar dos orígenes de datos de usuario. En sistemas Linux y UNIX solamente, las invocaciones del mandato que utiliza 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--origenDatosPrincipal--------------------------->

>-- -u--IDUsuarioOrigenDatosPrincipal--------------------------->

>-- -p--ContraseñaOrigenDatosPrincipal-------------------------->

>--+-------------------------------------------------------------------------------------------------------+-->
   '- -c--origenDatosSecundario-- -i--IDUsuarioOrigenDatosSecundario-- -a--ContraseñaOrigenDatosSecundario-'   

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

Sintaxis

Invocaciones donde los nombres de origen de datos se asociaron con el intermediario

Esta invocación requiere que exista una asociación entre el intermediario y el nombre del 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 de la invocación donde no se han asociado nombres de origen de datos con el intermediario.

Cuando se utiliza el mandato mqsisetdbparms, se puede especificar el nombre de origen de datos directamente o añadir uno de los prefijos siguientes:
  • dsn::
  • odbc::
Estos prefijos identifican el tipo de identidad que se está creando en mqsisetdbparms y deben omitirse cuando se utiliza esta identidad como origen de datos en mqsicvp. Por ejemplo:
  • mqsisetdbparms MB7BROKER -n dsn::myDsn -u nombre_usuario -p contraseña
  • mqsicvp MB7BROKER -n myDsn
Si utiliza mqsisetdbparms para establecer una identidad de nivel de grupo de ejecución para un origen de datos, la identidad no se puede utilizar en mqsicvp. Además, mqsicvp no puede utilizar un ID de usuario y una contraseña predeterminados que se hayan establecido para todos los orígenes de datos.

Linux platformUNIX platformEn sistemas Linux y UNIX solamente, las invocaciones del mandato que utiliza los parámetros en el 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 platformTodos 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 las autorizaciones específicas a los sistemas operativos, consulte los siguientes temas: Si ha habilitado la seguridad de administración del intermediario, también debe establecer la autoridad que se detalla 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 WebSphere Message Broker: <varias inserciones>
  • BIP8288W: No se ha podido leer el archivo ODBCINI 'nombre_archivo'. Compruebe que este archivo existe y que el ID de usuario del intermediario tenga permiso para leer y escribir el archivo.
  • BIP8289W: No se ha podido leer el archivo ODBCSYSINI en el directorio especificado 'nombre_directorio'. Compruebe que este archivo existe y que el ID de usuario del intermediario tenga permiso para leer y escribir el archivo.
  • BIP8290I: La verificación ha pasado para el entorno ODBC.
  • BIP8291W: No se ha establecido la variable de entorno IE02_PATH.
  • BIP8292I: Los orígenes de datos de usuario 'insertar1' 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 ODBCINI no se han establecido o no son válidas.
  • BIP8296W: La variable de entorno ODBCSYSINI no se ha establecido.
  • 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: MB8BROKER
mqsicvp MB8BROKER
El nombre de origen de datos (DSN) MyDB se asocia al intermediario MB8BROKER utilizando el mandato mqsisetdbparms:
mqsicvp
MB8BROKER -n MyDB
El DSN MyDB se compara con un DSN secundario MyDB2 asociado al intermediario MB8BROKER utilizando el mandato mqsisetdbparms:
mqsicvp
MB8BROKER -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 nombre_usuario –p contraseña –c MyDB2 –i nombre_usuario2 –a contraseña2
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:01:29


Tema de referenciaTema de referencia | Versión 8.0.0.5 | bn07236_