IBM. Guida rapida. MQSeries per AS/400. Versione 5.1 GC

Transcript

1 MQSeries per AS/400 IBM Guida rapida Versione 5.1 GC

2

3 MQSeries per AS/400 IBM Guida rapida Versione 5.1 GC

4 Nota Prima di utilizzare questo prodotto e le relative informazioni, consultare la sezione Appendice C, Informazioni particolari a pagina 89. Prima edizione (marzo 2000) Questa edizione si applica a MQSeries per AS/400, versione 5 release 1, e a tutti i release e livelli di modifica seguenti se non altrimenti indicato nelle nuove edizioni. Copyright International Business Machines Corporation Tutti i diritti riservati.

5 Indice Benvenuti in MQSeries per AS/ v Convenzioni v Capitolo 1. Informazioni su MQSeries Accodamento messaggi Messaggi e code Oggetti MQSeries Client e server Eventi di strumentazione Supporto transazionale Capitolo 2. Nuovi elementi in MQSeries per AS/400, V Capitolo 3. Pianifica per l'installazione del server MQSeries per AS/ Requisiti hardware Requisiti software Connettività Librerie e indirizzari di installazione AS/ Compilatori supportati per le applicazioni MQSeries per AS/400, V Consegna Componenti MQSeries per AS/ Capitolo 4. Installazione, cancellazione e migrazione verso MQSeries per AS/ Requisiti di pre-installazione Procedura di installazione Verifica dell'installazione Disattivazione MQSeries Migrazione verso MQSeries per AS/400, V Verifica della migrazione Cancellazione di MQSeries per AS/400, V Capitolo 5. Utilizzo di MQSeries per AS/400, V Informazioni preliminari Introduzione alla serie di comandi Gestione di MQSeries Informazioni ulteriori Capitolo 6. Pianificazione dell'installazione di client MQSeries.. 37 Applicazioni sui client versione Client AIX: requisiti hardware e software Componenti per AIX Client Digital UNIX: requisiti hardware e software Client DOS: requisiti hardware e software Componenti per DOS Client HP-UX: requisiti hardware e software Componenti per HP-UX Client OS/2 Warp: requisiti hardware e software Componenti per OS/2 Warp Client Sun Solaris: requisiti hardware e software Componenti per Sun Solaris Copyright IBM Corp iii

6 Client Windows 3.1: requisiti hardware e software Componenti per Windows Client Windows 95 e Windows 98: requisiti hardware e software Componenti per Windows 95 e Windows Client Windows NT: requisiti hardware e software Componenti per Windows NT Capitolo 7. Installazione di client MQSeries Installazione di client MQSeries sulla stessa macchina del server Installazione su AIX Installazione in ambiente DOS Installazione in ambiente HP-UX Installazione in ambiente OS/2 Warp Installazione in ambiente Sun Solaris Installazione in ambiente Windows 95 o Windows Installazione in Windows Installazione su Windows NT Classi per Java Configurazione e verifica di un client Capitolo 8. Richiesta di ulteriori informazioni Manuali cartacei Informazioni in linea Appendice A. Programmi di esempio MQI Programmi di esempio C, COBOL e RPG Appendice B. Applicazione della manutenzione a MQSeries per AS/ Reinstallare MQSeries per AS/ Appendice C. Informazioni particolari Marchi Indice analitico Come inviare eventuali commenti Tabelle 1. Versioni lingua nazionale di MQSeries per AS/400, V Autorizzazioni richieste per aprire un oggetto Autorizzazioni per Context e AlternateUserID manuali MQSeries per AS/ Manuali MQSeries nomi file Programmi di esempio file di origine iv MQSeries per AS/400, V5.1 Guida rapida

7 Benvenuti in MQSeries per AS/400 Questo manuale descrive IBM MQSeries per AS/400, versione 5.1. Spiega come pianificare, installare e cominciare ad utilizzare il prodotto. Per le informazioni più recenti relative a MQSeries per AS/400, V5.1, fare riferimento anche al file readme sui CD-ROM dei manuali e al sito Web della famiglia MQSeries all'indirizzo: Convenzioni La conoscenza delle convenzioni utilizzate in questo manuale ne rende l'utilizzo più efficiente. Il carattere grassetto indica il nome di una voce che si deve selezionare. Il carattere corsivo indica i nuovi termini, i titoli dei manuali e le informazioni sulla variabile da sostituire con valori reali. Il carattere monospazio indica un esempio (come un percorso o un nome file fittizi) o il testo visualizzato sul pannello. Copyright IBM Corp v

8 vi MQSeries per AS/400, V5.1 Guida rapida

9 Capitolo 1. Informazioni su MQSeries Accodamento messaggi Questo capitolo introduce IBM MQSeries e ne descrive il funzionamento con altri prodotti. Contiene spiegazioni di base sui seguenti argomenti: Accodamento messaggi Messaggi e code a pagina 2 Oggetti MQSeries a pagina 3 Client e server a pagina 6 Eventi di strumentazione a pagina 7 Supporto transazionale a pagina 8 Per spiegazioni più dettagliate di questi argomenti, consultare MQSeries Guida alla pianificazione. MQSeries consente alle applicazioni di utilizzare l'accodamento messaggi per partecipare all'elaborazione di messaggi guidati. Le applicazioni possono comunicare tra diverse piattaforme, utilizzando i prodotti software di accodamento messaggi adeguati. Le applicazioni sono protette dalla meccanica delle comunicazioni di base. MQI un API (Application Programming Interface) comune Tutti i prodotti MQSeries implementano un API (application programming interface) comune (MQUI o message queue interface), senza tenere conto della piattaforma sulla quale sono in esecuzione le applicazioni. Le chiamate effettuate dalle applicazioni e i messaggi scambiati sono in comune. Ciò rende più semplice la scrittura e la gestione delle applicazioni rispetto all'utilizzo dei metodi tradizionali. Rende più semplice anche lo spostamento delle applicazioni da una piattaforma all'altra. MQI viene descritto in dettaglio nel manuale MQSeries Application Programming Reference. Applicazioni non dipendenti dal tempo Grazie all'accodamento di messaggi, lo scambio dei messaggi tra i programmi del mittente e del destinatario non dipende dal tempo. Ciò significa che le applicazioni di invio e ricezione vengono disgiunte; il mittente può continuare l'elaborazione senza dover attendere che il destinatario confermi la ricezione del messaggio. In realtà, quando si invia un messaggio, non è necessario eseguire l'applicazione di destinazione. E' possibile richiamare il messaggio quando comincia l'esecuzione. Procedura basata sui messaggi Una volta arrivati su una coda, i messaggi possono avviare automaticamente un'applicazione utilizzando una tecnica nota come triggering. Se è necessario, le applicazioni possono essere interrotte al termine dell'elaborazione di uno o più messaggi. Copyright IBM Corp

