[Release 5.1 e successive]Impostazioni della produzione connessioni code di WebSphere MQ

Utilizzare questo pannello per visualizzare o modificare le proprietà di configurazione della produzione connessioni code selezionata da utilizzare con il provider JMS di WebSphere MQ. Tali proprietà di configurazione controllano la modalità di creazione delle connessioni alla destinazione coda JMS associata.

Una produzione connessioni code viene utilizzata per creare connessioni JMS alle destinazioni code. La produzione connessioni code viene creata dal provider JMS di WebSphere MQ. Una produzione connessioni code per il provider JMS di WebSphere MQ ha le seguenti proprietà.

Nota:

Per visualizzare questa pagina della console di gestione, fare clic su Risorse-> Provider JMS WebSphere MQ-> (Nel pannello contenuto, in Ulteriori proprietà) Produzioni connessioni code WebSphere MQ-> produzioni_connessioni

Nome
Il nome attribuito a questa produzione connessioni code per scopi di gestione all'interno di IBM WebSphere Application Server. È necessario che il nome sia univoco all'interno delle produzioni connessioni JMS sul dominio di gestione WebSphere.
Tipo dati Stringa
Nome JNDI
Il nome JNDI utilizzato per collegare la produzione connessioni allo spazio nome del server delle applicazioni.

Per convenzione, utilizzare il nome completo JNDI; ad esempio, nel formato jms/Nome, dove Nome è il nome logico della risorsa.

Tale nome viene utilizzato per il collegamento alle informazioni specifiche della piattaforma. Il collegamento associa le risorse definite dal descrittore di distribuzione del modulo alle risorse effettive (fisiche) collegate a JNDI dalla piattaforma.

Tipo dati Stringa
Descrizione
Una descrizione di questa produzione connessioni per scopi di gestione all'interno di IBM WebSphere Application Server.
Tipo dati Stringa
Predefinito Nullo
Categoria
Una categoria utilizzata per classificare o raggruppare questa produzione connessioni per i record di gestione IBM WebSphere Application Server.
Tipo dati Stringa
Alias dell'autenticazione gestita dal componente
Questo alias specifica l'ID utente e la password da utilizzare per autenticare la connessione a un provider JMS per l'autenticazione gestita dall'applicazione.

Questa proprietà fornisce un elenco degli alias delle voci dati di autenticazione J2C definite su WebSphere Application Server. Si può selezionare un alias delle voci dati da utilizzare per autenticare la creazione di una nuova connessione sul provider JMS.

Se è stata abilitata la sicurezza globale per WebSphere Application Server, selezionare l'alias che specifica l'ID utente e la password utilizzati per autenticare la creazione di una nuova connessione al provider JMS. L'uso di questo alias dipende dall'impostazione (res-auth) dell'autenticazione risorsa, come descritto nel riferimento di risorsa della produzione connessioni dei descrittori di distribuzione di un componente dell'applicazione.

Nota:

  1. Gli ID utente più lunghi di 12 caratteri non possono essere utilizzati per l'autenticazione con il provider WebSphere JMS incorporato. Ad esempio, l'ID utente predefinito di Windows NT, Amministratore, non è valido per essere utilizzato con la messaggistica di WebSphere incorporato, in quanto contiene 13 caratteri. Per questo motivo, un alias di autenticazione, di una produzione connessioni del provider JMS di WebSphere deve specificare un ID utente non superiore a 12 caratteri.
  2. Per utilizzare una connessione JMS del provider JMS WebSphere MQ quando si usa la modalità di trasporto collegamenti, impostare la proprietà Tipo di trasporto=BINDINGS su Produzione connessioni code WebSphere MQ. È anche possibile selezionare una delle seguenti opzioni:
    • Per utilizzare le credenziali di sicurezza, accertarsi che l'utente specificato sia quello considerato collegato dal processo di WebSphere Application Server. Se l'utente specificato non è quello considerato collegato dal processo di WebSphere Application Server, l'autenticazione dei collegamenti JMS WebSphere MQ genera un errore "MQJMS2013 è stata fornita un'autenticazione di sicurezza non valida per MQQueueManager".
    • Non specificare credenziali di sicurezza. Sulla produzione connessioni WebSphere MQ, accertarsi che le proprietà Alias dell'autenticazione gestita dal componente e Alias dell'autenticazione gestita dal contenitore non siano impostate.

