Prima di iniziare
Procedura
Per inviare una richiesta a un servizio Java MQ :
- Fare clic su Apri il Generic Service Client (
)
e selezionare la pagina Richieste. - Fare clic su Aggiungi (
) oppure,
nella Libreria richieste, fare clic con il pulsante destro del mouse su EndPoint e selezionare un tipo di
richiesta da inviare. - Nella finestra Configura protocollo, selezionare WebSphere Java MQ e specificare la configurazione di trasporto. Se necessario, creare la configurazione di trasporto per la chiamata facendo clic su Nuovo (consultare Creazione di una configurazione di trasporto WebSphere Java MQ).
- Completare le seguenti informazioni nella scheda Generale:
- Coda
- Il nome del gestore code così come definito nel server WebSphere MQ.
- Tipo di messaggio
- I tipi di messaggi sono i seguenti:
- Datagramma significa che il messaggio non richiede una risposta.
- Richiesta significa che il messaggio richiede una risposta.
- Risposta significa che il messaggio è una risposta a un messaggio di richiesta precedente.
- Report significa che il messaggio è un report di ricorrenze previste o non previste, di norma correlate a qualche altro messaggio. Un esempio è un messaggio di richiesta che conteneva dati non validi.
- Persistenza messaggio
Questo valore indica se il messaggio è persistente o non persistente. Se il messaggio è persistente, sopravvive agli errori di sistema e ai riavvii del gestore code. Se il messaggio non è persistente, sopravvive a un riavvio se è presente su una coda che ha l'attributo NPMCLASS(HIGH). Tuttavia, anche con l'attributo NPMCLASS(HIGH), un messaggio non sopravvive a una classe QMGR. I messaggi non persistenti nelle code con l'attributo NPMCLASS(NORMAL) vengono eliminati durante il riavvio del gestore code, anche se il messaggio viene trovato nella memoria ausiliaria durante la procedura di riavvi.
- Risposta dinamica
- Selezionare questa casella di spunta per il server WebSphere MQ per creare dinamicamente una coda temporanea come una risposta. Se questa casella di spunta non è selezionata, viene utilizzato il messaggio nella coda di risposta.
- Coda di risposta
È il nome della coda di messaggi a cui l'applicazione che ha immesso la richiesta get per il messaggio deve inviare i messaggi di risposta e di report.
- Gestore risposte
Questo è il nome del gestore code su cui è definita la coda di risposta.
- Proprietà aggiuntive
- Specificare le proprietà aggiuntive per le code.
- Opzionale: Se necessario, completare le seguenti informazioni nella scheda Config:
- Priorità del messaggio
Questa è la priorità del messaggio. La priorità minima è 0.
- Codifica
Questa è la codifica numerica dei dati numerici nel messaggio. Questo valore non si applica ai dati numerici nella struttura MQMD stessa.
- Intervallo di scadenza
È 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 inserisce il messaggio.
- Serie di caratteri
Questo è l'identificativo della serie di caratteri dei dati carattere nei dati dei messaggi delle applicazioni.
- Opzionale: Nella scheda Report, selezionare i messaggi di report da ricevere.
- Opzionale: Se necessario, completare le seguenti informazioni nella scheda Contesto:
- Dati identità applicazione
Queste informazioni sono definite dalla suite di applicazioni. Utilizzarle per fornire informazioni sul messaggio o su chi lo ha creato.
- Dati origine applicazione
Queste informazioni sono definite dalla suite di applicazioni. Utilizzarle per fornire informazioni aggiuntive sull'origine del messaggio.
- Token di contabilità
L'applicazione ha bisogno di queste informazioni per addebitare in modo appropriato il lavoro eseguito come risultato del messaggio.
- ID utente
Questo è l'ID utente dell'applicazione che ha originato il messaggio.
- Opzionale: Nella scheda Identificativi, per i messaggi che richiedono un input binario, specificare l'ID nel formato stringa nella seconda colonna. La prima colonna viene riempita automaticamente nel formato esadecimale.
- Opzionale: Nella scheda Segmentazione, selezionare il segmento del messaggio e fare clic su Avanti.
- Questa operazione non è applicabile per la richiesta di testo. Nella pagina Seleziona elemento root, se il servizio utilizza un XSD (XML Schema Definition), selezionarne uno dall'elenco. Se l'elemento XSD non è elencato, fare clic su Sfoglia per importare il file XSD e selezionare l'elemento root per la richiesta. Se nessun XSD è disponibile per il servizio, selezionare Nessuno schema.
- Fare clic su Fine. La richiesta viene aggiunta alla sezione Endpoint della Libreria richieste.
- Nella Libreria richieste, selezionare l'elemento richiesta. Il client di servizio generico mostra tre passi: Modifica dati, Richiama e Visualizza risposta. I dettagli per la richiesta vengono visualizzati nel passo Modifica dati.
- In base alla richiesta selezionata nel passo 2, nella pagina Messaggi, utilizzare le viste Modulo, Struttura ad albero oppure Origine per modificare il contenuto della richiesta. Ciascuna vista mostra un formato differente degli stessi dati. Per aggiungere o rimuovere elementi XML nella vista Modulo o Struttura ad albero, fare clic su Schema > Convalida e assisti per essere conformi a un XSD specificato nel catalogo degli schemi.
- Nella pagina Trasporto, se necessario, modificare la configurazione del trasporto che deve essere utilizzata dalla richiesta. Per creare e modificare le configurazioni di sicurezza e trasporto, utilizzare la scheda Trasporto.
- Se è stata selezionata la richiesta SOAP XML nel passo 2, nella pagina Stack di richiesta, specificare se
si desidera sovrascrivere gli algoritmi di sicurezza o di elaborazione
applicati alla richiesta in uscita per il file WSDL. Per aggiungere una pagina Stack di risposta
per modificare gli algoritmi di sicurezza o di elaborazione per le risposte in entrata, fare clic su Mostra stack risposte.
Nota: Queste impostazioni si applicano solo alla richiesta corrente. Per modificare lo stack di richieste o di risposte per tutte le richieste che utilizzano il file WSDL corrente, fare clic su Modifica sicurezza WSDL per aprire l'Editor sicurezza WSDL.
- Quando si è pronti, fare clic su Richiama per inviare la richiesta di servizio. Il client del servizio generico invia la richiesta e visualizza la restituzione del messaggio sotto la pagina Visualizza risposta.
Operazioni successive
).