10 Messaggi e code I messaggi e le code sono i componenti di base di un sistema di accodamento messaggi. Cos'è un messaggio Un messaggio è una stringa di byte riconosciuta dalle applicazioni che la utilizzano. I messaggi vengono utilizzati per trasferire le informazioni da un'applicazione all'altra (o a diverse parti della stessa applicazione). Le applicazioni possono essere in esecuzione sulla stessa piattaforma o su piattaforme diverse. I messaggi MQSeries constano di due parti; i dati di applicazione ed una descrizione del messaggio. Il contenuto e la struttura dei dati dell'applicazione vengono definiti dai programmi di applicazione che utilizzano i dati. Il descrittore di messaggio identifica il messaggio e contiene informazioni di controllo, ad esempio il tipo di messaggio e la priorità assegnata ad esso dall'applicazione mittente. 2 MQSeries per AS/400, V5.1 Guida rapida

11 Cos'è una coda Oggetti MQSeries Una coda è una struttura di dati che memorizza i messaggi. I messaggi possono essere inseriti nella coda dalle applicazioni o da un gestore code come parte della normale operazione. Le code esistono indipendentemente dalle applicazioni che le utilizzano. Una coda può esistere nella memoria principale (se è temporanea), su disco o memoria ausiliaria simile (se deve essere conservata in caso di ripristino) o in entrambe le ubicazioni (se la si sta attualmente utilizzando e deve essere conservata per il ripristino). Ogni coda appartiene ad un gestore code, che è responsabile della manutenzione. Il gestore code inserisce i messaggi che riceve sulla coda appropriata. Le code possono trovarsi sia su un sistema locale (code locali), che su un altro gestore code, (code remote). Le applicazioni utilizzano le chiamate MQI per inviare e ricevere i messaggi. Un'applicazione può inserire un messaggio su una coda e un'altra applicazione può richiamare tale messaggio dalla stessa coda. Un oggetto MQSeries è una risorsa recuperabile gestita da MQSeries. Molte delle attività descritte in questo capitolo riguardano la modifica dei seguenti tipi di oggetti MQSeries: Gestori code Code Definizione delle procedure Canali Elenchi nomi MQSeries crea oggetti predefiniti quando viene creato un gestore code. Ogni oggetto ha un nome. E' possibile specificare tale nome nei comandi MQSeries e nelle chiamate MQI per far riferimento a tale oggetto. I nomi devono essere univoci all'interno di ogni tipo di oggetto. Ad esempio, è possibile avere una coda e una procedura con lo stesso nome, ma non è possibile avere due code con lo stesso nome. Capitolo 1. Informazioni su MQSeries 3

12 Gestori code Code Un gestore code fornisce i servizi di accodamento alle applicazioni e gestisce le code di cui è responsabile. Assicura che: Gli attributi degli oggetti vengano modificati in base ai comandi ricevuti. Eventi particolari, ad esempio eventi trigger o strumentali, vengano creati quando si riscontrano condizioni favorevoli. I messaggi vengano inseriti sulla coda corretta, come richiesto dall'applicazione che effettua la chiamata MQPUT. Se questa operazione non può essere effettuata, l'applicazione ne viene informata e riceve un codice di errore appropriato. Ciascuna coda appartiene ad un unico gestore code e viene definita coda locale per quel gestore code. Il gestore code a cui è collegata un'applicazione viene definito come gestore code locale per quell'applicazione. Per l'applicazione, le code che appartengono al gestore code locale sono code locali. Una coda remota è semplicemente una coda che appartiene ad un altro gestore code. Un gestore code remoto è un gestore diverso dal gestore code locale. Un gestore code remoto può esistere su una macchina remota in una rete o può esistere sulla stessa macchina del gestore code locale. MQSeries per AS/400, V5.1 supporta più gestori code sulla stessa macchina. Una coda è un oggetto MQSeries in grado di memorizzare i messaggi. Ogni coda dispone di attributi di coda che determinano cosa succede quando le applicazioni fanno riferimento alla coda nelle chiamate MQI. Gli attributi indicano: Se le applicazioni possono richiamare i messaggi dalla coda (get abilitato) Se le applicazioni possono inserire messaggi sulla coda (put abilitato) Se l'accesso alla coda è esclusivo per un'applicazione o condiviso tra le applicazioni Il numero massimo di messaggi che è possibile memorizzare sulla coda nello stesso momento (profondità massima della coda) La dimensione massima dei messaggi che possono essere inseriti sulla coda (dimensione massima messaggio) 4 MQSeries per AS/400, V5.1 Guida rapida

13 Definizioni della procedura Canali Un oggetto di definizione procedura definisce un'applicazione che deve essere avviata in risposta ad un evento trigger su un gestore code MQSeries. Un evento trigger è una combinazione logica delle condizioni rilevate da un gestore code. Ad esempio, un evento trigger può essere creato quando il numero dei messaggi su una coda raggiunge un livello predefinito. Questo evento fa in modo che il gestore code inserisca un messaggio trigger su una specifica coda di avvio. Questo messaggio trigger viene richiamato da un controllo trigger, un'applicazione speciale che controlla una coda di avvio. Il controllo trigger avvia il programma di applicazione specificato nel messaggio trigger. Se un gestore code deve utilizzare la funzione di trigger, è necessario che sia definita almeno una coda di avvio per tale gestore code. Consultare il manuale MQSeries Application Programming Guide per ulteriori informazioni sulla procedura di trigger. Un canale fornisce un percorso di comunicazione. Esistono due tipi di canale; canali messaggi e canali MQI. Un canale di messaggi fornisce un percorso di comunicazione tra due gestori code sulla stessa piattaforma o su piattaforme diverse. Il canale di messaggi viene utilizzato per la trasmissione di messaggi da un gestore code all'altro. Protegge i programmi di applicazione dalle difficoltà dei protocolli di rete. Un canale di messaggi può trasmettere messaggi solo in una direzione. Se è necessaria una comunicazione bidirezionale tra due gestori code, sono necessari due canali di messaggi. Un canale MQI collega un client MQSeries ad un gestore code su una macchina server. Viene utilizzato solo per il trasferimento di chiamate e risposte MQI (ad esempio MQPUT) ed è bidirezionale. Una definizione di canale esiste per ogni estremità del collegamento. Su alcune piattaforme, alcuni tipi di canali MQI possono essere definiti automaticamente. Per ulteriori informazioni relative ai canali consultare il manuale MQSeries Intercommunication. Capitolo 1. Informazioni su MQSeries 5

