Default header (-DH)

La commande d’adaptateur Deault Header -DH) indique que le descripteur de message IBM® MQ par défaut (MQMD) est utilisé comme descripteur de message pour les cibles de données.

-DH

Les règles null (= NONE) dans la zone de l’en-tête mappé sont ignorées et les valeurs MQMD par défaut générées par le gestionnaire de files d’attente sont utilisées. Toutes les zones d’en-tête non null sont définies dans MQMD pour remplacer les valeurs MQMD par défaut. La seule exception concerne les zones qui décrivent l’origine et le contexte d’identité du message.

Les zones décrivant le contexte d'origine du message sont les suivantes (répertoriées dans l'ordre dans lequel elles apparaissent dans l'exemple de schéma, mq.mtt) :
  • PutApplType
  • PutApplName
  • PutDate
  • PutTime
  • ApplOriginData
Les zones décrivant le contexte d'identité du message sont les suivantes (répertoriées dans l'ordre dans lequel elles apparaissent dans l'exemple de schéma, mq.mtt) :
  • UserIdentifier
  • AccountingToken
  • ApplIdentityData

N’essayez pas de spécifier des valeurs pour ces champs si vous utilisez l’option -DH dans la commande d’adaptateur. Si vous utilisez cette option, les valeurs fournies dans ces zones sont ignorées par l’adaptateur et remplacées par les valeurs IBM® MQ par défaut. Si vous devez spécifier explicitement des valeurs pour ces zones, utilisez l’option -HDR dans la commande d’adaptateur (sans l’option -DH).

La commande d’adaptateur Default Header (-DH) remplace la commande d’adaptateur Header (-HDR).

Les informations d’en-tête appropriées doivent être mappées si la commande d’adaptateur Default Header (-DH) est utilisée. Si les informations d’en-tête ne sont pas mappées et que la commande d’adaptateur Default Header (-DH) est utilisée, la trace mqseries indique que la mappe échoue avec l’erreur suivante :

<1476-2248>: [m4mqsPut] <1476-2248>: | [intm4mqsObtainQueueNode] <1476-2248>: | | Nœud de file d’attente trouvé : QNAME <1476-2248> : | [intm4mqsObtainQueueNode] (rc = 0) OK <1476-2248> : | Erreur d’adaptateur rc =-1011 [format de message non valide] <1476-2248> : [m4mqsPut] (rc = -1011) *** ERROR *** <1476-2248> : [m4mqsEndTransaction] <1476-2248>: | Annulation de l’unité de travail <1476-2248> : [m4mqsEndTransaction] (rc = 0) OK