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:

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

Nella seguente tabella sono riportate le proprietà nella pagina MQRFH2 Proprietà della finestra Proprietà del messaggio . Esistono 2 modi per rendere visibile la 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.

Per ulteriori informazioni sulla finestra di dialogo Preferenze , consultare Configurazione di MQ Explorer.

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