14 Client e server Elenchi nomi Un elenco nomi è un oggetto MQSeries che contiene un elenco di altri oggetti MQSeries. Generalmente gli elenchi nomi vengono utilizzati dalle applicazioni tipo controlli trigger, dove sono utilizzati per elencare un numero di code. Il vantaggio di utilizzare un elenco nomi è che viene conservato indipendentemente dalle applicazioni. E' possibile aggiornare un elenco nomi senza dover arrestare l'applicazione che lo utilizza. Inoltre, se un'applicazione ha esito negativo, ciò non influisce sull'elenco nomi e altre applicazioni possono continuare ad utilizzarlo. MQSeries supporta le configurazioni client/server per le applicazioni MQSeries. Un client MQSeries fa parte del prodotto MQSeries utilizzato per accettare le chiamate MQI da un'applicazione e trasferirle ad una macchina server MQI. Le chiamate vengono elaborate da un gestore code sulla macchina server. Generalmente il client e il server risiedono su macchine diverse, ma possono risiedere anche sulla stessa macchina. Un server MQI è un gestore code che fornisce servizi di accodamento ad uno o più client. Tutti gli oggetti MQSeries, ad esempio le code, si trovano soltanto sulla macchina del gestore code, cioè sulla macchina server MQI. Un server può supportare anche le applicazioni MQSeries locali. I benefici di utilizzare un client MQSeries comprendono: Requisiti hardware ridotti. Requisiti di gestione sistema ridotti. Spazio ridotto per l'installazione. E' possibile utilizzare canali alternativi che utilizzano diversi protocolli di trasmissione. Per ulteriori informazioni relative ai client, al supporto client e alla creazione di canali per i client e i server, consultare il manuale MQSeries Client. 6 MQSeries per AS/400, V5.1 Guida rapida

15 Eventi di strumentazione E' possibile utilizzare eventi di strumentazione MQSeries per controllare il funzionamento dei gestori code. Gli eventi di strumentazione creano messaggi speciali, denominati messaggi evento, ogni volta che il gestore code rileva una serie di condizioni predefinita. Ad esempio, le seguenti condizioni danno luogo ad un evento Coda completa: Gli eventi Coda completa vengono abilitati per una coda specifica e Un'applicazione effettua una chiamata MQPUT per inviare un messaggio su quella coda, ma la chiamata ha esito negativo a causa del riempimento della coda. Altre condizioni che possono determinare eventi strumentali includono: Un limite predefinito per il numero di messaggi raggiunto su una coda Una coda che non riceve assistenza entro un determinato periodo di tempo Un'istanza di canale che viene avviata o arrestata Se si definiscono le code evento come code remote, è possibile inserire tutte le code evento su un singolo gestore code (per quei nodi che supportano gli eventi di strumentazione). E' quindi possibile utilizzare gli eventi creati per controllare una rete di gestori code da un singolo nodo. Tipi di evento Gli eventi MQSeries vengono raggruppati in categorie nel seguente modo: Eventi gestore code Questi eventi si riferiscono alle definizioni delle risorse all'interno dei gestori code. Ad esempio, se un'applicazione tenta di aprire una coda ma l'id utente associato non è autorizzato ad eseguire tale operazione, viene creato un evento gestore code. Eventi delle prestazioni Questi eventi notificano che una risorsa ha raggiunto una condizione di soglia. Ad esempio, una coda ha raggiunto il relativo limite di profondità coda a seguito di una richiesta MQGET oppure una coda non riceve assistenza entro un determinato periodo di tempo. Eventi canale Questi eventi sono riportati dai canali come risultato di condizioni rilevate durante le operazioni. Ad esempio, un evento di canale viene creato quando viene arrestata un'istanza di canale. Capitolo 1. Informazioni su MQSeries 7

16 Supporto transazionale Un programma applicativo può raggruppare una serie di aggiornamenti in un'unità di lavoro. Di solito, questi aggiornamenti sono correlati in modo logico ed è necessario che abbiano tutti esito positivo per garantire l'integrità dei dati. Se un aggiornamento ha avuto esito positivo ed un altro no, l'integrità dei dati viene persa. Un'unità di lavoro si convalida quando viene completata correttamente. A questo punto tutti gli aggiornamenti effettuati in quell'unità di lavoro vengono resi perman enti o irreversibili. Se l'unità di lavoro ha esito negativo, tutti gli aggiornamenti vengono invece ripristinati a livello precedente. La coordinazione punto di sincronia è la procedura tramite la quale le unità di lavoro vengono convalidate o regredite. Una unità di lavoro locale è quella in cui le uniche risorse aggiornate sono quelle che appartengono al gestore code MQSeries. La coordinazione del punto di sincronia viene fornita dallo stesso gestore code, utilizzando una procedura di convalida ad una fase. Una unità di lavoro globale è quella in cui le risorse che appartengono ad altri gestori risorse, ad esempio database DB2/400, vengono aggiornate. Qui è necessario utilizzare una procedura di convalida a due fasi e l'unità di lavoro viene coordinata esternamente dal controller di convalida del sistema operativo. Le unità di lavoro globali rendono possibile integrare gli aggiornamenti del database all'interno di unità di lavoro MQSeries. Cioè è possibile scrivere un'applicazione che apporta aggiornamenti alle code e ai database MQSeries. E' possibile immettere comandi per convalidare o ripristinare le modifiche sulle code e sui database. Ciò viene ottenuto utilizzando un protocollo di convalida a due fasi. Quando un'unità di lavoro deve essere convalidata, il controller di convalida del sistema operativo chiede ad ogni proprietario di risorsa se è pronto ad effettuare la convalida degli aggiornamenti. Solo se entrambi i gestori database e code sono pronti per la convalida, tutti gli aggiornamenti delle code e dei database vengono convalidati. Se il gestore database non può preparare gli aggiornamenti, l'unità di lavoro viene ripristinata. Il supporto per un completo ripristino viene fornito se il gestore code perde il contatto con il gestore database durante la procedura di convalida. Se il gestore database non è più disponibile mentre è in sospeso (cioè è stato richiamato per prepararsi ma il controller di convalida deve ancora ricevere una decisione relativa alla convalida o al ripristino) il controller di convalida ricorda l'esito dell'unità di lavoro finché essa non viene consegnata con esito positivo. Allo stesso modo, se il gestore code termina con risultati incompleti di convalida, essi vengono ricordati al riavvio del gestore code. 8 MQSeries per AS/400, V5.1 Guida rapida

