IBM MQ Propriedades de definição de serviço
É 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 de Entrada
- Esquema da Mensagem de Entrada
- Cabeçalho da Mensagem de Entrada
- Destino de Saída
- Esquema da Mensagem de Saída
- Cabeçalho da 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 |
---|---|
Namespace | 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 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 de 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, tal como:
|
Nome do Gerenciador de Filas de Destino | Especifica o nome do gerenciador de filas de destino. |
Gerenciador de Filas da 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 de ligação incorporadas em uma definição de serviço e permitir infraestrutura subjacente ou IBM MQ para rotear mensagens sempre que possível. |
Nome da Tabela do Canal | Especifica o nome do arquivo de tabela do canal do cliente, usado para identificar a conexão do canal.
|
Biblioteca da Tabela do Canal | Especifica o caminho para a tabela de canal do cliente.
|
Nome de canal de conexão de cliente | Especifica a sequência de conexões usada quando um solicitante de serviço faz uma conexão de ligação de cliente IBM MQ MQI. Para TCP/IP, a conexão está na forma de um nome de host seguido por um número de porta, por exemplo: Se o número da porta não for especificado, um valor padrão de 1414 será 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 de cliente IBM MQ MQI.
|
Tipo de Transporte do 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 de cliente 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 tipos mais complexos, um tipo de dado pode ser importado de um arquivo externo, especificando o Import schema file e Import
namespace para o tipo de dados. |
Importar Arquivo de Esquema | Especifica o arquivo de esquema a ser importado. |
Importar Espaço de Nomes | 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 Formato pode ser configurado para qualquer valor de acordo com as diretrizes no campo Formato. |
Propriedades de Usuário | Especifica os dados definidos pelo usuário transportados em IBM MQ mensagens de serviço. 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 mais informações sobre os tipos de dados permitidos e a formatação, consulte NameValueData (MQCHARn). Não é recomendado incluir propriedades de sensibilidade de segurança tais como ID do usuário ou senhas. |
Tipo de mensagem | Especifica o tipo de mensagem enviada. Essa propriedade corresponde ao MsgType na estrutura MQMD. Os cinco valores possíveis são:
|
Persistence | 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 de mensagem | Especifica o identificador da Mensagem que corresponde ao campo MsgId na estrutura MQMD. O ID da Mensagem permite que determinados aplicativos especializados de IBM MQ sejam descritos como serviços (por exemplo: aplicativos que compartilham uma fila de entrada e selecionam as mensagens destinadas a eles com base em um valor msgId pré-definido). 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. |
Priority | 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 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 de 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 da 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 da 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 de ligação incorporadas em uma definição de serviço e permitir infraestrutura subjacente ou IBM MQ para rotear mensagens sempre que possível. |
Nome da Tabela do Canal | Especifica o nome do arquivo de tabela do canal do cliente, usado para identificar a conexão do canal.
|
Biblioteca da Tabela 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 de cliente IBM MQ MQI. Para TCP/IP, a conexão está na forma de um nome de host seguido por um número de porta, por exemplo: Se o número da porta não for especificado, um valor padrão de 1414 será usado.
|
Nome de canal de conexão de cliente | Especifica o canal usado quando um solicitante de serviço do IBM MQ faz uma conexão de ligação de cliente IBM MQ MQI.
|
Tipo de Transporte do 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 de cliente 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 Formato pode ser configurado para qualquer valor de acordo com as diretrizes no campo Formato. |
Propriedades de Usuário | Especifica os dados definidos pelo usuário transportados em IBM MQ mensagens de serviço. 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 mais informações sobre os tipos de dados permitidos e a formatação, consulte NameValueData (MQCHARn). Não é recomendado incluir propriedades de sensibilidade de segurança tais como ID do usuário ou senhas. |
Tipo de mensagem | Especifica o tipo de mensagem enviada. Essa propriedade corresponde ao MsgType na estrutura MQMD. Os cinco valores possíveis são:
|
Persistence | 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 de mensagem | Especifica o identificador da Mensagem que corresponde ao campo MsgId na estrutura MQMD. O ID da Mensagem permite que determinados aplicativos especializados de IBM MQ sejam descritos como serviços (por exemplo: aplicativos que compartilham uma fila de entrada e selecionam as mensagens destinadas a eles com base em um valor msgId pré-definido). 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. |
Priority | 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 Relatório na estrutura MQMD . Há quatro valores possíveis:
|