Mandato mqsicreatemsgdefsfromwsdl

Plataformas soportadas

  • Windows
  • Linux (plataforma x86)

Finalidad

El mandato mqsicreatemsgdefsfromwsdl se puede utilizar para importar una sola definición WSDL. Si el WSDL se divide en varios archivos, el archivo especificado debe contener la definición de servicio WSDL o la definición de enlace. El validador WS-I puede ejecutarse automáticamente en el WSDL importado bajo el control del indicador -vfa.

Nota:
  1. Asegúrese de que en la estructura de directorio y subdirectorios que especifique sólo haya los archivos que se necesitan para la definición WSDL que está importando. Una de las acciones que realiza el mandato mqsicreatemsgdefsfromwsdl es copiar todos los archivos del directorio y subdirectorios en el espacio de trabajo, antes de crear la definición de mensaje. Esto podría incluir cualquier archivo no asociado a la definición WSDL.
  2. Si la definición WSDL utiliza una vía de acceso relativa que incluye archivos fuera de la estructura especificada de directorios o subdirectorios, estos archivos deberán importarse al espacio de trabajo antes de ejecutar el mandato. Debe asegurarse de que las vías de acceso relativas sean todavía válidas después de importar estos archivos al espacio de trabajo
  3. Los conjuntos de mensajes que se crean estarán habilitados para espacios de nombres.
  4. Los conjuntos de mensajes existentes deben estar habilitados para espacios de nombres y tener un formato físico XML.
  5. Si está creando un nuevo conjunto de mensajes para análisis en tiempo de ejecución, debería basarlo en un conjunto de mensajes existente que tenga un formato físico XML.

Sintaxis

Parámetros

-base <NombreProyectoConjuntoMensajesBase>\<NombreConjuntoMensajesBase>
(Opcional) Si se va a crear un nuevo conjunto de mensajes, éste es el conjunto de mensajes o el proyecto del conjunto de mensajes existente en el que se basa
-binding <nombreenlace>
(Opcional) El nombre de un enlace a importar. Este parámetro es obligatorio si la definición WSDL incluye más de un enlace, pero opcional si la definición WSDL incluye un solo enlace
-d nombre de vía de acceso de carpeta de archivos de origen
(Necesario) El nombre de la vía de acceso absoluta o relativa del directorio en el que se encuentra el archivo WSDL de nivel superior. El archivo WSDL de nivel superior puede contener la definición WSDL entera, o puede ser la parte superior de una jerarquía de archivos, cada uno de los cuales puede importar archivos adicionales a través de elementos de importación. Un elemento de importación especifica la ubicación del recurso a importar con un atributo de ubicación

El importador intenta resolver todas las ubicaciones de importación relativas al directorio especificado. El importador también intentará resolver las ubicaciones de importación absolutas que encuentre, pero no se recomienda utilizarlas. Si se especifica una ubicación absoluta, las demás importaciones en la jerarquía también deben utilizar ubicaciones absolutas.

-data <víaAccesoEspacioTrabajo>
(Necesario) La vía de acceso del espacio de trabajo en el que se crean sus proyectos.

La ubicación del espacio de trabajo es también la ubicación por omisión de los proyectos. Las vías de acceso relativas se interpretan como relativas al directorio desde el que se ha iniciado el mandato.

-fEl nombre de archivo WSDL de nivel superior para la definición WSDL.
(Necesario). El nombre del archivo WSDL de nivel superior que se va a importar.

Cuando sea necesario especificar una vía de acceso para identificar completamente el nombre de archivo, la vía de acceso debe especificarse utilizando el parámetro -d.

-log nombre vía acceso archivo informe
(Opcional) El nombre de la vía de acceso absoluta o relativa del archivo de informe. Si se omite, el informe se graba en el archivo de anotaciones por omisión y su nombre es <nombre-archivo-wsdl>.wsdl.report.txt, (donde <nombre-archivo-wsdl> es el nombre de la definición WSDL que está importando) y se colocará en el directorio desde el que se invoca el mandato.
-p nombre de proyecto de conjunto de mensajes
(Necesario) El nombre del proyecto de conjunto de mensajes. Si el proyecto existe, debe estar habilitado para espacios de nombres. Si el proyecto no existe, se crea uno nuevo habilitado para espacios de nombres.
-rmd
(Opcional) Sustituye un archivo de definición de mensajes existente con el mismo nombre.
Nota:
  1. Si este indicador se omite y existe un archivo de definición de mensajes con el mismo nombre, recibirá un aviso.
  2. La ubicación del archivo de definición de mensajes generado en el conjunto de mensajes la determina el espacio de nombres de destino.
-rmp
(Opcional) Sustituye el proyecto existente con el mismo nombre.
-v
(Opcional) Informe verboso.
-vfa
(Opcional) Acción para error de validación. Especifica la acción requerida si la comprobación de conformidad WS-I detecta un problema en el WSDL a importar. El valor por omisión es 'fail'. Seleccione una de estas opciones:
  • fail: Si la definición WSDL no es conforme con WS-I, el proceso de importación se detendrá y se grabarán errores en el archivo de anotaciones.
  • warn: Si la definición WSDL no es conforme con WS-I, el proceso de importación grabará errores de aviso en el archivo de anotaciones.
  • ignore: Si la definición WSDL no es conforme con WS-I, el proceso de importación hace caso omiso de ello y se grabarán mensajes informativos en el archivo de anotaciones indicando que esta definición WSDL no es conforme con el perfil WS-I.

Ejemplos

En el ejemplo siguiente, el documento WSDL service.wsdl que se encuentra en el directorio archivoswsdl, se va a importar al proyecto miProyecto y, si éste ya existe, va a sobrescribirlo.

mqsicreatemsgdefsfromwsdl  -p miProyecto -d .\archivoswsdl -f service.wsdl -rmd -data .\wsdlfilewspc

En el ejemplo siguiente, el documento WSDL service.wsdl que se encuentra en el directorio archivoswsdl, se va a importar para crear un nuevo proyecto de conjunto de mensajes (proyNuevo) basado en un proyecto existente (proyExistente).

mqsicreatemsgdefsfromwsdl  -p proyNuevo -base proyExistente -d .\archivoswsdl -f service.wsdl -data
.\wsdlfilewspc
Conceptos relacionados
Archivos de definición de mensajes
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
an07355_