17 Capitolo 2. Nuovi elementi in MQSeries per AS/400, V5.1 MQSeries per AS/400, V5.1 è un aggiornamento a MQSeries per AS/400, V Tuttavia si tratta di più di un aggiornamento delle caratteristiche di tale prodotto. Comprende una nuova significativa funzione e riprogetta il prodotto base, per portare MQSeries per AS/400 allo stesso livello di funzione degli altri prodotti della versione 5.1. MQSeries per AS/400, V5.1 adesso offre congruenza della piattaforma con altri prodotti a livello della versione 5.1, che sono: MQSeries per AIX MQSeries per OS/2 MQSeries per HP-UX MQSeries per Sun Solaris MQSeries per Windows NT Le caratteristiche di questo release comprendono: Cluster gestore code MQSeries E' possibile collegare gestori code MQSeries per formare un cluster. All'interno di un cluster, i gestori code possono rendere disponibili le code che essi contengono per tutti gli altri gestori code. Ogni gestore code può inviare un messaggio ad un altro gestore code nello stesso cluster senza dover specificare definizioni di canale esplicite, code remote o code di trasmissione per ogni destinazione. I vantaggi principali dei cluster MQSeries sono: Minori attività di gestione sistema Maggiore disponibilità Bilanciamento del carico di lavoro I cluster sono supportati da tutti i prodotti MQSeries versione 5.1 e anche da MQSeries per OS/390, versione 2.1. Per una descrizione completa, consultare il manuale MQSeries Queue Manager Clusters. MQAI (MQSeries Administration Interface) MQAI (MQSeries Administration Interface) è un'interfaccia di programmazione MQSeries che semplifica la modifica dei messaggi PCF MQSeries per le attività di gestione. Ciò è descritto nel manuale MQSeries Administration Interface Programming Guide and Reference. Supporto per i client Windows 98 E' possibile collegare un client Windows 98 al server MQSeries per AS/400, V5.1. Supporto Java Le classi MQSeries per Java comprendono il supporto per MQSeries per AS/400, V5.1. Nuove chiamate MQSeries per AS/400, V5.1 supporta le seguenti nuove chiamate: MQCONNX, che consente di specificare opzioni di connessione gestore code. MQCMIT, MQBACK e MQBEGIN, che consentono a MQSeries di coordinare un'unità di lavoro locale. Convalida bifase MQSeries per AS/400, V5.1 partecipa come risorsa di convalida bifase nelle unità di lavoro globali (UOW) gestite da OS/400. Copyright IBM Corp

18 Creazione automatica oggetto MQSeries per AS/400, V5.1 crea automaticamente oggetti predefiniti quando viene creato un gestore code. Conversione del carattere di nuova riga EBCDIC E' possibile controllare la conversione dei caratteri di nuova riga EBCDIC. Pertanto è possibile assicurare che i dati trasmessi tra sistemi EBCDIC e ASCII nono vengano alterati dalla conversione ASCII. Più gestori code Adesso MQSeries per AS/400 supporta più gestori code. E' possibile denominare un gestore code come gestore code predefinito. E' possibile eseguire azioni su un gestore code predefinito senza specificare il suo nome nei comandi. Controllo priorità lavoro Gli utenti possono impostare la priorità indipendente per singoli lavori MQSeries - ad esempio gli agent di canale. Sottosistema MQSeries MQSeries per AS/400, V5.1 ha un suo sottosistema. I release precedenti utilizzavano QSYSWRK. Supporto Euro MQSeries supporta le code page nuove e modificate che utilizzano il simbolo della valuta euro. Ulteriori dettagli sulle code page che comprendono il simbolo euro vengono forniti nel manuale MQSeries Application Programming Reference. Canali sottoprocessi multipli MQSeries per AS/400, V5.1 supporta canali con sottoprocessi multipli. Applicazioni sottoprocessi multipli MQSeries per AS/400, V5.1 supporta applicazioni con sottoprocessi multipli. Dimensione coda messaggi Una coda messaggi può avere una dimensione massima di 2 GB. Dimensione messaggio Un singolo messaggio può avere una dimensione fino ad un massimo di 100 MB. Applicazione di gestione L'applicazione di gestione non viene supportata in MQSeries per AS/400, V MQSeries per AS/400, V5.1 Guida rapida

19 Capitolo 3. Pianifica per l'installazione del server MQSeries per AS/400 Requisiti hardware Questo capitolo fornisce un riepilogo dei requisiti per l'esecuzione di MQSeries per AS/400. Discute dei protocolli di rete e dei compilatori supportati, dei supporti magnetici di distribuzione e dei vari componenti del prodotto. Le informazioni in questo capitolo si applicano solo all'ambiente server. Per informazioni relative agli ambienti client, consultare Capitolo 6, Pianificazione dell'installazione di client MQSeries a pagina 37. MQSeries per AS/400, V5.1 viene eseguito su una macchina in grado di eseguire OS/400 V4R4 e che ha memoria sufficiente per soddisfare i requisiti combinati dei requisiti necessari di programmazione, MQSeries per AS/400, V5.1, i metodi di accesso e i programmi applicativi, sia dell'ibm che di altri rivenditori. I requisiti di installazione dipendono dai componenti installati e da quanto spazio di lavoro è necessario. Questo, a sua volta dipende dal numero di code utilizzate, dal numero e dalla dimensione dei messaggi sulle code e se i messaggi sono permanenti. Inoltre è richiesta capacità di archiviazione su disco, nastro o altro supporto magnetico. Spazio su disco richiesto Requisiti software Connettività Per il codice base e il server MQSeries per AS/400, V5.1 si deve disporre di circa 60 MB di memoria. Questo è il livello software minimo supportato. I successivi livelli, se esistenti, verranno supportati a meno che non sia diversamente indicato. OS/400 versione 4 release 4 I protocolli di rete supportati da MQSeries per AS/400 sono: TCP SNA LU 6.2 Librerie e indirizzari di installazione AS/400 MQSeries per AS/400 viene installato nella struttura della libreria AS/400 e utilizza gli indirizzari nel file system principale IFS. Copyright IBM Corp

