Propriétés des définitions de service IBM MQ
Vous pouvez définir des propriétés et des attributs pour des définitions de service lors de la création d'une définition de service ou lors de l'édition d'une définition de service existante.
Certains attributs ne sont disponibles que si la définition de service possède un type de liaison spécifique ou un modèle d'échange de messages. Cliquez sur les liens suivants pour afficher les pages de propriétés individuelles d'une définition de service :
- Général
- Opération
- Destination d'entrée
- Schéma du message d'entrée
- En-tête du message d'entrée
- Destination de sortie
- Schéma du message de sortie
- En-tête du message de sortie
Pour chaque attribut, une brève description indique dans quel cas vous pourriez avoir à le configurer.
Page Général
Le tableau suivant répertorie les attributs que vous pouvez définir dans la page Général de la boîte de dialogue Propriétés de définitions de service.
Attribut | Description |
---|---|
Espace de nom | Indique l'espace de nom du service. Une valeur par défaut temporaire y est déjà affecté. |
Nom | Nom unique de la nouvelle définition de service. Le nom de la définition de service ne fait pas la distinction entre les minuscules et les majuscules, mais un nom de définition de service à casse mixte est conservé. |
Masque d'échange des messages | Le modèle d'échange de messages décrit la direction de messages envoyés et reçus lors de l'appel d'un service.
Il y a deux sélections possibles :
|
Type de liaison | Indique la version de la spécification de définition de service IBM® MQ. |
Commentaire | Spécifiez un commentaire pour annoter le service dans le fichier WSDL. |
Page Opération
Le tableau suivant répertorie les attributs que vous pouvez définir dans la page Opération de la boîte de dialogue Propriétés de définitions de service. Chaque définition de service ne compte qu'une seule opération.
Attribut | Description |
---|---|
Nom de l'opération | Indique le nom de l'opération. Cette propriété doit avoir une valeur pour pouvoir créer une définition de service. |
Action | Utilisée par le fournisseur de services pour répartir les requêtes de service. Par exemple :
permettre le déploiement de plusieurs services en utilisant une destination unique, permettant à un fournisseur de services de répartir les requêtes qui arrivent à la destination de manière appropriée. Lorsque le type de liaison est MQ, Action indique targetAction. |
Commentaire | Spécifiez un commentaire pour annoter l'opération dans le fichier WSDL. |
Page Destination d'entrée
Le tableau suivant répertorie les attributs que vous pouvez définir dans la page Destination d'entrée de la boîte de dialogue Propriétés de définitions de service. Les pages en entrée définissent les détails du message attendu par le service et la destination à partir de laquelle il sera extrait.
Attribut | Description |
---|---|
Nom de la destination d'entrée | Indique le nom de la file d'attente de destination ou la rubrique de destination à laquelle la demande est envoyée, par exemple : Particule
queue-dest ou topic-dest d'un URI IBM MQ, par exemple :
|
Nom du gestionnaire de files d'attente de destination | Indique le nom du gestionnaire de files d'attente de destination. |
Gestionnaire de files d'attente de connexion | Indique le nom du gestionnaire de files d'attente auquel le service demandeur se connecte. Il correspond au paramètre QmgrName utilisé sur les appels MQCONN() et MQCONNX(). |
Propriétés de connexion client | Les propriétés de connexion client indiquent les liaisons détaillées qui peuvent inclure des informations sur la manière dont un demandeur de service s'associe à une machine ou un canal spécifique. Pouvoir spécifier les liaisons client et les noms de canaux est utile dans certains cas, en revanche, une spécification de service excessive peut être contraignante. Pour résoudre le problème, réduisez le volume d'informations de liaison dans une définition de service et autorisez l'infrastructure sous-jacente ou IBM MQ à envoyer les messages lorsque cela est possible. |
Nom de la table des canaux | Indique le nom du fichier de la table de canaux client qui est utilisé pour identifier la connexion au canal.
|
Bibliothèque des tables de canaux | Indique le chemin d'accès à la table de canaux client.
|
Nom de connexion du canal client | Spécifie la chaîne de connexion utilisée lorsqu'un demandeur de service effectue une connexion de liaison client IBM MQ MQI. Pour TCP/IP, la connexion se présente sous la forme d'un nom d'hôte suivi d'un numéro de port, par exemple :
Si le numéro de port n'est pas spécifié, la valeur par défaut 1414 est utilisée.
|
Nom du canal client | Spécifie le canal utilisé lorsqu'un demandeur de service IBM MQ effectue une connexion de liaison client IBM MQ.
|
Type de transport du canal client | Spécifie le type de transport à utiliser lorsqu'un demandeur de service IBM MQ effectue une connexion de liaison client IBM MQ MQI.
|
Schéma du message d'entrée
Le tableau suivant répertorie les attributs que vous pouvez définir dans la page Schéma du message d'entrée de la boîte de dialogue Propriétés de définitions de service. Elles permettent de définir le schéma pour les données utiles d'un message.
Attribut | Description |
---|---|
Type de données entrantes | Indique le type de données entrantes attendues. Pour les types simples, la modélisation peut se faire à l'aide des types XML xsd intégrés, par exemple xsd:string ou xsd:int .
Pour des types plus complexes, un type de données peut être importé à partir
d'un fichier externe en spécifiant Importer le fichier de
schéma et Importer l'espace de nom pour le type
de données. |
Importation du fichier schéma | Indique le fichier de schéma à importer. |
Importation de l'espace de nom | Indique l'espace de nom à importer. |
Page d'en-tête du message d'entrée
Le tableau suivant répertorie les attributs que vous pouvez définir dans la page En-tête du message d'entrée de la boîte de dialogue Propriétés de définitions de service. Les pages en entrée définissent les détails du message attendu par le service et la destination à partir de laquelle il sera extrait. Certaines propriétés ne s'appliquent qu'à des définitions de service d'un type de liaison MQ.
Attribut | Description |
---|---|
CCSID | Indique l'ID de jeu de caractères codés qui correspond à la zone CodedCharSetId dans la structure MQMD. Si cette valeur n'est pas spécifiée, alors le demandeur et le fournisseur de service utilisent une valeur qui correspond au jeu de caractères des données du message. |
Format | Indique le nom de format des données de message. Cette propriété correspond à la zone de format MQRFH2, ou à la zone de format MQMD s'il n'y a pas de zone MQRFH2. La valeur doit être une chaîne de 0 à 8 caractères, pouvant contenir les caractères de A à Z et de 0 à 9. Le format peut être associé à n'importe quelle valeur conformément aux instructions figurant dans la Zone Format. |
Propriétés utilisateur | Indique les données définies par l'utilisateur dans les messages de service IBM MQ. Les valeurs doivent être spécifiées dans les formats appropriés pour les éléments du dossier RFH2 ; dans une série de triplets codés à l'aide d'une syntaxe de type XML, par exemple :
L'élément dt="datatype " est facultatif, et s'il est omis, il est traité en tant que chaîne, permettant aux éléments d'être spécifiés en tant que :
Par exemple :
Pour plus d'informations sur les types de données admis et le
formatage, voir NameValueData (MQCHARn) dans l'IBM Knowledge Center.
Il n'est pas recommandé d'inclure des propriétés sensibles telles qu'un ID utilisateur ou un mot de passe. |
Type de message | Indique le type du message envoyé.
Cette propriété correspond à MsgType dans la structure MQMD.
Les cinq valeurs possibles sont les suivantes :
|
Persistance | Indique si le message est persistant ou non, correspond à la zone Persistance dans la structure MQMD. Les trois valeurs admises sont les suivantes :
|
ID de message | Indique l'identificateur du message qui correspond à la zone MsgId dans la structure MQMD. L'ID de message permet de décrire certaines applications IBM MQ sous forme de services (par exemple, les applications qui partagent une file d'attente en entrée et sélectionnent les messages qui leur sont destinés en fonction d'une valeur msgId prédéfinie). Les msgIds prédéfinis dans les définitions de service peuvent causer des incidents, par exemple lorsqu'un modèle d'échange de messages requête-réponse renvoie le msgId de la requête. L'ID du message peut être une chaîne de caractères ou une valeur binaire. Les valeurs binaires doivent être une chaîne de maximum 24 paires de valeurs hexadécimales à 2 caractères.Cliquez sur Editer pour ouvrir une boîte de dialogue et entrez la valeur sous forme de texte ou d'octets. |
ID corrélation | Indique l'ID de corrélation qui correspond à la zone CorrelId dans la structure MQMD. L'ID de corrélation peut être une chaîne de caractères ou une valeur binaire. Les valeurs binaires doivent être une chaîne de maximum 24 paires de valeurs hexadécimales à 2 caractères. Cliquez sur Editer pour ouvrir une boîte de dialogue et entrez la valeur sous forme de texte ou d'octets. |
Expiration | Indique la durée de vie du message. Il doit s'agir d'un entier signé, et elle est mesurée en dixièmes de seconde. L'ordre de grandeur de l'Expiration va de 1 à 2 147 483 647. Une valeur spéciale Illimité est utilisée pour indiquer que le message n'a pas d'expiration. La valeur -1 est écrite dans le fichier WSDL. La valeur Non spécifié signifie qu'aucune valeur n'est écrite dans le fichier WSDL. Il s'agit de la valeur par défaut. |
Priorité | Indique la priorité associée au message et correspond à
la zone priorité dans la structure MQMD.
Elle est indiquée sous forme d'un entier compris entre 0 et 9, 0 étant la priorité la plus basse et 9 étant la priorité maximale. Une valeur spéciale Illimité est utilisée pour indiquer que la priorité du message est fixée à partir de la définition de la première file d'attente du message. La valeur -1 est écrite dans le fichier WSDL. La valeur Non spécifié signifie qu'aucune valeur n'est écrite dans le fichier WSDL. Il s'agit de la valeur par défaut. |
Codage | Indique le codage numérique des données du message, il correspond à la zone Codage dans la structure MQMD :
|
Options de rapport | Indiquent comment les identificateurs de message et de corrélation dans le message de réponse ou le message d'erreur sont définis par le fournisseur de services.
Cette propriété correspond à la zone de rapport dans la structure MQMD.
Il existe quatre valeurs possibles :
|
Page de destination de sortie
Le tableau suivant répertorie les attributs que vous pouvez définir dans la page Sortie de destination de la boîte de dialogue Propriétés de définitions de service. Les pages de sortie définissent les détails du message que le service va envoyer en réponse au message d'entrée, et sa destination. Le nom de la destination de sortie doit inclure le préfixe 'msg/queue/' pour les files d'attente, ou 'msg/topic/' pour les rubriques.
Attribut | Description |
---|---|
Nom de la destination de sortie | Indique le nom de la file d'attente de destination ou de la rubrique de destination à laquelle le message de réponse est envoyé, et correspond aux zones ReplyToQ et ReplyToQMgr de la structure MQMD. Le nom de la destination doit prendre la forme de la particule queue-dest ou topic-dest d'un URI IBM MQ, par exemple :
|
Nom du gestionnaire de files d'attente de destination | Indique le nom du gestionnaire de files d'attente de destination. |
Gestionnaire de files d'attente de connexion | Indique le nom du gestionnaire de files d'attente auquel le service demandeur se connecte. Il correspond au paramètre QmgrName utilisé sur les appels MQCONN() et MQCONNX(). |
Propriétés de connexion client | Les propriétés de connexion client indiquent les liaisons détaillées qui peuvent inclure des informations sur la manière dont un demandeur de service s'associe à une machine ou un canal spécifique. Pouvoir spécifier les liaisons client et les noms de canaux est utile dans certains cas, en revanche, une spécification de service excessive peut être contraignante. Pour résoudre le problème, réduisez le volume d'informations de liaison dans une définition de service et autorisez l'infrastructure sous-jacente ou IBM MQ à envoyer les messages lorsque cela est possible. |
Nom de la table des canaux | Indique le nom du fichier de la table de canaux client qui est utilisé pour identifier la connexion au canal.
|
Bibliothèque des tables de canaux | Indique le chemin d'accès à la table de canaux client.
|
Nom du canal client | Spécifie la chaîne de connexion utilisée lorsqu'un demandeur de service effectue une connexion de liaison client IBM MQ MQI. Pour TCP/IP, la connexion se présente sous la forme d'un nom d'hôte suivi d'un numéro de port, par exemple :
Si le numéro de port n'est pas spécifié, la valeur par défaut 1414 est utilisée.
|
Nom de connexion du canal client | Spécifie le canal utilisé lorsqu'un demandeur de service IBM MQ effectue une connexion de liaison client IBM MQ.
|
Type de transport du canal client | Spécifie le type de transport à utiliser lorsqu'un demandeur de service IBM MQ effectue une connexion de liaison client IBM MQ MQI.
|
Page du schéma du message de sortie
Le tableau suivant répertorie les attributs que vous pouvez définir dans la page Schéma du message de sortie de la boîte de dialogue Propriétés de définitions de service. Elles permettent de définir le schéma pour les données utiles d'un message.
Attribut | Description |
---|---|
Type de données sortantes | Indique le type de données sortantes attendues. |
Importation du fichier schéma | Indique le fichier de schéma à importer. |
Importation de l'espace de nom | Indique l'espace de nom à importer. |
Page d'en-tête du message de sortie
Le tableau suivant répertorie les attributs que vous pouvez définir dans la page En-tête du message de sortie de la boîte de dialogue Propriétés de définitions de service. Les pages de sortie définissent les détails du message que le service va envoyer en réponse au message d'entrée, et sa destination. Certaines propriétés ne s'appliquent qu'à des définitions de service d'un type de liaison MQ.
Attribut | Description |
---|---|
CCSID | Indique l'ID de jeu de caractères codés qui correspond à la zone CodedCharSetId dans la structure MQMD. Si cette valeur n'est pas spécifiée, alors le demandeur et le fournisseur de service utilisent une valeur qui correspond au jeu de caractères des données du message. |
Format | Indique le nom de format des données de message. Cette propriété correspond à la zone de format MQRFH2, ou à la zone de format MQMD s'il n'y a pas de zone MQRFH2. La valeur doit être une chaîne de 0 à 8 caractères, pouvant contenir les caractères de A à Z et de 0 à 9. Le format peut être associé à n'importe quelle valeur conformément aux instructions figurant dans la Zone Format. |
Propriétés utilisateur | Indique les données définies par l'utilisateur dans les messages de service IBM MQ. Les valeurs doivent être spécifiées dans les formats appropriés pour les éléments du dossier RFH2 ; dans une série de triplets codés à l'aide d'une syntaxe de type XML, par exemple :
L'élément dt="datatype " est facultatif, et s'il est omis, il est traité en tant que chaîne, permettant aux éléments d'être spécifiés en tant que :
Par exemple :
Pour plus d'informations sur les types de données admis et le
formatage, voir NameValueData (MQCHARn) dans
l'IBM Knowledge Center.
Il n'est pas recommandé d'inclure des propriétés sensibles telles qu'un ID utilisateur ou un mot de passe. |
Type de message | Indique le type du message envoyé.
Cette propriété correspond à MsgType dans la structure MQMD.
Les cinq valeurs possibles sont les suivantes :
|
Persistance | Indique si le message est persistant ou non, correspond à la zone Persistance dans la structure MQMD. Les trois valeurs admises sont les suivantes :
|
ID de message | Indique l'identificateur du message qui correspond à la zone MsgId dans la structure MQMD. L'ID de message permet de décrire certaines applications IBM MQ sous forme de services (par exemple, les applications qui partagent une file d'attente en entrée et sélectionnent les messages qui leur sont destinés en fonction d'une valeur msgId prédéfinie). Les msgIds prédéfinis dans les définitions de service peuvent causer des incidents, par exemple lorsqu'un modèle d'échange de messages requête-réponse renvoie le msgId de la requête. L'ID du message peut être une chaîne de caractères ou une valeur binaire. Les valeurs binaires doivent être une chaîne de maximum 24 paires de valeurs hexadécimales à 2 caractères.Cliquez sur Editer pour ouvrir une boîte de dialogue et entrez la valeur sous forme de texte ou d'octets. |
ID corrélation | Indique l'ID de corrélation qui correspond à la zone CorrelId dans la structure MQMD. L'ID de corrélation peut être une chaîne de caractères ou une valeur binaire. Les valeurs binaires doivent être une chaîne de maximum 24 paires de valeurs hexadécimales à 2 caractères. Cliquez sur Editer pour ouvrir une boîte de dialogue et entrez la valeur sous forme de texte ou d'octets. |
Expiration | Indique la durée de vie du message. Il doit s'agir d'un entier signé, et elle est mesurée en dixièmes de seconde. L'ordre de grandeur de l'Expiration va de 1 à 2 147 483 647. Une valeur spéciale Illimité est utilisée pour indiquer que le message n'a pas d'expiration. La valeur -1 est écrite dans le fichier WSDL. La valeur Non spécifié signifie qu'aucune valeur n'est écrite dans le fichier WSDL. Il s'agit de la valeur par défaut. |
Priorité | Indique la priorité associée au message et correspond à la zone priorité dans la structure MQMD.
Elle est indiquée sous forme d'un entier compris entre 0 et 9, 0 étant la priorité la plus basse et 9 étant la priorité maximale. Une valeur spéciale Illimité est utilisée pour indiquer que la priorité du message est fixée à partir de la définition de la première file d'attente du message. La valeur -1 est écrite dans le fichier WSDL. La valeur Non spécifié signifie qu'aucune valeur n'est écrite dans le fichier WSDL. Il s'agit de la valeur par défaut. |
Codage | Indique le codage numérique des données du message, il correspond à la zone Codage dans la structure MQMD :
|
Options de rapport | Indiquent comment les identificateurs de message et de corrélation dans le message de réponse ou le message d'erreur sont définis par le fournisseur de services.
Cette propriété correspond à la zone de rapport dans la structure MQMD.
Il existe quatre valeurs possibles :
|