Comando mqsicreatemsgdefsfromwsdl

Plataformas Suportadas

  • Windows
  • Linux (plataforma x86)

Finalidade

O comando mqsicreatemsgdefsfromwsdl pode ser utilizado para importar uma definição WSDL única. 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.

Nota:
  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. Isto pode incluir arquivos não associados a essa definição WSDL.
  2. Se a definição WSDL utilizar um caminho relativo que inclui arquivos fora da estrutura de diretórios e de subdiretórios especificada, estes arquivos precisarão ser importados para o espaço de trabalho antes da execução do comando. É necessário assegurar que os caminhos relativos ainda sejam válidos após a importação destes arquivos para o espaço de trabalho
  3. Os conjuntos de mensagens criados serã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

-base <base_do_Nome_do_Projeto_do_Conjunto_de_Mensagens>\<Base_do_Nome_do_Conjunto_de_Mensagens>
(Opcional) Se um novo conjunto de mensagens for criado, este é o projeto do conjunto de mensagens existente e o conjunto de mensagens no qual ele é baseado
-binding <nome_da_ligação>
(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 tentará resolver quaisquer locais absolutos de importação que ele encontrar, porém seu uso não é recomendável. Depois que um local absoluto tiver sido especificado, quaisquer importações adicionais na hierarquia também deverão utilizar locais absolutos.

-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 O nome do arquivo WSDL de primeiro nível para a definição WSDL.
(Obrigatório). O nome do arquivo WSDL de primeiro nível a ser importado.

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

-log nome do caminho do arquivo do relatório
(Opcional) Nome do caminho absoluto ou relativo do arquivo do relatório. Se omitido, o relatório será gravado para o arquivo de registro padrão e será denominado <nome-do-arquivo-wsdl>.wsdl.report.txt, (em que <nome-do-arquivo-wsdl> é o nome da definição WSDL que você está importando) e ele será colocado no diretório do qual o comando é chamado.
-p nome do projeto do conjunto de mensagens
(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.
-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:
  • fail: Se a definição WSDL não for compatível com WS-I, o processo de importação parará e erros serão gravados no arquivo de registro.
  • warn: Se a definição WSDL não estiver em conformidade com o WS-I, o processo de importação gravará erros de aviso no arquivo de registro.
  • 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 registro.

Exemplos

No exemplo a seguir, o documento WSDL service.wsdl que existe no diretório wsdlfiles deve ser importado para o projeto myProject e deve 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) com base 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
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an07355_