20 Struttura libreria AS/400 L'installazione di MQSeries per AS/400 crea le seguenti librerie: QMQM La libreria del prodotto base MQSeries. QMQMSAMP La libreria degli esempi MQSeries (se si sceglie di installare gli esempi). QMQM29xx Una libreria contenente un file di messaggi specifico per la propria lingua nazionale. Questo file di messaggi viene automaticamente copiato nell'appropriata libreria QSYS29xx quando viene installato il prodotto. Sono disponibili le seguenti versioni di lingua per MQSeries per AS/400, V5.1: Tabella 1. Versioni lingua nazionale di MQSeries per AS/400, V5.1 ID lingua Nota: La versione di lingua giapponese di questo prodotto non viene eseguita correttamente se il CCSID lavoro è Per i dettagli dei CCSID supportati per utilizzare questa versione di lingua, consultare il file readme. Libreria QMxxxx Ogni volta che si crea un gestore code, MQSeries automaticamente crea una libreria associata. Questa libreria contiene oggetti specifici per il gestore code, compresi i giornali e i ricevitori associati. Il nome di questa libreria viene ricavato dal nome del gestore code con il prefisso composto dai caratteri QM. Ad esempio, per un gestore code denominato TEST, la libreria sarà denominata QMTEST. E' possibile utilizzare il comando WRKLIB per elencare tutte le librerie create da MQSeries per AS/400. Vicino alle librerie gestore code, verrà visualizzato il testo QMGR: QMGRNAME. Il formato del comando è: WRKLIB LIB(QM) Lingua 2909 Inglese belga 2966 Francese belga MNCS (Multi-National Character Set) 2981 Francese canadese MNCS 2950 Inglese maiuscolo 2924 Inglese maiuscolo e minuscolo 2938 Inglese maiuscolo DBCS (Double-Byte Character Set) 2984 Inglese maiuscolo e minuscolo DBCS 2928 Francese 2940 Francese MNCS 2932 Italiano 2942 Italiano MNCS 2931 Spagnolo 2962 Giapponese 2986 Coreano 2989 Cinese semplificato Queste librerie associate al gestore code vengono conservate quando il prodotto viene cancellato. File system principale IFS IFS (integrated file system) fornisce un'interfaccia comune per i diversi sistemi su AS/400. Quando si installa MQSeries per AS/400, V5.1 vengono creati due indirizzari nel file system principale. Essi sono: 12 MQSeries per AS/400, V5.1 Guida rapida

21 /QIBM/ProdData/mqm I sottoindirizzari dipendenti da questo contengono tutti i dati prodotto - ad esempio, le classi C++. I dati in questo indirizzario vengono cancellati e sostituiti ogni volta che viene installato il prodotto. /QIBM/UserData/mqm I sottoindirizzari dipendenti da questo contengono tutti i dati utente relativi ai gestori code. Quando il prodotto viene installato, vengono creati anche tre sottoindirizzari /QIBM/UserData/mqm/errors, /QIBM/UserData/mqm/qmgrs e /QIBM/UserData/mqm/trace. Quando viene installato il prodotto, viene creato un file mqs.ini nell'indirizzario /QIBM/UserData/mqm/ (a meno che non si trovasse già in una precedente installazione). Quando si crea un gestore code, viene creato un file qm.ini nell'indirizzario /QIBM/UserData/mqm/qmgrs/QMGRNAME/ (in cui QMGRNAME è il nome del gestore code.) Il file qm.ini è l'equivalente del file QMINI in precedenti release di MQSeries per AS/400. I dati in questo indirizzario vengono conservati quando viene cancellato il prodotto. La struttura del file IFS viene mostrata nel manuale MQSeries per AS/400 V5.1 System Administration. Profili utente Quando si installa MQSeries per AS/400, V5.1, viene creato un certo numero di profili utente. Essi comprendono QMQM, QMQMADM e NOBODY. Questi tre oggetti sono essenziali per la corretta esecuzione di MQSeries per AS/400. In nessun caso si devono modificare o cancellare. Se dovessero essere cancellati o modificati, l'ibm non garantisce il corretto funzionamento del prodotto. Questi profili vengono conservati quando viene cancellato il prodotto. Compilatori supportati per le applicazioni MQSeries per AS/400, V5.1 Consegna MQSeries per AS/400, V5.1 supporta i seguenti compilatori: Compilatore IBM ILE C per AS/400 (5768-CX2) Compilatore IBM ILE C++ per AS/400 (5799-GDW) Compilatore IBM VisualAge per C++ per AS/400 (5769-CX4) Compilatore IBM ILE COBOL per AS/400 versione 3 (5769-CB1) Compilatore IBM ILE RPG per AS/400 (5769-RG1) AS/400 Developer Kit per Java (5769-JV1) MQSeries per AS/400, V5.1 viene fornito su CD-ROM. Sono presenti tre CD-ROM. Uno contiene il prodotto di base e i programmi di esempio MQSeries per AS/400, V5.1. Un altro contiene i prodotti client che è possibile utilizzare con MQSeries per AS/400. Il terzo contiene i manuali MQSeries per AS/400. Il supporto Java viene fornito sul sito Web MQSeries all'indirizzo: Capitolo 3. Pianifica per l'installazione del server MQSeries per AS/400 13