Alias dell'autenticazione gestita dal contenitore
Questo alias specifica l'ID utente e la password da utilizzare per autenticare la connessione a un provider JMS per un'autenticazione gestita dal contenitore.

Questa proprietà fornisce un elenco degli alias delle voci dati di autenticazione J2C definite su WebSphere Application Server. Si può selezionare un alias delle voci dati da utilizzare per autenticare la creazione di una nuova connessione sul provider JMS.

Se è stata abilitata la sicurezza globale per WebSphere Application Server, selezionare l'alias che specifica l'ID utente e la password utilizzati per autenticare la creazione di una nuova connessione al provider JMS. L'uso di questo alias dipende dall'impostazione (res-auth) dell'autenticazione risorsa, come descritto nel riferimento di risorsa della produzione connessioni dei descrittori di distribuzione di un componente dell'applicazione.

Nota:

  1. Gli ID utente più lunghi di 12 caratteri non possono essere utilizzati per l'autenticazione con il provider WebSphere JMS incorporato. Ad esempio, l'ID utente predefinito di Windows NT, Amministratore, non è valido per essere utilizzato con la messaggistica di WebSphere incorporato, in quanto contiene 13 caratteri. Per questo motivo, un alias di autenticazione, di una produzione connessioni del provider JMS di WebSphere deve specificare un ID utente non superiore a 12 caratteri.
  2. Per utilizzare una connessione JMS del provider JMS WebSphere MQ quando si usa la modalità di trasporto collegamenti, impostare la proprietà Tipo di trasporto=BINDINGS su Produzione connessioni code WebSphere MQ. È anche possibile selezionare una delle seguenti opzioni:
    • Per utilizzare le credenziali di sicurezza, accertarsi che l'utente specificato sia quello considerato collegato dal processo di WebSphere Application Server. Se l'utente specificato non è quello considerato collegato dal processo di WebSphere Application Server, l'autenticazione dei collegamenti JMS WebSphere MQ genera un errore "MQJMS2013 è stata fornita un'autenticazione di sicurezza non valida per MQQueueManager".
    • Non specificare credenziali di sicurezza. Sulla produzione connessioni WebSphere MQ, accertarsi che le proprietà Alias dell'autenticazione gestita dal componente e Alias dell'autenticazione gestita dal contenitore non siano impostate.

Gestore code
Il nome del gestore code WebSphere MQ della produzione di connessioni prescelta. Le connessioni create da questa produzione vengono collegate al gestore code.
Tipo dati Stringa
Predefinito Nullo
Intervallo Un nome del gestore code WebSphere MQ valido, con un massimo di 48 caratteri ASCII
Host
Il nome dell'host su cui è in esecuzione il gestore code WebSphere MQ, solo per connessioni client.
Tipo dati Stringa
Predefinito Nullo
Intervallo Un nome host TCP/IP valido
Porta
Il numero della porta TCP/IP utilizzata per la connessione al gestore code WebSphere MQ, solo per connessioni client.

È necessario configurare questa porta sul gestore code WebSphere MQ.

Tipo dati Numero intero
Predefinito Nullo
Intervallo Un numero porta TCP/IP valido, configurato sul gestore code WebSphere MQ.
Canale
Il nome del canale utilizzato per la connessione al gestore code WebSphere MQ, solo per la connessione client.
Tipo dati Stringa
Predefinito Nullo
Intervallo Da 1 a 20 caratteri ASCII
Tipo di trasporto
Specifica se la connessione client WebSphere MQ o i collegamenti JNI vengono utilizzati per la connessione al gestore code WebSphere MQ. Il provider JMS esterno controlla i protocolli di comunicazione tra i client JMS e i server JMS. Ottimizzare il tipo di trasporto quando si utilizza la messaggistica non transazionale, non duratura, non persistente non-ASF o quando si desidera soddisfare requisiti di sicurezza e il client è locale rispetto al nodo gestore code.
Tipo dati Enum
Unità Non applicabile
Predefinito BINDINGS
Intervallo
BINDINGS
I collegamenti JNI vengono utilizzati per collegarsi al gestore code. BINDINGS è un protocollo di memoria condivisa e può essere solo utilizzato quando il gestore code si trova sullo stesso nodo del client JMS e si verificano dei rischi di sicurezza che dovrebbero essere risolti utilizzando i ruoli EJB.

