IBM MQ lette dai messaggi sulle code di origine

L'agent che legge i messaggi da una coda di origine in un messaggio al trasferimento file legge le proprietà del messaggio IBM® MQ dal messaggio. Il valore di queste proprietà può essere utilizzato per determinare il comportamento di un trasferimento.

Intestazioni utilizzate per annullare i trasferimenti da messaggio a file

Impostare le seguenti proprietà del messaggio IBM MQ sull'ultimo messaggio in un gruppo per annullare il trasferimento da messaggio a file di tale gruppo:
usr.UserReturnCode
Obbligatorio. Il codice di ritorno del trasferimento. Impostare questa intestazione come un valore diverso da zero per indicare che il trasferimento deve essere annullato.
usr.UserSupplement
Facoltativo. Testo che descrive il motivo per cui il trasferimento è stato annullato.
Se l'agent di origine di un messaggio per il trasferimento file legge un messaggio dalla coda di origine che ha la proprietà del messaggio usr.UserReturnCode impostata su un valore diverso da zero, arresta la lettura dei messaggi dalla coda e riporta che il trasferimento non è riuscito nell'XML del log di trasferimento. L'XML del log di trasferimento contiene il codice di ritorno e il testo supplementare impostato nelle intestazioni del messaggio. Se l'agent di destinazione ha già scritto i dati in un file temporaneo, questo file viene eliminato dalla destinazione.

Intestazioni utilizzate dalla sostituzione della variabile

Il valore di qualsiasi proprietà del messaggio IBM MQ nel primo messaggio da leggere dalla coda monitorata può essere sostituito nella definizione XML dell'attività. Le proprietà del messaggio definite dall'utente hanno come prefisso usr., ma non includono questo prefisso nel nome della variabile. I nomi delle variabili devono essere preceduti dal simbolo del dollaro ($) e racchiusi tra parentesi graffe ({}). Ad esempio, ${destFileName} viene sostituito con il valore della proprietà del messaggio usr.destFileName del primo messaggio da leggere dalla coda di origine.

Ad esempio, l'utente o il programma che inseriscono i messaggi in una coda monitorata può impostare le proprietà del messaggio IBM MQ sul primo messaggio in un gruppo specificando quale agent deve essere utilizzato come destinazione del trasferimento file e a quale nome file trasferire i dati.

Per ulteriori informazioni, consultare Monitoraggio di una coda e utilizzo della sostituzione di variabili.