22 Componenti MQSeries per AS/400 I componenti sono i seguenti: Base Supporto per la creazione e l'esecuzione di applicazioni utente.include il componente run-time che fornisce il supporto per le applicazioni esterne. Comprende anche il supporto per le connessioni client da altri prodotti MQSeries. Esempi Programmi applicativi di esempio. L'origine viene fornita nella libreria QMQMSAMP e gli eseguibili vengono forniti nella libreria QMQM. Consultare Appendice A, Programmi di esempio MQI a pagina 85. Documentazione in linea MQSeries Le versioni HTML e PDF dei manuali vengono fornite sui manuali CD-ROM. Non sono installabili. E' possibile leggerli direttamente dal CD-ROM oppure copiarli sul proprio sistema. Ad esempio, è possibile copiarli sul disco fisso del proprio PC o memorizzarli nell'ifs AS/400 IFS e quindi accedervi utilizzando un'unità di rete. Ogni manuale viene fornito in inglese americano e in alcune o tutte le seguenti lingue: Francese Tedesco Italiano Giapponese Coreano Spagnolo Cinese semplificato Consultare Capitolo 8, Richiesta di ulteriori informazioni a pagina 79 per ulteriori informazioni. File Readme Le informazioni più recenti relative al prodotto, che diventano disponibili dopo la pubblicazione di questo manuale. E' possibile reperire questo file readme sui manuali CD-ROM e deve essere letto prima di cominciare ad installare MQSeries per AS/400. Consultare Capitolo 8, Richiesta di ulteriori informazioni a pagina 79 per ulteriori informazioni. Creazione di oggetti predefiniti di sistema Gli oggetti predefiniti di sistema vengono creati automaticamente quando si immette il comando CRTMQM per creare un gestore code. E' possibile aggiornarli utilizzando il comando STRMQM. Consultare la guida in linea per le informazioni relative all'utilizzo di questo comando. 14 MQSeries per AS/400, V5.1 Guida rapida

23 Capitolo 4. Installazione, cancellazione e migrazione verso MQSeries per AS/400 Questo capitolo descrive l'installazione e la migrazione verso MQSeries per AS/400, V5.1. Illustra i seguenti argomenti: Requisiti di pre-installazione Procedura di installazione a pagina 16 Verifica dell'installazione a pagina 17 Disattivazione MQSeries a pagina 18 Migrazione verso MQSeries per AS/400, V5.1 a pagina 19 Verifica della migrazione a pagina 24 Cancellazione di MQSeries per AS/400, V5.1 a pagina 25 Oltre a leggere le informazioni in questo capitolo, è necessario far riferimento al file readme sui CD-ROM dei manuali e anche alle informazioni più recenti disponibili sul sito web MQSeries all'indirizzo: Requisiti di pre-installazione Se si sta migrando da un release precedente MQSeries per AS/400, fare riferimento a Migrazione verso MQSeries per AS/400, V5.1 a pagina 19. E' necessario avere il sistema operativo OS/400 V4R4 installato sulla propria macchina per poter eseguire MQSeries per AS/400, V5.1. Se si ha il sistema operativo OS/400 V4R2 o V4R3 installato, è possibile utilizzare solo MQSeries per AS/400 V4R2M1. Impostazione dei valori di sistema Prima di installare MQSeries per AS/400, è necessario utilizzare il comando DSPSYSVAL per verificare che i seguenti valori di sistema siano impostati sui requisiti della propria azienda: QCCSID QUTCOFFSET QSYSLIBL QALWOBJRST E' possibile modificare questi valori, se necessario, utilizzando il comando CHGSYSVAL. QCCSID Ogni messaggio ha un CCSID (coded-character set identifier) nella propria intestazione. L'etichetta CCSID identifica la code page e la serie dei caratteri dell'origine. Per i CCSID supportati su AS/400 consultare il manuale AS/400 National Language Support. Le informazioni sul CCSID vengono ottenute, quando viene creato un gestore code, dal CCSID del lavoro. Se esso non contiene un valore valido compreso tra Copyright IBM Corp

24 , le informazioni vengono ottenute dal valore CCSID predefinito per il lavoro. Nota: Il CCSID deve essere SBCS (Single-byte character set) o Mixed, cioè SBCS e DBCS. Non deve essere solo DBCS. E' possibile modificare il CCSID utilizzato dal gestore code MQSeries utilizzando il comando CL CHGMQM. Consultare Impostazione del CCSID gestore code per MQSeries per AS/400 a pagina 35 per ulteriori informazioni. QUTCOFFSET E' necessario verificare che sia stato impostato il valore QUTCOFFSET (coordinated universal time offset) per indicare il rapporto tra l'orario del sistema e GMT (Greenwich Mean Time). E' possibile eseguire ciò operando con il comando CHGSYSVAL. Se QUTCOFFSET non è impostato, assume il valore predefinito di zero. MQSeries per AS/400 presuppone quindi che l'orario del sistema locale sia UTC (universal time coordinated) - cioè, GMT - ed esegue la registrazione data/ora dei messaggi MQSeries per AS/400 di conseguenza. QSYSLIBL Assicurarsi che QSYS2 sia compreso nell'elenco delle librerie che formano la parte di sistema dell'elenco librerie. MQSeries per AS/400 utilizza programmi in questa libreria per la conversione dei dati e le comunicazioni SNA LU 6.2. QALWOBJRST Procedura di installazione Assicurarsi che il valore di sistema QALWOBJRST sia impostato su *ALL o su *ALWPGMADP prima di installare MQSeries per AS/400. Se è impostato su *NONE, l'installazione avrà esito negativo. Dopo l'installazione, ripristinare QALWOBJRST sul valore originale per conservare la sicurezza del sistema. 1. Per installare il prodotto base MQSeries per AS/400, V5.1, immettere il comando: RSTLICPGM LICPGM(5733A38) DEV(unità di installazione) OPTION(BASE) dove: 5733A38 è l'identificativo del prodotto per MQSeries per AS/400, V5.1 e unità di installazione è l'unità dalla quale deve essere caricato il prodotto, generalmente un CD-ROM - ad esempio, OPT1. 2. Per installare le applicazioni di esempio, immettere il comando: RSTLICPGM LICPGM(5733A38) DEV(unità di installazione) OPTION(1) Nota: E' possibile installare solo un'istanza di MQSeries per AS/400 in ogni partizione della propria macchina AS/ MQSeries per AS/400, V5.1 Guida rapida

