Propriedades de Definição de Serviço do IBM MQ
É possível testar propriedades e atributos para definições de serviço ao criar uma nova definição de serviço ou ao editar uma definição de serviço existente.
Alguns atributos estarão disponíveis apenas quando a definição de serviço for de um tipo de ligação específico ou do padrão de troca de mensagem. Siga esses links para visualizar as propriedades das páginas de propriedades individuais de uma definição de serviço:
- Geral
- Operação
- Destino da Entrada
- Esquema de Mensagem de Entrada
- Cabeçalho de Mensagem de Entrada
- Destino da Saída
- Esquema de Mensagem de Saída
- Cabeçalho de Mensagem de Saída
Para cada atributo, existe uma breve descrição de quando você pode precisar configurar o atributo.
Página Geral
A tabela a seguir lista os atributos que podem ser configurados na página Geral do diálogo Propriedades de Definição de Serviço.
Atributo | Descrição |
---|---|
Espaço de nomes | Especifica o espaço de nomes para o serviço. Já há um valor padrão temporário designado. |
Nome | Um nome exclusivo para a nova Definição de Serviço. O nome da definição de serviço não possui distinção entre maiúsculas e minúsculas, mas um nome de definição de serviço composto por letras e números é guardado. |
Padrão de troca de mensagem | O Padrão de Troca de Mensagem descreve a direção das mensagens enviadas e recebidas durante a chamada de um serviço.
Há duas seleções possíveis:
|
Tipo de ligação | Especifica a versão da especificação de definição de serviço do IBM® MQ. |
Comentário | Especifique um comentário para anotar o serviço no arquivo WSDL. |
Página Operação
A tabela a seguir lista os atributos que podem ser configurados na página Operação no diálogo Propriedades de Definição de Serviço. Cada definição de serviço possui apenas 1 operação.
Atributo | Descrição |
---|---|
Nome da operação | Especifica o nome da operação. Esta propriedade deve possuir um valor para criar uma definição de serviço. |
Ação | Usada pelo provedor de serviços para o dispatch de pedidos de serviço. Por exemplo: Permitir que vários serviços sejam implementados usando um único destino, ativar um provedor de serviços para o dispatch de pedidos que chegam no destino apropriadamente. Quando o tipo de ligação for MQ, Action especificará targetAction. |
Comentário | Especifique um comentário para anotar a operação no arquivo WSDL. |
Página de Destino da Entrada
A tabela a seguir lista os atributos que podem ser configurados na página Destino da Entrada do diálogo Propriedades de Definição de Serviço. As páginas de entrada definem os detalhes da mensagem que o serviço espera e o destino do qual ela será recuperada.
Atributo | Descrição |
---|---|
Nome do destino da entrada | Especifica o nome da fila de destino ou o tópico de destino para o qual o pedido é enviado, por exemplo: A partícula queue-dest ou topic-dest de um IRI do IBM MQ, como:
|
Nome do gerenciador de filas de destino | Especifica o nome do gerenciador de filas de destino. |
Gerenciador de filas de conexão | Especifica o nome do gerenciador de filas ao qual o serviço de pedidos se conecta. Isto corresponde ao parâmetro QmgrName usado nas chamadas MQCONN() e MQCONNX(). |
Propriedades da Conexão do Cliente | As propriedades de conexão do cliente especificam as ligações detalhadas que podem incluir informações sobre como um solicitante de serviços se liga a uma máquina ou canal específico. Ser capaz de especificar ligações de cliente e nomes de canal é útil em algumas circunstâncias, mas especificar demais o serviço pode ser restritivo entretanto. Uma solução para este problema é minimizar a quantidade de informações sobre ligação incorporadas a uma definição de serviço e permitir que uma infraestrutura subjacente ou o IBM MQ roteie mensagens onde possível. |
Nome de tabela do canal | Especifica o nome do arquivo de tabela do canal do cliente, usado para identificar a conexão do canal.
|
Biblioteca de tabelas do canal | Especifica o caminho para a tabela de canal do cliente.
|
Nome de conexão do canal do cliente | Especifica a sequência de conexões usada quando um solicitante de serviço faz uma conexão de ligação do cliente do IBM MQ MQI. Para TCP/IP, a conexão é na forma de um nome de host seguido por um número de porta, por exemplo:
Se o número da porta não é especificado, um valor padrão de 1414 é usado.
|
Nome do canal do cliente | Especifica o canal usado quando um solicitante de serviço do IBM MQ faz uma conexão de ligação do cliente do IBM MQ MQI.
|
Tipo de transporte de canal do cliente | Especifica o tipo de transporte a ser usado quando um solicitante de serviço do IBM MQ faz uma conexão de ligação do cliente do IBM MQ MQI.
|
Página de Esquema de Mensagem de Entrada
A tabela a seguir lista os atributos que podem ser configurados na página Esquema de Mensagem de Entrada do diálogo Propriedades de Definição de Serviço. Permitem que o esquema para a carga útil da mensagem seja definido.
Atributo | Descrição |
---|---|
Tipo de dado de entrada | Especifica o tipo de dado de entrada esperado. Para tipos simples, isto pode ser modelado usando os tipos xsd construídos em XLM tais como xsd:string ou xsd:int .
Para obter tipos mais complexos, um tipo de dado pode ser importado de um arquivo externo especificando Importar arquivo de esquema e Importar
namespace para o tipo de dado. |
Importação de arquivo de esquema | Especifica o arquivo de esquema a ser importado. |
Importação de namespace | Especifica o namespace a ser importado. |
Página de Cabeçalho de Mensagem de Entrada
A tabela a seguir lista os atributos que podem ser configurados na página Cabeçalho de Mensagem de Entrada do diálogo Propriedades de Definição de Serviço. As páginas de entrada definem os detalhes da mensagem que o serviço espera e o destino do qual ela será recuperada. Algumas da propriedades apenas se aplicam a definições de serviço de um tipo de ligação MQ.
Atributo | Descrição |
---|---|
CCSID | Especifica o ID do Conjunto de Caracteres Codificados que corresponde ao campo CodedCharSetId na estrutura MQMD. Se este valor não é especificado, então o solicitante de serviços e o provedor de serviços usam o valor que corresponde ao conjunto de caracteres dos dados da mensagem. |
Formato | Especifica o nome do formato dos dados da mensagem. Esta propriedade corresponde ao campo de formato MQRFH2,ou ao campo de formato MQMD se não há nenhum MQRFH2 presente. O valor deve ser uma sequência de caracteres entre
0 e 8 caracteres, consistindo nos caracteres A-Z e 0-9. O Format pode ser configurado para qualquer valor, de acordo com as diretrizes encontradas no Campo Formato. |
Propriedades do usuário | Especifica os dados definidos pelo usuário transportados em mensagens de serviço do IBM MQ. Os valores devem ser especificados no formato permitido para elementos da pasta RFH2, em uma série de trios codificados usando uma sintaxe semelhante a XML, como:
O elemento dt="datatype " é opcional e se for omitido, será tratado como uma cadeia, permitindo que os elementos sejam especificados como:
Por exemplo:
Para obter informações adicionais sobre os tipos de dados permitidos e formatação, consulte NameValueData (MQCHARn) na IBM Knowledge
Center.
Não é recomendado incluir propriedades de sensibilidade de segurança tais como ID do usuário ou senhas. |
Tipo da mensagem | Especifica o tipo de mensagem enviada.
Essa propriedade corresponde ao MsgType na estrutura MQMD.
Os cinco valores possíveis são:
|
Persistência | Especifica se a mensagem é persistente ou não e se corresponde ao campo Persistência na estrutura MQMD. Os três valores
possíveis são:
|
ID da Mensagem | Especifica o identificador da Mensagem que corresponde ao campo MsgId na estrutura MQMD. O ID de Mensagem permite que alguns aplicativos especializados do IBM MQ sejam descritos como serviços (por exemplo: aplicativos que compartilham uma fila de entrada e selecionam as mensagens destinada a eles com base em um valor msgId predefinido). msgIds predefinidos nas definições de serviços podem levar a problemas, como quando um Padrão de Troca de Mensagem pedido-resposta retorna o msgId do pedido. O Id de Mensagem pode ser ou uma cadeia de caracteres ou um valor binário. Valores binários devem ser uma cadeia de até 24 pares de valores de dois caracteres hexadecimais.Clique em Editar para abrir um diálogo e inserir um valor como texto ou bytes. |
ID de Correlação | Especifica que o ID de Correlação corresponde ao campo CorrelId na estrutura MQMD. O ID de Correlação pode ser ou uma cadeia de caracteres ou um valor binário. Valores binários devem ser uma cadeia de até 24 pares de valores de dois caracteres hexadecimais. Clique em Editar para abrir um diálogo e inserir um valor como texto ou bytes. |
Expiração | Especifica o tempo de vida da mensagem. Deve ser um número inteiro assinado, e é medido em décimos de um segundo. O intervalo de Expiração é de 1 a 2 147 483 647. Um valor especial de Ilimitado é usado para indicar que a mensagem não expira. O valor -1 é gravado no arquivo WSDL. Um valor de Não especificado significa que nenhum valor é gravado no arquivo WSDL. Esse é o valor padrão. |
Prioridade | Especifica a prioridade associada à mensagem e corresponde
ao campo prioridade na estrutura MQMD.
Deve ser especificado como um número inteiro entre 0 e 9, com 0 como a menor prioridade e 9 como a maior prioridade. Um valor especial de Ilimitado é usado para indicar que a prioridade da mensagem é tomada da definição da primeira fila na qual a mensagem é colocada. O valor -1 é gravado no arquivo WSDL. Um valor de Não especificado significa que nenhum valor é gravado no arquivo WSDL. Esse é o valor padrão. |
Codificação | Especifica a codificação numérica dos dados da mensagem, que corresponde ao campo Codificação na estrutura MQMD:
|
Opções de relatório | Especifica como a mensagem e os identificadores de correlação na mensagem de resposta ou na mensagem de falha são configurados pelo provedor de serviços.
Esta propriedade corresponde ao campo de Relatório na estrutura MQMD.
Há quatro valores possíveis:
|
Página de Destino da Saída
A tabela a seguir lista os atributos que podem ser configurados na página Destino da Saída do diálogo Propriedades de Definição de Serviço. As páginas de saída definem os detalhes da mensagem que o serviço enviará em resposta à mensagem de entrada, e o destino no qual será colocada. O nome do destino da saída deve ser prefixado com 'msg/queue/' para filas ou 'msg/topic/' para tópicos.
Atributo | Descrição |
---|---|
Nome do destino da saída | Especifica o nome da fila de destino ou o tópico de destino ao qual a mensagem de resposta é enviada e corresponde aos campos ReplyToQ e ReplyToQMgr da estrutura MQMD. O Nome de destino deve assumir a forma de uma partícula queue-dest ou topic-dest de um URI do IBM MQ, como:
|
Nome do gerenciador de filas de destino | Especifica o nome do gerenciador de filas de destino. |
Gerenciador de filas de conexão | Especifica o nome do gerenciador de filas ao qual o serviço de pedidos se conecta. Isto corresponde ao parâmetro QmgrName usado nas chamadas MQCONN() e MQCONNX(). |
Propriedades da Conexão do Cliente | As propriedades de conexão do cliente especificam as ligações detalhadas que podem incluir informações sobre como um solicitante de serviços se liga a uma máquina ou canal específico. Ser capaz de especificar ligações de cliente e nomes de canal é útil em algumas circunstâncias, mas especificar demais o serviço pode ser restritivo entretanto. Uma solução para este problema é minimizar a quantidade de informações sobre ligação incorporadas a uma definição de serviço e permitir que uma infraestrutura subjacente ou o IBM MQ roteie mensagens onde possível. |
Nome de tabela do canal | Especifica o nome do arquivo de tabela do canal do cliente, usado para identificar a conexão do canal.
|
Biblioteca de tabelas do canal | Especifica o caminho para a tabela de canal do cliente.
|
Nome do canal do cliente | Especifica a sequência de conexões usada quando um solicitante de serviço faz uma conexão de ligação do cliente do IBM MQ MQI. Para TCP/IP, a conexão é na forma de um nome de host seguido por um número de porta, por exemplo:
Se o número da porta não é especificado, um valor padrão de 1414 é usado.
|
Nome de conexão do canal do cliente | Especifica o canal usado quando um solicitante de serviço do IBM MQ faz uma conexão de ligação do cliente do IBM MQ MQI.
|
Tipo de transporte de canal do cliente | Especifica o tipo de transporte a ser usado quando um solicitante de serviço do IBM MQ faz uma conexão de ligação do cliente do IBM MQ MQI.
|
Página de Esquema de Mensagem de Saída
A tabela a seguir lista os atributos que podem ser configurados na página Esquema de Mensagem de Saída do diálogo Propriedades de Definição de Serviço. Permitem que o esquema para a carga útil da mensagem seja definido.
Atributo | Descrição |
---|---|
Tipo de dado de saída | Especifica o tipo de dado de saída esperado |
Importação de Arquivo de Esquema | Especifica o arquivo de esquema a ser importado |
Importação de Espaço de Nomes | Especifica o namespace a ser importado |
Página de Cabeçalho de Mensagem de Saída
A tabela a seguir lista os atributos que podem ser configurados na página Cabeçalho de Mensagem de Saída do diálogo Propriedades de Definição de Serviço. As páginas de saída definem os detalhes da mensagem que o serviço enviará em resposta à mensagem de entrada, e o destino no qual será colocada. Algumas da propriedades apenas se aplicam a definições de serviço de um tipo de ligação MQ.
Atributo | Descrição |
---|---|
CCSID | Especifica o ID do Conjunto de Caracteres Codificados que corresponde ao campo CodedCharSetId na estrutura MQMD. Se este valor não é especificado, então o solicitante de serviços e o provedor de serviços usam o valor que corresponde ao conjunto de caracteres dos dados da mensagem. |
Formato | Especifica o nome do formato dos dados da mensagem. Esta propriedade corresponde ao campo de formato MQRFH2,ou ao campo de formato MQMD se não há nenhum MQRFH2 presente. O valor deve ser uma sequência de caracteres entre
0 e 8 caracteres, consistindo nos caracteres A-Z e 0-9. O Format pode ser configurado para qualquer valor, de acordo com as diretrizes encontradas no Campo Formato. |
Propriedades do usuário | Especifica os dados definidos pelo usuário transportados em mensagens de serviço do IBM MQ. Os valores devem ser especificados no formato permitido para elementos da pasta RFH2, em uma série de trios codificados usando uma sintaxe semelhante a XML, como:
O elemento dt="datatype " é opcional e se for omitido, será tratado como uma cadeia, permitindo que os elementos sejam especificados como:
Por exemplo:
Para obter informações adicionais sobre os tipos de dados permitidos e formatação, consulte NameValueData (MQCHARn) na IBM Knowledge
Center.
Não é recomendado incluir propriedades de sensibilidade de segurança tais como ID do usuário ou senhas. |
Tipo da mensagem | Especifica o tipo de mensagem enviada.
Essa propriedade corresponde ao MsgType na estrutura MQMD.
Os cinco valores possíveis são:
|
Persistência | Especifica se a mensagem é persistente ou não e se corresponde ao campo Persistência na estrutura MQMD. Os três valores
possíveis são:
|
ID da Mensagem | Especifica o identificador da Mensagem que corresponde ao campo MsgId na estrutura MQMD. O ID de Mensagem permite que alguns aplicativos especializados do IBM MQ sejam descritos como serviços (por exemplo: aplicativos que compartilham uma fila de entrada e selecionam as mensagens destinada a eles com base em um valor msgId predefinido). msgIds predefinidos nas definições de serviços podem levar a problemas, como quando um Padrão de Troca de Mensagem pedido-resposta retorna o msgId do pedido. O Id de Mensagem pode ser ou uma cadeia de caracteres ou um valor binário. Valores binários devem ser uma cadeia de até 24 pares de valores de dois caracteres hexadecimais.Clique em Editar para abrir um diálogo e inserir um valor como texto ou bytes. |
ID de Correlação | Especifica que o ID de Correlação corresponde ao campo CorrelId na estrutura MQMD. O ID de Correlação pode ser ou uma cadeia de caracteres ou um valor binário. Valores binários devem ser uma cadeia de até 24 pares de valores de dois caracteres hexadecimais. Clique em Editar para abrir um diálogo e inserir um valor como texto ou bytes. |
Expiração | Especifica o tempo de vida da mensagem. Deve ser um número inteiro assinado, e é medido em décimos de um segundo. O intervalo de Expiração é de 1 a 2 147 483 647. Um valor especial de Ilimitado é usado para indicar que a mensagem não expira. O valor -1 é gravado no arquivo WSDL. Um valor de Não especificado significa que nenhum valor é gravado no arquivo WSDL. Esse é o valor padrão. |
Prioridade | Especifica a prioridade associada à mensagem e corresponde ao campo de prioridade na estrutura MQMD.
Deve ser especificado como um número inteiro entre 0 e 9, com 0 como a menor prioridade e 9 como a maior prioridade. Um valor especial de Ilimitado é usado para indicar que a prioridade da mensagem é tomada da definição da primeira fila na qual a mensagem é colocada. O valor -1 é gravado no arquivo WSDL. Um valor de Não especificado significa que nenhum valor é gravado no arquivo WSDL. Esse é o valor padrão. |
Codificação | Especifica a codificação numérica dos dados da mensagem, que corresponde ao campo Codificação na estrutura MQMD:
|
Opções de relatório | Especifica como a mensagem e os identificadores de correlação na mensagem de resposta ou na mensagem de falha são configurados pelo provedor de serviços.
Esta propriedade corresponde ao campo de Relatório na estrutura MQMD.
Há quatro valores possíveis:
|