Proprietà dei messaggi
Le proprietà dei messaggi vengono visualizzate nella finestra Proprietà del messaggio. Non è possibile modificare le proprietà dei messaggi.
Le seguenti tabelle elencano le proprietà dei messaggi IBM® MQ che è possibile inserire nelle code e richiamare dalle code:
- generale
- Prospetto
- Contesto
- Identificatori
- Segmentazione
- Proprietà denominate
- Proprietà MQRFH2
- Dati
- Intestazione non instradabile
Per ciascuna proprietà è riportata una breve descrizione. Le tabelle mostrano anche il formato MQMD del nome, come utilizzato nella API. Questo è descritto in MQMD - Message descriptor in IBM Documentation.
Pagina Generale
Nella seguente tabella sono riportate le proprietà nella pagina Generale della finestra Proprietà dei messaggi.
Proprietà | Significato | Formato MQMD |
---|---|---|
Posizione | Sola lettura. La posizione corrente nella coda del messaggio. | (Non applicabile.) |
Tipo messaggio | Sola lettura. Questo è il tipo di messaggio: Datagram significa che il messaggio non richiede una risposta; Request significa che il messaggio richiede una risposta; Reply significa che il messaggio è una risposta a un messaggio di richiesta precedente; Report significa che il messaggio sta riportando informazioni su qualche ricorrenza prevista o imprevista, di noma correlata a qualche altro messaggio. Ad esempio, un messaggio di richiesta che conteneva dati non validi. |
MsgType |
Priorità | Sola lettura. Questa è la priorità del messaggio. La priorità minima è 0. | Priorità |
Persistenza | Sola lettura. Indica se il messaggio è persistente o non persistente. Se il messaggio è persistente, è in grado di superare gli errori di sistema e i riavvii del gestore code. Se il messaggio non è persistente, sopravvive ad un riavvio solo se è presente su una coda che ha la proprietà NPMCLASS (HIGH). Tuttavia, anche con la proprietà NPMCLASS(HIGH), un messaggio non sopravvive a una classe QMGR. I messaggi non persistenti nelle code che hanno la proprietà NPMCLASS(NORMAL) vengono eliminati al riavvio del gestore code, anche se il messaggio viene trovato nella memoria ausiliaria durante la procedura di riavvio. | Persistenza |
Data/ora di inserimento | Sola lettura. La data in cui è stato inserito il messaggio. | PutDate; PutTime |
Scadenza | Sola lettura. Il periodo di tempo, in decimi di secondo, dopo il quale il messaggio può essere eliminato se non è già stato rimosso dalla coda di destinazione. L'intervallo di scadenza è impostato dall'applicazione che invia il messaggio. | Scadenza |
Coda di risposta | Sola lettura. Il nome della coda di messaggi a cui l'applicazione che ha emesso la richiesta get per il messaggio deve inviare i messaggi di risposta e di report. | ReplyToQ |
Gestore code di risposta | Sola lettura. Questo è il nome del gestore code su cui è definita la coda di risposta. | ReplyToQmgr |
Conteggio backout | Sola lettura. Il numero di volte in cui il messaggio è stato precedentemente restituito dalla chiamata MQGET come parte di un'unità di lavoro e di cui successivamente ne è stato eseguito il backout. | BackoutCount |
Pagina Report
Nella seguente tabella sono riportate le proprietà nella pagina Report della finestra Proprietà dei messaggi. Un report è un messaggio relativo a un altro messaggio, utilizzato per informare l'applicazione su eventi previsti o meno relativi al messaggio originale. La pagina Report visualizza le proprietà relative ai messaggi di report. Per ulteriori informazioni, consultare Opzioni di report e indicatori di messaggi in IBM Documentation.
Proprietà | Significato | Formato MQMD |
---|---|---|
Prospetto | Sola lettura. Questo campo è il campo in cui l'applicazione mittente specifica se i messaggi di report sono richiesti, se i dati dell'applicazione devono essere inclusi nei messaggi di report e se è necessario impostare gli ID di correlazione nel messaggio di risposta o dei report. | Prospetto |
Feedback | Sola lettura. Questo attributo viene utilizzato solo con i messaggi di report per indicare la natura del report. | Feedback |
Lunghezza originale | Sola lettura. Questo attributo viene utilizzato solo con i messaggi di report per indicare la lunghezza del messaggio originale a cui si correla il report. | OriginalLength |
Pagina Contesto
Nella seguente tabella sono riportate le proprietà nella pagina Contesto della finestra Proprietà dei messaggi. Nella pagina Contesto sono riportate informazioni dell'applicazione mittente sul messaggio.
Proprietà | Significato | Formato MQMD |
---|---|---|
Identificativo utente | Sola lettura. Questo è l''ID utente dell'applicazione che ha originato il messaggio. | UserIdentifier |
Tipo di applicazione | Sola lettura. Questo è il tipo di applicazione che inserisce il messaggio, ad esempio, CICS® o AIX®. | PutApplType |
Inserisci nome applicazione | Sola lettura. Questo è il nome dell'applicazione che ha inserito il messaggio. Il nome potrebbe essere visualizzato troncato. | PutApplName |
Dati identità applicazione | Sola lettura. Queste sono le informazioni definite dall'applicazione e che possono essere utilizzate per fornire altre informazioni sul messaggio o su chi lo ha originato. | ApplIdentityData |
Dati origine applicazione | Sola lettura. Queste sono le informazioni definite dall'applicazione e che possono essere utilizzate per fornire altre informazioni sull'origine del messaggio. | ApplOriginData |
Token account | Sola lettura. Queste sono le informazioni che consentono all'applicazione di caricare il lavoro in maniera appropriata come risultato del messaggio. | AccountingToken |
Pagina Identificativi
Nella seguente tabella sono riportate le proprietà nella pagina Identificativi della finestra Proprietà del messaggio. Nella pagina Identificativi sono riportate le informazioni di identificazione associate al messaggio.
Proprietà | Significato | Formato MQMD |
---|---|---|
ID messaggio | Sola lettura. Questo è l'ID del messaggio, utilizzato per distinguere un messaggio da un altro. | MsgId |
Byte ID messaggio | Sola lettura. Questo è l'ID del messaggio espresso in byte. | MsgId |
Identificativo di correlazione | Sola lettura. Questo è l'ID di correlazione che può essere utilizzato dall'applicazione per correlare un messaggio all'altro oppure per correlare il messaggio a un altro lavoro che sta eseguendo l'applicazione. | CorrelId |
Byte ID di correlazione | Sola lettura. Questo è l'ID di correlazione espresso in byte. | CorrelId |
ID gruppo | Sola lettura. Questo è l'ID del gruppo che può essere utilizzato dall'applicazione per identificare il determinato gruppo di messaggi o il messaggio logico a cui appartiene il messaggio fisico. | GroupId |
Byte ID gruppo | Sola lettura. Questo è l'ID del gruppo espresso in byte. | GroupId |
Pagina Segmentazione
Nella seguente tabella sono elencate le proprietà visualizzate nella pagina Segmentazione della finestra Proprietà del messaggio. La pagina Segmentazione visualizza le proprietà relative alla segmentazione di messaggi di grandi dimensioni.
Proprietà | Significato | Formato MQMD |
---|---|---|
Numero sequenza logica | Sola lettura. Questo è il numero di sequenza del messaggio logico all'interno del gruppo. I numeri di sequenza cominciano con il valore 1 e aumentano di 1 per ogni nuovo messaggio logico nel gruppo, fino a un valore massimo pari a 999.999.999. Un messaggio fisico che non fa parte di un gruppo ha un numero di sequenza pari a 1. | MsgSeqNumber |
Offset | Sola lettura. Questo è l'offset di dati nel messaggio fisico dall'inizio del messaggio logico. | Offset |
Indicatori | Sola lettura. Questi sono gli indicatori dei messaggi che specificano le proprietà del messaggio o che ne controllano l'elaborazione. | MsgFlags |
Pagina Proprietà denominate
Nella seguente tabella sono riportate le proprietà nella pagina Proprietà denominate della finestra Proprietà dei messaggi . La pagina Proprietà denominate è presente solo quando viene selezionato come Proprietà denominate nella pagina Proprietà dei messaggi della finestra Preferenze e quando il messaggio selezionato dispone di proprietà. Le proprietà del messaggio, eccetto quelle contenute nel descrittore o nell'estensione del messaggio, devono essere rappresentate nel pannello Proprietà denominate nelle coppie di valori nome e le proprietà vengono rimosse dai dati del messaggio.
L'opzione MQGMO è MQGMO_PROPERTIES_IN_HANDLE, per ulteriori informazioni sulle opzioni Get Message rilevanti consultareMQ Get Message Options.Per ulteriori informazioni sulla finestra di dialogo Preferenze , consultare Configurazione di MQ Explorer.
Proprietà | Significato |
---|---|
Nome | Sola lettura. Il nome della proprietà del messaggio. |
Valore | Sola lettura. Questo è il valore effettivo della proprietà denominata. |
Pagina proprietà MQRFH2
- Selezionare come una struttura MQRFH2 nel corpo del messaggio nella pagina dei Messaggi della finestra delle Preferenze.
Le proprietà del messaggio, eccetto quelle contenute nel descrittore o nell'estensione del messaggio, devono essere rappresentate nel pannello Proprietà MQRHF2 e le proprietà rimangono nei dati del messaggio. L'opzione MQGMO è MQGMO_PROPERTIES_FORCE_MQRFH2, per ulteriori informazioni sulle opzioni Get Message rilevanti consultare MQ Get Message Options.
- Selezionare come una struttura MQRFH2 nel corpo del messaggio compatibile con
WebSphere MQ V6 nella pagina dei Messaggi della finestra Preferenze. La pagina Proprietà MQRFH2 sarà visibile solo se
il messaggio contiene una proprietà con prefisso mcd, jms, usr
o mqext.
Se il messaggio contiene una proprietà con prefisso mcd, jms, usr o mqext, tutte le proprietà del messaggio, eccetto quelle contenute nel descrittore o nell'estensione del messaggio, devono essere rappresentate nel pannello Proprietà MQRFH2 e le proprietà rimangono nei dati del messaggio. Altrimenti, tutte le proprietà del messaggio, eccetto quelle contenute nel descrittore o nell'estensione del messaggio, vengono scartate e non sono visualizzate. L'opzione MQGMO è MQGMO_PROPERTIES_IN_COMPATIBILITY, per ulteriori informazioni sulle opzioni Get Message rilevanti consultareMQ Get Message Options.
Poiché la struttura MQRFH2 è nidificata xml, nella pagina Proprietà MQRFH2, le suddette proprietà vengono visualizzate in una vista ad albero. Tutte le proprietà con lo stesso sinonimo vengono raggruppate nello stesso albero dei sinonimi, che può essere espanso per visualizzare tutte le proprietà, oppure compresso per nasconderle.
Proprietà | Significato |
---|---|
Nome | Sola lettura. Il nome della proprietà del messaggio. |
Valore | Sola lettura. Questo è il valore effettivo della proprietà denominata. |
Pagina Dati
Nella seguente tabella sono riportate le proprietà nella pagina Dati della finestra Proprietà dei messaggi. Nella pagina Dati sono riportati i dati dei messaggi e le informazioni sul formato dei dati.
Proprietà | Significato | Formato MQMD |
---|---|---|
Lunghezza dati | Sola lettura. Questa è la lunghezza del messaggio originale. | OriginalLength |
Formato | Sola lettura. Questo è il nome che il mittente del messaggio ha utilizzato per indicare al ricevente la natura dei dati nel messaggio. | Formato |
CCSID (Coded character set identifier) | Sola lettura. Questo è l'identificativo del set di caratteri codificato dei dati del messaggio dell'applicazione. | CodedCharSetId |
Codifica | Sola lettura. Questa è la codifica numerica dei dati numerici nel messaggio. Questo valore non si applica ai dati numerici nella struttura MQMD. | Codifica |
Dati messaggio | Sola lettura. Questi sono i dati del messaggio in formato testo ASCII leggibile. | (Non applicabile.) |
Byte dati messaggio | Sola lettura. Questi sono i dati del messaggio in formato esadecimale. | (Non applicabile.) |
Pagina Intestazione non instradabile
Nella seguente tabella sono elencate le proprietà visualizzate nella pagina Intestazione non instradabile della finestra Proprietà del messaggio. La pagina Intestazione non instradabile è presente soltanto nel caso in cui il messaggio ha una intestazione che non è possibile instradare.
Proprietà | Significato | Formato MQMD |
---|---|---|
Motivo | Identifica il motivo per cui il messaggio è stato inserito nella coda di messaggi non instradabili (messaggio non consegnato) invece che nella coda di destinazione originale. | Motivo |
Coda di destinazione | Il nome della coda di messaggi che rappresentava la destinazione originale per il messaggio. | DestQName |
Gestore code di destinazione | Il nome del gestore code che rappresentava la destinazione originale per il messaggio. | DestQMgrName |
Codifica originale | Specifica la codifica numerica dei dati che seguono la struttura MQDLH (di solito i dati dal messaggio originale); essa non viene applicata ai dati numerici nella stessa struttura MQDLH. | Codifica |
CCSID originale | Specifica l'identificativo del set di caratteri dei dati che seguono la struttura MQDLH (di solito i dati dal messaggio originale); essa non viene applicata ai dati di caratteri nella stessa struttura MQDLH. | CodedCharSetId |
Formato originale | Specifica il nome del formato dei dati che seguono la struttura MQDLH (di solito i dati dal messaggio originale). | Formato |
Tipo applicazione Put | Il tipo di applicazione che ha inserito il messaggio. Questa è la parte del contesto di origine del messaggio. Per ulteriori informazioni sul contesto del messaggio, consultare Contesto del messaggio in IBM Documentation. | PutApplType |
Inserisci nome applicazione | Il nome dell'applicazione che ha inserito il messaggio nella coda di messaggi non instradabili. Il formato del nome dipende dalla proprietà Put Application
Type . Il nome potrebbe essere visualizzato troncato. |
PutApplName |
Data Put | La data in cui il messaggio è stato inserito nella coda di messaggi non instradabili. | PutDate |
Ora Put | L'ora in cui il messaggio è stato inserito nella coda di messaggi non instradabili. | PutTime |