Per utilizzare una connessione JMS del provider JMS WebSphere MQ quando si usa la modalità di trasporto collegamenti, impostare la proprietà Tipo di trasporto=BINDINGS su Produzione connessioni code WebSphere MQ. È anche possibile selezionare una delle seguenti opzioni:

  • Per utilizzare le credenziali di sicurezza, accertarsi che l'utente specificato sia quello considerato collegato dal processo di WebSphere Application Server. Se l'utente specificato non è quello considerato collegato dal processo di WebSphere Application Server, l'autenticazione dei collegamenti JMS WebSphere MQ genera un errore "MQJMS2013 è stata fornita un'autenticazione di sicurezza non valida per MQQueueManager".
  • Non specificare credenziali di sicurezza. Sulla produzione connessioni WebSphere MQ, accertarsi che le proprietà Alias dell'autenticazione gestita dal componente e Alias dell'autenticazione gestita dal contenitore non siano impostate.

CLIENT
La connessione client WebSphere MQ viene utilizzata per collegarsi al gestore code. CLIENT è un protocollo basato su TCP tipico.
DIRECT
Per WebSphere MQ Event Broker che utilizza la modalità DIRECT. DIRECT è un protocollo dei socket leggero utilizzato nella messaggistica Pubblicazione/sottoscrizione non persistente, non duratura e non transazionale. DIRECT funziona solo per i client e i bean basati sui messaggi che utilizzano il protocollo non-ASF.
QUEUED
QUEUED è un protocollo TCP standard.
Consigliato
Tipo di trasporto della produzione connessioni code
BINDINGS è più veloce del 30% o anche di più, ma è privo di sicurezza. Se si hanno problemi di sicurezza, si consiglia BINDINGS anziché CLIENT.
Tipo di trasporto della produzione connessioni argomenti
DIRECT è più veloce e dovrebbe essere utilizzato dove possibile. Utilizzare BINDINGS quando si desidera soddisfare le attività aggiuntive di sicurezza e il gestore code è locale sul client JMS. QUEUED è fallback in tutti gli altri casi. Notare che WebSphere MQ 5.3 prima di CSD2 con l'impostazione DIRECT poteva perdere i messaggi quando veniva utilizzato con i bean basati sui messaggi e in condizioni di sovraccarico. Ciò si verifica anche con le applicazioni basate sul lato client a meno che maxClientQueueSize del broker non sia impostato su 0. È possibile impostare questo valore su 0 con il comando #wempschangeproperties WAS_nodeName_server1 -e default -o DynamicSubscriptionEngine -n maxClientQueueSize -v 0 -x executionGroupUUID, dove è possibile individuare executionGroupUUID avviando il broker ed eseguendo una ricerca nel Registro eventi/Applicazioni per l'evento 2201. Questo valore è in genere ffffffff-0000-0000-000000000000.
Definizione coda modello
Il nome della definizione della coda modello che può essere utilizzata dal gestore code per creare code temporanee se la coda richiesta non esiste già.
Tipo dati Stringa
Predefinito Nullo
Intervallo Da 1 a 48 caratteri ASCII
ID Client
L'identificativo client JMS utilizzato per effettuare le connessioni al gestore code WebSphere MQ.
Tipo dati Stringa
Predefinito Nullo
CCSID
L'identificatore di un insieme di caratteri codificati da utilizzare con il gestore code WebSphere MQ.

È necessario che questo identificatore di un insieme di caratteri codificati (CCSID) sia del tipo supportato da WebSphere.

Tipo dati Stringa
Unità Numero intero
Predefinito Nullo
Intervallo Da 1 a 65535

Per ulteriori informazioni sui CCSID supportati e sulla conversione dei dati dei messaggi da un insieme di caratteri codificati a un altro, consultare i manuali WebSphere MQ System Administration e WebSphere MQ Application Programming Reference. Questi sono disponibili sulle pagine Web dei manuali specifici della piattaforma e della multipiattaforma di messaggistica WebSphere MQ; ad esempio all'indirizzoÈ possibile accedere alla destinazione solo quando
questo argomento è collegato a World Wide Web   http://www-3.ibm.com/software/ts/mqseries/library/manualsa/manuals/platspecific.html , È possibile accedere alla destinazione solo quando
questo argomento è collegato a World Wide Web   IBM Publications Center o dal Kit di raccolta WebSphere MQ, SK2T-0730.

