Comando mqsicreatemsgdefsfromwsdl

Utilize o comando mqsicreatemsgdefsfromwsdl para importar uma definição WSDL única.

Plataformas Suportadas

  • Windows
  • Linux em x86

Propósito

Se o WSDL for dividido em vários arquivos, o arquivo especificado deverá conter a definição de serviço WSDL ou a definição de ligação. O validador WS-I pode ser executado automaticamente no WSDL importado sob o controle do sinalizador -vfa.

  1. Certifique-se de que apenas os arquivos requeridos para a definição WSDL que está sendo importada existam na estrutura de diretórios e de subdiretórios. Uma das ações desempenhadas pelo comando mqsicreatemsgdefsfromwsdl é copiar todos os arquivos no diretório e subdiretórios para o espaço de trabalho antes de criar a definição de mensagem. Arquivos que não estiverem associados a esta definição WSDL mas existirem no diretório também serão copiados.
  2. Se a definição WSDL utilizar um caminho relativo que inclua arquivos fora da estrutura especificada do diretório e subdiretório, você deve importar estes arquivos para o espaço de trabalho antes de executar o comando. Assegure-se de que os caminhos relativos ainda são válidos após importar estes arquivos para o espaço de trabalho.
  3. Os conjuntos de mensagem criados são ativados pelo espaço de nomes.
  4. Conjuntos de mensagens existentes devem estar ativados para espaço de nomes e têm um formato físico XML.
  5. Se você estiver criando um novo conjunto de mensagens para análise do tempo de execução, deverá baseá-lo em um conjunto de mensagens existente que tenha um formato físico XML.

Sintaxe

Parâmetros

-p MessageSetProjectName
(Requerido) O nome do projeto do conjunto de mensagens. Se o projeto existir, ele deverá ser ativado pelo espaço de nomes. Se o projeto não existir, um novo projeto ativado pelo espaço de nomes será criado.
-base baseMessageSetProjectName\baseMessageSetName
(Opcional) Se um novo conjunto de mensagens deve ser criado, especifique o projeto existente de conjunto de mensagens e o conjunto de mensagens no qual é baseado.
-binding BindingName
(Opcional) O nome de uma ligação a ser importada. Este parâmetro será obrigatório se a definição WSDL incluir mais de uma ligação, mas será opcional se a definição WSDL incluir uma única ligação
-d Nome do caminho da pasta de arquivos de origem
(Obrigatório) O nome do caminho absoluto ou relativo do diretório onde o arquivo WSDL de nível superior está localizado. O arquivo WSDL de primeiro nível pode conter a definição WSDL inteira ou pode ser o início de uma hierarquia de arquivos, em que cada um deles pode importar arquivos adicionais por meio de elementos de importação. Um elemento de importação especifica o local do recurso a ser importado com um atributo de local.

O importador tenta resolver todos os locais de importação relativos para o diretório especificado; o importador também tenta resolver quaisquer locais de importação absolutos encontrados. Entretanto, evite utilizar locais de importação absolutos, pois quaisquer importações adicionais na hierarquia deverão utilizar locais absolutos após a primeira vez em que você especificar um local absoluto.

-data WorkspacePath
(Obrigatório) O caminho do espaço de trabalho onde seus projetos serão criados.

O local do espaço de trabalho também é o local padrão para projetos. Caminhos relativos são interpretados como sendo relativos ao diretório a partir do qual o comando foi iniciado.

-f <nome do arquivo WSDL>
(Necessário) O nome do arquivo WSDL de nível superior a ser importado.

Onde um caminho é necesário para identificar completamente o nome do arquivo, o caminho deve ser especificado utilizando o parâmetro -d.

-log ReportFilePathName
(Opcional) O nome do caminho absoluto ou relativo do arquivo de relatório; se omitido, o relatório será gravado no arquivo de log padrão e será nomeado nome-do-arquiv-Wsdl.wsdl.report.txt. nome-do-arquivo-Wsdl é o nome da definição WSDL que você está importando e ele é colocado no diretório a partir do qual o comando é chamado.
-rmd
(Opcional) Substitui um arquivo de definição de mensagem existente com o mesmo nome.
Nota:
  1. Se esse sinalizador for omitido e um arquivo de definição de mensagem com o mesmo nome existir, você receberá um aviso.
  2. O local do arquivo de definição de mensagem gerado no conjunto de mensagens é determinado pelo espaço de nomes de destino.
-rmp
(Opcional) Substitui o projeto existente com o mesmo nome.
-v
(Opcional) Relatório detalhado.
-vfa
(Opcional) Ação de falha de validação. Especifica a ação requerida se a verificação de conformidade WS-I detectar um problema no WSDL a ser importado. O padrão está configurado como fail. Selecione a partir de:
  • falha: Se a definição WSDL não for compatível com WS-I, o processo de importação é parado e serão gravados erros no arquivo de log.
  • aviso: Se a definição WSDL não for compatível com WS-I, o processo de importação gravará erros de aviso no arquivo de log.
  • ignore: Se a definição WSDL não for compatível com WS-I, o processo de importação os ignora e as mensagens informativas de como essa definição WSDL não é compatível com o perfil WS-I serão gravadas no arquivo de log.

Autorização

Não será necessária nenhuma autoridade específica para executar este comando.

Exemplos

No exemplo a seguir o documento WSDL service.wsdl que existe no diretório wsdlfiles deve ser importado para o projeto myProject e sobrescrever o projeto se ele existir.

mqsicreatemsgdefsfromwsdl  -p myProject -d .\wsdlfiles -f service.wsdl -rmd -data .\wsdlfilewspc

No exemplo a seguir, o documento WSDL service.wsdl que existe no diretório wsdlfiles deve ser importado para criar um novo projeto de conjunto de mensagens (newProj) baseado em um projeto existente (existingProj).

mqsicreatemsgdefsfromwsdl  -p newProj -base existingProj -d .\wsdlfiles -f service.wsdl -data .\wsdlfilewspc
Conceitos relacionados
Arquivos de Definição de Mensagem
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:12:52

an07355_