Guida per l'utente
Questa pagina descrive come configurare MQSeries Internet Gateway in
modo da poter utilizzare le applicazioni e le risorse MQSeries.
Vengono trattati i seguenti argomenti:
Le informazioni relative alle risorse MQSeries che devono essere utilizzate
dai messaggi che passano attraverso MQSeries Internet Gateway, sono
trasportate usando le seguenti parole chiave:
- MQIGwQueue
- Nome coda applicazione MQSeries - la coda nella quale viene messo il
messaggio
- MQIGwReplyQueue
- Nome coda MQSeries Gateway - la coda dalla quale MQSeries Internet
Gateway richiama i messaggi
- MQIGwQueueManager
- Nome del gestore coda di MQSeries che deve essere utilizzato
- MQIGwWaitInterval
- Il tempo di attesa di risposta in millisecondi da parte del gateway.
- MQIGwWaitHTML
- Il nome del file HTML che deve essere visualizzato se si verifica
un supero tempo.
Questo HTML deve contenere un messaggio che indichi che il tempo di
attesa è scaduto, e deve contenere inoltre un pulsante che consenta
alla risposta del messaggio di essere richiamata successivamente. Consultare
Scrittura dei moduli HTML per
MQSeries Internet Gateway per avere un esempio di una pagina di supero tempo,
timedout.htm,
memorizzato nell'indirizzario dei file
Gateway dell'installazione.
- MQIGwContext
- Quali informazioni relative al contesto devono essere inviate
all'applicazione.
Questa parola chiave può essere impostata sui seguenti valori:
- Nessuna
- Nessuna delle informazioni relative al contesto viene passata
all'applicazione di trasferimento.
- Tutte.
- Tutte le seguenti informazioni relative al contesto vengono
passate all'applicazione di trasferimento:
- AUTH_TYPE | - REQUEST_METHOD | - QUERY_STRING |
- HTTP_ACCEPT | - REMOTE_HOST | - REMOTE_USER |
- HTTP_REFERER | - REMOTE_ADDR | - REMOTE_IDENT |
- HTTP_USER_AGENT | - SCRIPT_NAME | - SERVER_SOFTWARE |
- HTTP_RESPONSE | - CONTENT_TYPE | - SERVER_NAME |
- HTTP_REASON | - CONTENT_LENGTH | - GATEWAY_INTERFACE |
- SERVER_PROTOCOL | - PATH_INFO |
- SERVER_PORT | - PATH_TRANSLATED |
Fare clic qui per consultare gli esempi
delle informazioni restituite quando viene impostata la parola chiave.
- MQIGwIniFile
- Il nome di un file INI che può essere utilizzato per trattenere i
valori assunti per ciascuna delle altre parole chiave.
Il valore per queste parole chiave può essere fornito nei seguenti modi:
- Tutte le parole chiave possono avere valori specificati nel modulo
HTML che viene utilizzato per inviare messaggi tramite il Gateway.
Nota: Questo è l'unica ubicazione che può essere impostato
MQIGwIniFile
se si desidera utilizzare i valori che sono memorizzati nel proprio file
denominato 'INI'. (Vedere (2) sotto.)
- I valori della parola chiave possono essere memorizzati nei propri
file denominati 'INI'
- I valori assunti per le seguenti parole chiave si trovano
nel file 'dmq.ini' fornito con MQSeries Internet Gateway e si
trova in /var/mqm su piattaforme UNIX e mqm\bin su OS/2 e Windows NT.
- MQIGwReplyQueue
- DMQGATEWAY
- MQIGwWaitInterval
- 10000 ms
- MQIGwContext
- Tutte
Nota: Sebbene ciascuna parola chiave può essere impostata in
ciascuna o in tutte le ubicazioni sopra descritte, fare attenzione a
non definire una parola chiave particolare più di una volta in
ciascuna ubicazione poiché ciò può causare dei problemi inaspettati.
MQSeries Internet Gateway ricerca le diverse risorse della
definizione della parola chiave nel seguente ordine:
- modulo HTML
- file 'INI' denominato nella parola chiave MQIGwIniFile
- file dmq.ini
Se non vengono trovati dei valori validi per le seguenti parole chiave,
vengono utilizzati i valori assunti di base:
- MQIGwQueueManager
- Il valore assunto di base è il gestore coda assunto MQSeries
Nota: In MVS non esiste alcun gestore coda assunto ed è
necessario impostare il valore di MQIGwQueueManager seguendo uno dei
metodi sopra descritti.
- MQIGwWaitInterval
- Il valore assunto di base è l'intervallo di attesa illimitato
- MQIGwWaitHTML
- Il valore assunto di base è 'timedout.htm' memorizzato nell'
indirizzario dei file Gateway della
propria installazione.
- MQIGwContext
- Il valore assunto di base è all
Se non vengono trovati dei valori validi per ciascuna delle seguenti parole
chiave, la transazione non può essere completata e viene visualizzato
un messaggio di errore:
- MQIGwQueue
- MQIGwReplyQueue
- MQIGwQueueManager
È possibile modificare il valore dei valori assunti della parola
chiave
in 'dmq.ini', ed è possibile inoltre creare i propri file per
memorizzare i valori della parola chiave.
Un programma di configurazione viene fornito con MQSeries Internet Gateway
per aiutare l'utente nella modifica e nella creazione del valore assunto
e dei file 'INI'.
Nota: Viene vivamente consigliato l'utilizzo di questo
programma e si consiglia di non utilizzare un editor per modificare o
editare i file 'INI'. Gli editor possono corrompere il formato dei
file 'INI'.
Il programma di configurazione viene fornito come file HTML che può
essere eseguito in un browser Web.
Utilizzare la seguente procedura per
eseguire la configurazione.
- Aprire il file MQSeries Internet Gateway 'dmqcnf.htm' col browser Web.
(Nota: Il programma non opererà da questo collegamento se si
sta visualizzando la documentazione installata sulla macchina del
server Web.)
Questo file viene memorizzato nell'indirizzario della documentazione
dell'installazione MQSeries Internet Gateway.
- Quando appare il pannello,
- Se si desidera modificare il file INI assunto (dmq.ini)
fornito con il gateway, fare clic sul pulsante Inoltra
- Se si desidera modificare o creare un altro file INI, immettere
il nome del file e fare quindi clic su Inoltra
- Viene visualizzato un pannello che mostra le parole chiave e i
rispettivi valori nel file che si è scelto.
- Se si desidera modificare il valore di una delle parole chiave
visualizzate, sovrascrivere il valore corrente
- Se si desidera modificare il valore assunto di un'altra parola
chiave, digitare il valore della parola chiave nel campo di
immissione Nome e il nuovo valore nel campo Valore .
- Se si desidera cancellare una parola chiave dall'elenco dei
valori assunti, fare clic sulla casella cancella accanto alla
parola chiave.
Nota:Si consiglia di non cancellare le parole chiave
MQSeries Internet Gateway dal file 'dmq.ini' . Se si cancella
MQIGwQueueManager, MQIGwReplyQueue, o MQIGwQueue
da questo file, e non si forniscono valori in un altro file INI
specificato, oppure il proprio modulo HTML, la transazione potrebbe
non completarsi.
-
- Se si desidera salvare le modifiche apportate al file visualizzato nel
campo Salva con nome, fare clic su Applica
- Se si desidera salvare il file modificato con un nuovo nome,
immettere il nuovo nome nel campo Salva con nome fare quindi
clic su Applica
L'elenco della parola chiave viene aggiornato con le modifiche,
Se si è scelto di salvare su un file già esistente che contiene
alcune parole chiave, viene visualizzato l'elenco completo delle parole
chiave nel file.
- Se si desidera aggiungere ulteriori parole chiave, oppure
apportare ulteriori modifiche ai valori presenti nell'elenco, ripetere
le procedure sopra descritte.
Nota: Gli spazi vuoti inseriti non sono consentiti nei nomi
delle parole chiave.
Se si è modificato il file 'dmq.ini' , i nuovi valori verranno
utilizzati come valori assunto la prossima volta che si utilizza
MQSeries Internet Gateway per inviare un messaggio MQ. Se si è
modificato o creato il proprio file 'INI', i nuovi valori verranno
utilizzati la prossima volta che si utilizza un formato che imposta
la parola chiave MQIGwIniFile sul nome file 'INI'.
![[Aiuto]](images/help.gif)
[ Home | Ordinare | Ricercare | Contattare IBM | Legale ]
(C) IBM Corporation 1997. 1999. Tutti i diritti riservati