Conservazione messaggi
Selezionare questa casella di controllo per specificare che i messaggi indesiderati devono essere lasciati sulla coda. In caso contrario, i messaggi indesiderati vengono gestiti in base alle opzioni specificate.
Tipo dati Enum
Unità Non applicabile
Predefinito Deselezionato
Intervallo
Selezionata
I messaggi indesiderati vengono lasciati sulla coda.
Deselezionato
I messaggi indesiderati vengono gestiti in base alle opzioni specificate.
Abilitato XA
Specifica se la produzione connessioni è per un coordinamento messaggi e controlli XA o non-XA se il server delle applicazioni utilizza XA QCF/TCF. Abilitare XA se non si utilizzano risorse multiple nella stessa transazione.

Se si imposta questa proprietà su NON_XA, la sessione JMS è ancora elencata in una transazione, ma utilizza le chiamate di transazione locale del gestore risorse (session.commit e session.rollback) piuttosto che le chiamate XA. Questo porta ad un miglioramento delle prestazioni. Tuttavia, ciò vuol dire che è possibile elencare solo una singola risorsa in una transazione di WebSphere Application Server. In WebSphere Application Server Enterprise il supporto ultimo partecipante consente di elencare una risorsa non-XA insieme ad altre risorse XA.

Per la produzione connessioni argomenti WebSphere con la proprietà Porta impostata su DIRECT questa proprietà non viene applicata e assume sempre il valore NON_XA.

Tipo dati Enum
Unità Non applicabile
Predefinito Abilitato XA
Intervallo
XA
La produzione connessioni è per un coordinamento messaggi XA
NON_XA
La produzione connessioni è per un coordinamento messaggi non-XA
Consigliato Non abilitare XA quando la coda messaggi o l'argomento ricevuto è l'unica risorsa presente nella transazione. Abilitare XA quando sono presenti altre risorse, incluse altre code o argomenti.
Lotto connessioni
Specifica un insieme facoltativo di impostazioni lotto connessioni.

Le proprietà del lotto connessioni sono comuni a tutti i connettori J2C.

Il server delle applicazioni raggruppa in lotti le connessioni e le sessioni insieme al provider JMS, per migliorare le prestazioni. Questo non dipende da nessun lotto connessioni di WebSphere MQ. È necessario configurare, per le applicazioni, le proprietà del lotto sessioni e connessioni in modo appropriato, altrimenti potrebbe essere difficile richiamare la funzione di connessione e sessione desiderata.

Modificare le dimensioni del lotto connessioni se l'accesso simultaneo lato server alla risorsa JMS supera il valore predefinito. Le dimensioni del lotto connessioni sono impostate su base dell'argomento o della coda. Per i dettagli, consultare la seguente tabella.

Lotto sessioni
Un insieme facoltativo di impostazioni dei lotti di sessioni.

Questo collegamento fornisce un pannello di proprietà lotto connessioni facoltative, comuni a tutti i connettori.

Il server delle applicazioni raggruppa in lotti le connessioni e le sessioni insieme al provider JMS, per migliorare le prestazioni. Questo non dipende da nessun lotto connessioni di WebSphere MQ. È necessario configurare, per le applicazioni, le proprietà del lotto sessioni e connessioni in modo appropriato, altrimenti potrebbe essere difficile richiamare la funzione di connessione e sessione desiderata.

Proprietà personalizzate
Una serie facoltativa di coppie nome e valore per le proprietà personalizzate inviate a WebSphere MQ.

È possibile utilizzare la pagina Proprietà personalizzate per definire le seguenti proprietà SSL (Secure Sockets Layer) WebSphere MQ. Queste proprietà vengono applicate solo se si imposta la proprietà Tipo di trasporto=CLIENT.

Per ulteriori informazioni sull'impostazione di queste proprietà, consultare la sezione SSL properties nel manuale WebSphere MQ Using Java.