25 Installazione delle versioni tradotte MQSeries per AS/400 viene installato nella lingua principale del proprio sistema. E' possibile installare ulteriori versioni del prodotto in ognuna delle lingue mostrate in Tabella 1 a pagina 12. Per eseguire ciò, immettere il seguente comando specificando l'id di lingua appropriato: RSTLICPGM LICPGM(5733A38) DEV(unità di installazione) RSTOBJ(LNG) LNG(ID lingua) Ciò installerà i comandi, il file dei messaggi e i pannelli gruppo nella relativa libreria QSYS per la lingua. Ad esempio, la libreria QSYS2928 viene utilizzata per il francese. Reinstallazione Verifica dell'installazione La reinstallazione viene discussa in Reinstallare MQSeries per AS/400 a pagina 87. Per assicurarsi che il prodotto venga caricato correttamente, immettere il comando DSPSFWRSC (Visualizzazione risorse software) e verificare che il programma su licenza 5733A38 sia elencato. Se sono stati installati gli esempi di base e facoltativi, dovrebbe essere visualizzato: Risorsa ID Opzione Caratt. Descrizione 5733A38 BASE 55 MQSeries per AS/4 5733A38 BASE 2924 MQSeries per AS/4 5733A MQSeries per AS/4 - Esempi Se si preme F11 mentre viene visualizzato il pannello Visualizzazione risorse software, verrà mostrato il numero di versione e la libreria dei prodotti installati: Risorsa ID Opzione Carat. Tipo Libreria Release 5733A38 BASE 55 CODE QMQM V5R1M 5733A38 BASE 2924 LNG QMQM V5R1M 5733A CODE QMQMSAMP V5R1M Se sono state installate ulteriori versioni di lingua, verranno visualizzate delle voci anche per queste. Ad esempio, se è stata installata la versione francese, per la quale l'id lingua è 2928, verrà visualizzato: Risorsa Caratteristica ID Opzione Carat. Descrizione 5733A38 BASE 2928 MQSeries per AS/4 e quando si preme F11: Capitolo 4. Installazione, cancellazione e migrazione verso MQSeries per AS/400 17

26 Risorsa Caratteristica ID Opzione Carat. Tipo Libreria Release 5733A38 BASE 2928 LNG QSYS2928 V5R1M Attività post installazione Disattivazione MQSeries Una volta installato correttamente MQSeries per AS/400, V5.1 sul proprio sistema: 1. Consultare il sito Web della famiglia MQSeries all'indirizzo: per le informazioni più recenti sul prodotto e l'installazione e l'applicazione di tutte le PTF consigliate. 2. Avviare il sottosistema MQSeries immettendo il comando: STRSBS SBSD(QMQM/QMQM) Adesso si è pronti per cominciare ad utilizzare MQSeries per AS/400. Consultare Capitolo 5, Utilizzo di MQSeries per AS/400, V5.1 a pagina 27. La chiusura normale di MQSeries per AS/400 è chiamata disattivazione. Potrebbe essere necessario disattivare MQSeries per AS/400, ad esempio, per: Fare una copia del sistema o Aggiornare MQSeries per AS/400 Disattivazione di precedenti release di MQSeries per AS/400 Per disattivare uno dei precedenti release di MQSeries per AS/400: 1. Utilizzare F12 (Annullamento) per tornare al MENU iniziale Nota: Se si dispone di CMDMQM (comandi MQSeries) come menu iniziale, modificarlo nel proprio profilo utente, scollegarsi e ricollegarsi. 2. Assicurarsi di disporre di: autorizzazione ALLOBJ o autorizzazione alla gestione oggetto per le librerie QMQM e QMQMADM. autorizzazione *USE per i seguenti programmi: QMQM/AMQIQES4 QMQM/AMQIQEM4 QMQM/AMQSTOP4 QMQM/AMQSPECA Note: a. Se si utilizza QMQM/AMQIQES4 ogni utente collegato a MQSeries, anche se l'utente non sta eseguendo il prodotto, verrà scollegato. b. La libreria QMQMADM esiste solo se è stato installato il programma di utilità Gestione MQSeries per AS/ Avvisare tutti gli utenti che si sta arrestando MQSeries per AS/ MQSeries per AS/400, V5.1 Guida rapida

27 4. Avvisare gli utenti di non avviare le applicazioni MQI (Message Queue Interface) mentre viene disattivato MQSeries per AS/400. Per assicurarsi che gli utenti non possano avviarle, è necessario revocare le autorizzazioni degli utenti per MQSeries per AS/400 immettendo il comando RVKMQMAUT. 5. Uscire dal programma di utilità Gestione, se è in esecuzione. 6. Arrestare il gestore code eseguendo il programma AMQSTOP4: CALL QMQM/AMQSTOP4 PARM(QMGRNAME CNTRLD 15) dove QMGRNAME è il nome del gestore code e 15 è un valore di supero tempo in secondi. 7. Se ciò ha esito negativo, è possibile forzare l'arresto del gestore code immettendo: CALL QMQM/AMQSTOP4 PARM(QMGRNAME FORCE 15) Disattivazione V5.1 di MQSeries per AS/400 Per disattivare MQSeries per AS/400, V5.1: 1. Utilizzare F12 (Annullamento) per tornare al MENU iniziale Nota: Se si dispone di CMDMQM (comandi MQSeries) come menu iniziale, modificarlo nel proprio profilo utente, scollegarsi e ricollegarsi. 2. Assicurarsi di disporre di: autorizzazione ALLOBJ o autorizzazione gestione oggetto per la libreria QMQM. autorizzazione *USE per i seguenti programmi: QMQM/AMQIQES4 QMQM/AMQIQEM4 QMQM/AMQSTOP4 QMQM/AMQSPECA 3. Avvisare tutti gli utenti che si sta arrestando MQSeries per AS/ Avvisare gli utenti di non avviare le applicazioni MQI (Message Queue Interface) mentre viene disattivato MQSeries per AS/400. Per assicurarsi che gli utenti non possano avviarle, è necessario revocare le autorizzazioni degli utenti per MQSeries per AS/400 immettendo il comando RVKMQMAUT. 5. Arrestare tutti i gestori code eseguendo il programma AMQSTOP4: CALL QMQM/AMQSTOP4 PARM(ALL CNTRLD 15) dove 15 è un valore di supero tempo in secondi. 6. Se ciò ha esito negativo, è possibile forzare l'arresto dei gestori code immettendo: CALL QMQM/AMQSTOP4 PARM(ALL FORCE 15) 7. Chiudere il sottosistema MQSeries, immettendo: ENDSBS SBS(QMQM/QMQM) Migrazione verso MQSeries per AS/400, V5.1 E' possibile migrare verso MQSeries per AS/400, V5.1 da V3R7 MQSeries per AS/400, V4R2 MQSeries per AS/400 o V4R2M1 MQSeries per AS/400. Capitolo 4. Installazione, cancellazione e migrazione verso MQSeries per AS/400 19

