Documentazione readme per IBM WebSphere Message Broker, per la versione 8.0.0.0 dei componenti di runtime e strumenti.
File readme per: IBM WebSphere Message Broker
Release prodotto/componente: 8.0
Data di pubblicazione: 9 dicembre 2011
Data di ultima modifica: 9 dicembre 2011
Utilizzare sempre l'ultima versione di questo file readme, che è disponibile solo in inglese in:
http://www.ibm.com/support/docview.wss?uid=swg27006917
Le versioni tradotte del file readme si trovano in:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/
Per informazioni relative alle attività da completare prima di installare il prodotto, fare riferimento al centro informazioni di WebSphere Message Broker V8.0 all'indirizzo:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
Controllare i requisiti di sistema di WebSphere Message Broker per verificare che la piattaforma di installazione sia supportata per l'edizione del prodotto che si intende installare. La pagina Web relativa ai requisiti di sistema di
WebSphere Message Broker è disponibile al seguente indirizzo:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Su Windows sono disponibili due edizioni di WebSphere Message Broker V8.0:
L'edizione a 64 bit di WebSphere Message Broker non è supportata su tutte le versioni a 64 bit del sistema operativo Windows. Per ulteriori informazioni, consultare la pagina Web dei requisiti di sistema di WebSphere Message Broker.
Applicazione del servizio a z/OS
Se si sta applicando il servizio a z/OS, i pacchetti PTF (Program Temporary Fix) devono essere scaricati come file binari e quindi trasferiti a z/OS:
Organization . . . : PS
Record format . . . : FB
Record length . . . : 1024
Block size . . . . : 6144
1st extent tracks . : 500
Secondary tracks . : 50
È possibile utilizzare il seguente JCL (Job Control Language) di esempio per assegnare questi dataset:
/* INSERT A VALID JOBCARD HERE
//*
//ALLOCATE EXEC PGM=IEFBR14
//SYSMOD1 DD DSN=YOUR HIGH LEVEL QUALIFIER (HLQ).PTF NUMBER.TRS,
// DISP=(NEW,CATLG,DELETE),
// UNIT=SYSDA,
// SPACE=(TRK,(500,50),RLSE),
// DSORG=PS,
// DCB=(RECFM=FB,LRECL=1024,BLKSIZE=6144)
//*
put PTF NUMBER.TRS 'YOUR HLQ.PTF NUMBER.TRS' (replace
È possibile utilizzare il seguenti JCL di esempio per decomprimere i dataset dopo aver apportato le modifiche e aver aggiunto una scheda di lavoro adatta:
//*****************************************************
//* UNTERSE APAR
//*****************************************************
/UNPACK EXEC PGM=TRSMAIN,PARM='UNPACK'
//STEPLIB DD DISP=SHR,DSN=TERSE.LOADLIB
//SYSPRINT DD SYSOUT=*
//INFILE DD DSN=YOUR HLQ.PTF NUMBER.TRS,
// DISP=SHR
//OUTFILE DD DSN=YOUR HLQ.PTF NUMBER,
// DISP=(NEW,CATLG),
// SPACE=(TRK,(1000,100,))
/*
Se si sta eseguendo la migrazione da WebSphere Message Broker versione 6.1 o versione 7.0, fare riferimento al centro informazioni in linea all'indirizzo http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp, che fornisce informazioni dettagliate relative alla migrazione.
Il centro informazioni in linea di WebSphere Message Broker V8.0 è disponibile all'indirizzo:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
Consultare sempre il centro informazioni in linea, che contiene informazioni più aggiornate rispetto al centro informazioni fornito con Message Broker Toolkit, per ricevere le ultime informazioni sul prodotto.
Il centro informazioni di WebSphere Message Broker per V8.0 GA contiene la documentazione per la registrazione e visualizzazione dei dati. Tuttavia, non contiene informazioni sulla riproduzione dei dati.
È stato fornito un PDF che include la documentazione completa più aggiornata relativa alla registrazione, visualizzazione e riproduzione di dati. Per scaricare il PDF, consultare la nota tecnica disponibile all'indirizzo:
www.ibm.com/support/docview.wss?uid=swg21573603
È possibile scaricare il centro informazioni autonomo all'indirizzo:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_linux.tgz (versione
Linux)
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_win.zip (versione
Windows)
Leggere il file using_the_infocenter.html incluso nella cartella ibm_help all'interno dei file wmb_help_linux.tgz e wmb_help_win.zip.
Difetti: Questo file readme potrebbe contenere riferimenti ai numeri di difetto. Tali numeri si riferiscono ai numeri di problema IBM interni; è possibile che questi numeri siano utili durante la discussione dei problemi con l'assistenza tecnica IBM.
Note tecniche: per informazioni aggiornate relative ai problemi noti e alle correzioni disponibili, consultare il sito Web di supporto di WebSphere Message Broker all'indirizzo:
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_Message_Broker
Per trovare le informazioni, fare clic su Risoluzione dei problemi. Vengono visualizzate le note tecniche di WebSphere Message Broker, che possono essere ordinate e in cui è possibile effettuare delle ricerche.
Per informazioni sul download delle immagini di installazione di WebSphere Message Broker versione 8.0 dal sito Web Passport Advantage, consultare il documento di download Download WebSphere Message Broker V8.0 from the
Passport Advantage website disponibile all'indirizzo:
http://www.ibm.com/support/docview.wss?uid=swg24030968
Versioni: per informazioni aggiornate relative a particolari versioni di sistemi operativi e database supportate da WebSphere Message Broker, consultare la pagina dei requisiti di sistema
all'indirizzo:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/index.html
Ricercare periodicamente aggiornamenti per WebSphere Message Broker Toolkit, inclusi gli aggiornamenti alla documentazione in lingua inglese e nelle altre lingue supportate. Le correzioni consigliate per WebSphere Message Broker sono disponibili all'indirizzo:
http://www.ibm.com/support/docview.wss?uid=swg27006041
I dettagli relativi alle novità della versione 8.0 sono disponibili all'indirizzo:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp?topic=/com.ibm.etools.mft.doc/bb23110_.htm
Questa sezione illustra i problemi noti di WebSphere Message Broker e le eventuali soluzioni temporanee, divisi per componente.
Sintomi:
Se si esegue il programma di disinstallazione uninstaller.exe di WebSphere Message Broker su Windows 7 o Windows Server 2008 R2, è possibile che venga visualizzata una finestra di dialogo che indica che il file di disinstallazione non è firmato.
Soluzione:
È possibile ignorare questa avvertenza. Continuare il processo di disinstallazione.
Sintomi:
Se si installa un prodotto IBM tramite un'immagine elettronica di IBM Passport Advantage e si utilizza Windows XP Service Pack 2 o versione successiva, le impostazioni sulla sicurezza di Windows potrebbero comportare il blocco del contenuto del file .zip del programma di installazione da parte della Gestione allegati, causando un errore di installazione.
Soluzione:
Per risolvere questo problema, completare la seguente procedura:
Per ulteriori informazioni sulla Gestione allegati di Windows, consultare il sito di supporto Microsoft all'indirizzo: http://support.microsoft.com/kb/883260
L'immagine di installazione per il componente runtime di WebSphere Message Broker V8.0 GA ha superato il limite di 700 MB consigliato per un CD fisico. Per questo motivo, l'immagine di installazione per la piattaforma HP-UX
viene fornita su un DVD fisico anziché su un CD. L'immagine di installazione per il componente runtime di WebSphere Message Broker V8.0 GA è disponibile anche sul sito Web Passport Advantage.
Per informazioni sul download delle immagini di installazione di WebSphere Message Broker versione 8.0 dal sito Web Passport Advantage, consultare il documento di download Download WebSphere Message Broker V8.0 from the
Passport Advantage website disponibile all'indirizzo:
http://www.ibm.com/support/docview.wss?uid=swg24030968
WebSphere Message Broker è supportato su Ubuntu, ma soltanto per i sistemi di sviluppo. I sistemi di produzione non devono essere utilizzati per eseguire WebSphere Message Broker su Ubuntu.
Per ulteriori informazioni, consultare la pagina dei requisiti di sistema di WebSphere Message Broker. La pagina Web relativa ai requisiti di sistema di WebSphere Message Broker è disponibile al seguente indirizzo:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Sintomi
Durante il tentativo di connettere un nodo con più terminali di output ad altri nodi, non viene creata una connessione.
Soluzione
Per risolvere questo problema, completare uno dei seguenti passi:
Per connettere WebSphere Message Broker Explorer a un gestore code al fine di ricevere le pubblicazioni, è necessario che la proprietà SHARECNV sul canale SVRCONN di tale gestore code abbia un valore maggiore di 0. Questo valore è obbligatorio se si desidera utilizzare le viste Statistiche broker o Grafico statistiche broker in WebSphere Message Broker Explorer.
Sintomo:
Dopo aver eseguito la migrazione di WebSphere Message Broker Toolkit e delle relative risorse alla versione 8.0, è possibile che in WebSphere Message Broker Toolkit vengano visualizzati degli elementi rimossi nella V8.0, come ad esempio le opzioni dei toolkit precedenti all'interno dei menu.
Soluzione:
Per risolvere questo problema, completare la seguente procedura:
Sintomo:
Dopo aver eseguito la migrazione di WebSphere Message Broker Toolkit e delle rispettive risorse alla versione 8.0, è possibile che vengano visualizzati degli errori non definiti.
Soluzione:
Con lo spazio di lavoro V8.0 aperto in WebSphere Message Broker Toolkit, selezionare Progetto > Cancella... > Cancella tutti i progetti. I messaggi di errore non definiti vengono rimossi.
Sintomo:
Quando si importano risorse in un nuovo spazio di lavoro, una volta completato il build automatico potrebbero essere visualizzati dei messaggi di errore.
Soluzione:
Nella vista Sviluppo broker, selezionare i progetti e fare clic con il tasto destro del mouse su Progetto > Pulisci per creare nuovamente i progetti. Una volta ripuliti i progetti, i messaggi di errore relativi all'importazione vengono rimossi.
mqsicreatebar potrebbe richiedere la ripulitura del progettoSintomo:
Quando si esegue il comando mqsicreatebar e si specifica un nuovo spazio di lavoro, potrebbero essere visualizzati dei messaggi di errore.
Soluzione:
Utilizzare l'opzione -cleanBuild durante l'esecuzione del comando mqsicreatebar per ripulire i progetti.
Sintomo:
Quando si utilizza il centro informazioni incluso in WebSphere Message Broker Toolkit V8.0.0.0 GA, gli argomenti DFDL (Data Format Description Language) vengono visualizzati solo in lingua inglese US.
Questi argomenti hanno l'identificativo "dfxxxxx_", dove "xxxxx" è un numero a cinque cifre.
Soluzione:
Per visualizzare questi argomenti in una lingua diversa dall'inglese US, utilizzare il centro informazioni in linea. Il centro informazioni in linea per WebSphere Message Broker V8.0 contiene la documentazione tradotta più recente ed è disponibile all'indirizzo:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
Sintomi:
Durante la scoperta iterativa di WebSphere Adapter for SAP Software Enterprise Metadata Discovery (EMD), viene visualizzato il pannello Creazione servizio e configurazione distribuzione che può essere modificato dall'utente; tuttavia, qualsiasi informazione di connessione del sistema dell'adattatore immessa non viene salvata nel componente dell'adattatore.
Soluzione:
Modificare le informazioni di connessione del sistema dell'adattatore utilizzando l'editor di adattatori di WebSphere, al fine di garantire che le successive scoperte iterative EMD mantengano le informazioni:
Sintomi:
L'adattatore in entrata JDE non è in grado di eseguire la distribuzione se la casella di spunta assured delivery è selezionata nella procedura guidata dell'adattatore. Viene visualizzato il seguente errore:
An attempt to set the property 'AssuredOnceDelivery' on adapter component 'AssuredDeliveryMSApp.IBM WebSphere Adapter for JD Edwards EnterpriseOne' failed because the property is not supported.
Soluzione:
Questa funzionalità non è attualmente supportata e non deve essere utilizzata nello sviluppo dei flussi di messaggi.
Sintomi:
L'utilizzo di una mappa di dati grafici per associare i dati di input recuperati da un database dipende dalla configurazione del nome di schema predefinito del proprio server di database. Il broker non fornisce attualmente una funzione per sostituire il nome dello schema di database da utilizzare nelle istruzioni SQL emesse nel database. Al momento, l'istruzione SQL emessa dalla mappa include soltanto i nomi database e tabella, ma non un nome schema. Di conseguenza, il server di database utilizza il nome predefinito dello schema di database per l'identità che il broker utilizza per connettersi ad esso durante l'esecuzione della mappa. L'identità di connessione utilizzata dal broker viene configurata in un servizio configurabile JDBCProvider del broker. Il servizio configurabile JDBCProvider utilizzato viene selezionato in base al nome dell'origine dati nella mappa.
Se la tabella di database richiesta non è disponibile in questo schema, l'esecuzione della mappa non riesce e viene visualizzato un messaggio di errore del broker contenente specifici codici errore per il proprio server di database. Ad esempio:
BIP3947E: L'elaborazione della mappa per QName '{maps}:RDB_Mapping' ha avuto esito negativo, con i seguenti dettagli:
'{Codici e messaggi di errore di accesso specifici alla tabella dello schema di database}'
Soluzione:
Accertarsi che la tabella selezionata dalla mappa di dati grafici sia disponibile nello schema impostato dal server di database per l'identità di connessione del database configurata nel servizio configurabile JDBCProvider. Questo aspetto è particolarmente restrittivo su z/OS.
Sintomi:
Sui sistemi UNIX che utilizzano la shell Z (zsh) come ambiente shell, una chiamata a 'source {install path}/mqsiprofile' comporta la chiusura della shell. A causa del comportamento predefinito di zsh, il comando mqsiprofile controlla un numero di argomento errato per determinare se questo viene originato o eseguito direttamente. Lo script mqsiprofile stampa quindi un messaggio di avvertenza e richiama l'uscita, ma zsh interpreta questa chiamata come un'istruzione di chiusura della shell corrente.
Soluzione:
Per risolvere questo problema, completare il seguente passo:
Sintomo:
L'argomento an19545_ mqsiapplybaroverride del centro informazioni descrive i parametri -k e -y da utilizzare con applicazioni e librerie. L'utilizzo di questi parametri con il comando
comporta il seguente errore:
BIP1033E Parametri non validi
Soluzione:
Queste opzioni non sono supportate con il comando e non devono essere utilizzate.
I clienti che utilizzano dei database utente su z/OS necessitano di DB2 APAR PK99362.
Le transazioni globalmente coordinate ('XA') non sono supportate.
Le transazioni globalmente coordinate ('XA') JDBC/XA sono supportate su DB2 e Oracle (tranne Oracle RAC) su tutte le piattaforme broker tranne HP-UX su Itanium e z/OS.
ODBC XA e JDBC/XA non possono essere entrambi presenti sullo stesso broker.
Le transazioni globalmente coordinate ('XA') Informix non sono supportate.
Solo DB2 e Microsoft SQL Server sono supportati su Windows Server 2008 R2 e Windows 7 a 64 bit. Consultare le pagine dei requisiti di sistema per DB2 e Microsoft SQL Server per determinare le versioni corrette
di ciascun prodotto da utilizzare con il proprio sistema.
La pagina Web relativa ai requisiti di sistema di DB2 è disponibile al seguente indirizzo:
http://www.ibm.com/software/data/db2/linux-unix-windows/sysreqs.html
http://www.ibm.com/legal/copytrade.shtml
Tali informazioni sono state sviluppate per i prodotti ed i servizi offerti negli Stati Uniti d'America
È possibile che IBM non offra i prodotti, i servizi o le funzioni illustrate in questo documento in tutti i paesi. Consultare il rappresentante IBM locale per informazioni sui prodotti e sui servizi disponibili nel proprio paese. Qualsiasi riferimento a prodotti, programmi o servizi IBM contenuto in questo documento non significa che solo tali programmi, servizi o prodotti possano essere usati. In sostituzione a quelli forniti dall'IBM, possono essere usati prodotti, programmi o servizi funzionalmente equivalenti che non comportino violazione di diritti di proprietà intellettuale o di altri diritti dell'IBM. Valutazioni e verifiche operative in relazione ad altri prodotti, eccetto quelli espressamente previsti dall'IBM, sono di esclusiva responsabilità dell'utente.
L'IBM può avere brevetti o domande di brevetto in corso relativi a quanto trattato nella presente pubblicazione. La fornitura di questa pubblicazione non implica la concessione di alcuna licenza su di essi. Chi desiderasse ricevere informazioni o licenze, può rivolgersi a:
Per le licenze per i paesi DBCS (double-byte character set), contattare IBM Intellectual Property Department nel proprio paese o rivolgersi a:
Il seguente paragrafo non è valido per il Regno Unito o qualsiasi altro paese in cui alcune disposizioni non sono congruenti con la legge locale:
L'INTERNATIONAL BUSINESS MACHINES CORPORATION FORNISCE QUESTA PUBBLICAZIONE "COSI' COM'E'" SENZA ALCUN TIPO DI GARANZIA, SIA ESPRESSA CHE IMPLICITA, INCLUSE EVENTUALI GARANZIE DI COMMERCIABILITA' ED IDONEITA' AD UNO SCOPO PARTICOLARE. Alcuni stati non consentono la rinuncia a garanzie esplicite o implicite in determinate transazioni; quindi la presente dichiarazione potrebbe non essere a voi applicabile.
Questo documento potrebbe contenere imprecisioni tecniche o errori tipografici. Le correzioni relative saranno incluse nelle nuove edizioni del documento. L'IBM si riserva il diritto di apportare miglioramenti e/o modifiche al prodotto o al programma descritto nel manuale in qualsiasi momento e senza preavviso.
Ciascun riferimento in questa pubblicazione a siti non IBM è fornito unicamente a scopo informativo e non a scopo pubblicitario di tali siti web. Il materiale presente in tali siti web non fa parte del materiale fornito con questo prodotto IBM e l'utilizzo è a vostro rischio e pericolo.
La IBM potrebbe utilizzare o distribuire le informazioni appropriate senza incorrere in alcun obbligo verso l'utente.
Le licenze di questo programma dotato di informazioni sono valide per: (i) lo scambio delle informazioni tra i programmi creati indipendentemente e altri programmi (incluso il presente) e (ii) l'utilizzo comune delle informazioni, contattare:
È possibile che alcune informazioni siano disponibili, in base ai termini e alle condizioni appropriate, includendo in alcuni casi il pagamento di un costo.
Il programma concesso in licenza, descritto in questo documento e tutto il materiale concesso in licenza disponibile sono forniti dalla IBM nei termini dell'Accordo clienti IBM, Accordo di licenza di programmazione internazionale IBM o qualsiasi accordo equivalente.
Le informazioni relative ai prodotti non IBM sono state reperite dai fornitori di tali prodotti, annunci pubblicati e altre fonti disponibili. La IBM non ha verificato questi prodotti e non è in grado di confermare la precisione delle prestazioni, compatibilità o qualsiasi altro rilascio relativo ai prodotti non IBM. Le domande sulle funzioni di prodotti non IBM devono essere indirizzate ai fornitori di questi prodotti.
Tali informazioni includono gli esempi di dati ed i prospetti utilizzati nelle operazioni aziendali quotidiane. Per illustrarli in modo completo, gli esempi includono i nomi di individui, società, tipologie e prodotti. Tutti i nomi sono fittizi e qualsiasi somiglianza con i nomi e indirizzi utilizzati da una società attuale è casuale.
LICENZA SUL COPYRIGHT:
Tali informazioni contengono i programmi applicativi di esempio nella lingua di origine, che descrive le tecniche di programmazione su varie piatteforme operative. È possibile copiare, modificare e distribuire questi programmi di esempio in qualsiasi forma senza un pagamento alla IBM, per scopi di sviluppo, utilizzo, commerciali o di distribuzione dei programmi applicativi, compatibili all'interfaccia di programmazione applicativa per la piattaforma operativa per cui sono scritti i programmi di esempio. Questi esempi non sono stati verificati in tutte le condizioni. Quindi, la IBM, non può garantire o implicare affidabilità o il funzionamento di questi programmi. È possibile copiare, modificare e distribuire questi programmi applicativi in qualsiasi forma senza pagamento alla IBM per scopi di sviluppo, utilizzo, commerciale o di distribuzione dei programmi applicativi conformi alle interfacce di programmazione applicativa della IBM.
I seguenti termini sono marchi della International
Business Machines Corporation negli Stati Uniti e/o in altri paesi:
DB2, developerWorks, IBM, Informix, Passport Advantage, WebSphere, z/OS.
Java e tutti i marchi e i logo basati su Java sono marchi o marchi registrati di Oracle e/o di società affiliate negli Stati Uniti e/o in altri paesi
Microsoft e Windows sono marchi della Microsoft
Corporation negli Stati Uniti e/o in altri paesi.
UNIX è un marchio della The Open Group negli Stati Uniti
e/o in altri paesi.
Linux è un marchio della Linus Torvalds negli Stati Uniti e/o in altri paesi.
Altri nomi di servizio, prodotto e società sono marchi di altri.
Pagina del prodotto WebSphere Message Broker
http://www.ibm.com/software/integration/wbimessagebroker/
Fix Pack DB2
Se si dispone di un contratto di assistenza corrente, è possibile ordinare i Fix Pack DB2 su CD rivolgendosi all'assistenza DB2. In alternativa, è possibile scaricare i fix pack DB2 dal Web;
tuttavia le dimensioni di alcuni file di fix pack sono molto grandi, quindi la richiesta delle versioni su CD permette di evitare tempi di download lunghi.
I contatti del supporto DB2 e i download dei fix pack DB2 sono disponibili all'indirizzo:
http://www.ibm.com/software/data/db2/udb/support.html
Fix Pack WebSphere MQ
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_MQ
Fix Pack - WebSphere Message Broker
http://www.ibm.com/support/docview.wss?uid=swg27006041
Requisiti - WebSphere Message Broker
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
File readme - WebSphere Message Broker
http://www.ibm.com/support/docview.wss?uid=swg27006917
Centro informazioni autonomo - WebSphere Message Broker V8.0
Per Linux:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_linux.tgz
Per Windows:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_win.zip
Centro informazioni in linea di WebSphere Message Broker V8.0
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
Download nel centro IBM di sviluppo della tecnologia Java™
http://www.ibm.com/developerworks/java/jdk/
Specifica WSDL (Web Services Description Language)
http://www.w3.org/TR/wsdl
Area developerWorks di WebSphere Message Broker
http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html