In questo argomento viene descritta la procedura di creazione di una nuova definizione dei messaggi da una struttura dati COBOL utilizzando la procedura guidata Nuovo file di definizione dei messaggi del workbench.
Prima di iniziare:
Per completare tale attività, terminare le procedure riportate di seguito:
Prima di iniziare l'operazione è necessario essere a conoscenza dei punti riportati di seguito.
- Per creare un nuovo file di definizione dei messaggi da una struttura dati COBOL, è necessario che il file COBOL sia già presente nel workbench, ad esempio nel progetto della serie di messaggi. Ciò consente di selezionare il file
nella procedura guidata Nuovo file di definizione dei messaggi.
- La procedura guidata consente di importare file COBOL con estensioni .cbl, .ccp, .cob e .cpy. Se il file di origine dispone di un'estensione differente, è necessario ridenominarlo prima di effettuare il tentativo di importazione.
- Se la serie di messaggi alla quale si aggiunge il nuovo file di definizione dei messaggi non dispone di un livello CWF (Custom Wire Format), nel modello verranno visualizzate solo le informazioni logiche. E' possibile aggiungere il livello fisico alla serie di messaggi prima o dopo l'importazione di una struttura dati COBOL ma è necessario aggiungere il livello fisico prima di
importare la struttura dati per accertarsi che questa sia completata con le impostazioni da copybook COBOL.
- E' inoltre possibile importare una struttura dati COBOL utilizzando mqsicreatemsgdefs nella riga comandi.
Se in precedenza è stato utilizzato il programma di importazione COBOL WebSphere MQ
Integrator Versione 2.1
per creare un modello messaggio, è possibile che il programma di importazione WebSphere Message Broker
Versione 6.0 non produca gli stessi risultati esatti. In particolare, il programma di importazione COBOL Versione 2.1
non supporta la stessa quantità di strutture COBOL di WebSphere Message Broker
Versione 6.0 e la convenzione di denominazione
per i tipi composti della Versione 2.1
non coincide con la convenzione di denominazione di gruppi e tipi complessi di WebSphere Message Broker
Versione 6.0. In pochi casi la convenzione di denominazione per gli elementi della Versione 2.1
non coincide con la convenzione di denominazione degli elementi di WebSphere Message Broker
Versione 6.0.
Se è stato creato un ESQL di flusso di messaggi nella
Versione 2.1 per manipolare il modello messaggio derivato da COBOL e l'ESQL è stato importato in
WebSphere Message Broker
Versione 6.0 utilizzando il comandomqsimigratemsgflows ed è in corso una
nuova creazione del modello messaggio utilizzando il programma di importazione COBOL WebSphere Message Broker
Versione 6.0, verificare la correttezza dell'ESQL.
Nella procedura riportata di seguito sono trattate sia la creazione di un file di definizione dei messaggi completamente nuovo che
la sovrascrittura del contenuto di un file esistente.
Per creare un file di definizione dei messaggi da una struttura dati COBOL, effettuare la procedura riportata di seguito:
- Passare alla Prospettiva Sviluppo dell'applicazione
broker.
- Aprire la procedura guidata Nuovo file di definizione dei messaggi facendo clic su File > Nuovo > File di definizione dei messaggi nel menu di workbench. In alternativa, è possibile aprire la procedura guidata facendo clic con il pulsante destro del mouse su un copybook COBOL importato in precedenza in workbench e facendo clic su Nuovo > File di definizione dei messaggi nel menu.
- Nell'elenco delle opzioni visualizzato fare clic su File COBOL, quindi su Avanti.
- Completare la procedura guidata compilando i campi come richiesto.
Al termine dell'importazione del file COBOL mediante la procedura guidata, effettuare quanto segue.
- Verificare che non siano presenti errori nel prospetto creato durante l'importazione del file. E' possibile trovare tale prospetto nella directory log all'interno del progetto che contiene la definizione dei messaggi per la quale è stato effettuato il tentativo di creazione. Il prospetto dispone di un'estensione file .cobol.report.txt, il cui prefisso è il nome specificato per il nuovo file di definizione dei messaggi.
- Esaminare i messaggi visualizzati nell'elenco delle attività del workbench
per verificare se sono state visualizzate nuove avvertenze o errori.