28 E' necessario prestare particolare attenzione quando si migra verso MQSeries per AS/400, V5.1. Il prodotto è stato modificato e migliorato notevolmente rispetto ai precedenti release. Questa sezione evidenzia i passi relativi alla migrazione verso MQSeries per AS/400, V5.1 da un release precedente. E' possibile trovare ulteriori informazioni importanti, disponibili dopo la pubblicazione di questo manuale, facendo riferimento al file readme sui CD-ROM dei manuali o nel sito Web della famiglia MQSeries all'indirizzo: Differenze MQSeries per AS/400, V5.1 fornisce nuove funzioni importanti rispetto ai precedenti release, compresi il supporto per più gestori code, i cluster gestore code e dimensioni code e messaggi notevolmente aumentate. L'abilitazione di queste nuove funzioni ha comportato alcune modifiche all'architettura interna di MQSeries. Ad esempio questo release fa un uso rilevante di Integrated File System, mentre precedentemente tutti i dati MQSeries erano memorizzati negli oggetti OS/400 nelle librerie. Un'altra modifica importante relativa a questo release riguarda la sicurezza. Per aumentare la compatibilità con altre piattaforme V5.1 MQSeries e anche per fornire l'autorizzazione a singole chiamate MQI, il modello di sicurezza in base all'oggetto OS/400 utilizzato in release precedenti è stato sostituito da quello che utilizza OAM (Object Authority Manager) MQSeries. Come conseguenza di queste e di altre modifiche, la migrazione verso MQSeries per AS/400, V5.1 da un release precedentemente installato richiede particolare attenzione e un'attenta pianificazione. Le aree alle quali è necessario prestare particolare attenzione sono: Le applicazioni RPG, COBOL e C esistenti che utilizzano MQI (MQSeries Interface) dovrebbero operare con esito positivo senza dover essere ricompilati. Sono state apportate alcune modifiche al modo in cui vengono implementati alcuni comandi Cl. Potrebbe essere necessario modificare e ricompilare i programmi CL che utilizzano questi comandi. Tutte le uscite utente comprese le uscite di conversione dati e canale devono essere ricompilate utilizzando i compilatori ILE, collegati alle librerie MQSeries con sottoprocessi, rese protette dai sottoprocessi e abilitate per la memoria teraspazio. I dettagli possono essere reperiti nei manuali MQSeries Application Programming Guide e MQSeries Intercommunication. Le autorizzazioni MQSeries continuano ad essere gestite tramite i comandi GRTMQMAUT (Concessione autorizzazione MQM) e RVKMQMAUT (Revoca autorizzazione MQM), ma vi sono sostanziali modifiche: Gli elenchi di autorizzazione e gli oggetti di riferimento non vengono più supportati. Le autorizzazione che possono essere fornite ad un utente per gli oggetti MQSeries sono ora raggruppate in quattro categorie: MQI, Contesto, Gestione e Generico. Esistono ulteriori considerazioni sulla sicurezza di cui tenere conto. Per i dettagli consultare il manuale MQSeries per AS/400 V5.1 System Administration. 20 MQSeries per AS/400, V5.1 Guida rapida

29 Panoramica del processo di migrazione Esistono due possibili scenari per la migrazione: E' possibile che si stia migrando da una versione precedente di MQSeries sulla stessa macchina oppure Si sta trasferendo MQSeries ad una nuova macchina. Il processo è lo stesso, solo che: Se ci si sta spostando ad una nuova macchina, esiste un ulteriore passo, quello di trasferire i dati dalla macchina vecchia a quella nuova. Se si sta aggiornando il sistema sulla stessa macchina, è necessario salvare i propri dati MQSeries perché il processo di migrazione cancella completamente la vecchia versione del prodotto. Per aiutare l'utente nella migrazione, MQSeries per AS/400, V5.1 comprende un programma di utilità chiamato MIGRATEMQM. Questo programma migra gli oggetti e la configurazione MQSeries verso MQSeries per AS/400, V5.1. Inoltre crea un nuovo gestore code con lo stesso nome di quello originale. (Questo gestore code si comporterà come gestore code predefinito sul nuovo sistema a meno che non sia già stato definito un gestore code predefinito). Il programma di migrazione legge le informazioni dal release precedente e crea un corrispondente gestore code al nuovo livello. Inoltre crea tutti gli oggetti MQSeries come le code e i canali. Copia i messaggi conservati sulle code del vecchio gestore code sul nuovo gestore code. Tuttavia, non esegue la migrazione delle definizioni di autorizzazione. In MQSeries per AS/400, V5.1, ogni gestore code ha una sua propria libreria contente i giornali e i ricevitori di giornale di tale gestore code. Nelle versioni precedenti di MQSeries per AS/400, tutti i giornali erano ubicati in QUSRSYS e tutti i ricevitori in QMQMDATA. Il programma di migrazione ottiene i dati messaggio e di configurazione dai giornali e la libreria dei dati del release precedente. Prima della migrazione Prima della migrazione verso MQSeries per AS/400, V5.1, effettuare la seguente procedura sulla versione di MQSeries per AS/400 attualmente installata: 1. Arrestare tutte le applicazioni che utilizzano la versione esistente di MQSeries per AS/ Chiudere tutti i canali MQSeries. Per eseguire ciò, utilizzare il comando WRKMQMCHL e selezionare l'opzione Uscire dal programma di utilità di gestione se è in esecuzione. 4. Arrestare il server dei comandi MQSeries. Per eseguire ciò, immettere il comando: ENDMQMCSVR MQMNAME(QMGRNAME) OPTION(IMMED) dove QMGRNAME è il nome del gestore code. 5. Eliminare ogni messaggio indesiderato dalle proprie code MQSeries. Per eseguire ciò, utilizzare il comando WRKMQMMSG e selezionare l'opzione Risolvere tutti i messaggi in sospeso conservati dal mittente o dai canali server. Per eseguire ciò, utilizzare il comando WRKMQMCHST e selezionare l'opzione Ripristinare il punto di correzione del supporto magnetico. Per eseguire ciò, immettere il comando: Capitolo 4. Installazione, cancellazione e migrazione verso MQSeries per AS/400 21