In questo argomento viene descritta la procedura di creazione di una nuova definizione dei messaggi da un file di intestazione C 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 un file di intestazione C, è necessario che il file di intestazione sia già presente nel workbench, ad esempio nel progetto della serie di messaggi. Ciò consente di selezionare il file di intestazione
nella procedura guidata Nuovo file di definizione dei messaggi.
- La procedura guidata consente di importare file di intestazione C con estensioni .h, .c e .css. 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 un file di intestazione C ma è necessario aggiungere il livello fisico prima di
importare il file per accertarsi che sia completato con le impostazioni dal file di intestazione C.
- E' inoltre possibile importare un file di intestazione C utilizzando mqsicreatemsgdefs nella riga comandi.
Se in precedenza è stato utilizzato il programma di importazione C 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 C Versione 2.1
non supporta la stessa quantità di strutture C 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.
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 un file di intestazione C, 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 dal menu di workbench. In alternativa,
è possibile aprire la procedura guidata facendo clic con il pulsante destro del mouse su un file di intestazione C 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 di intestazione C, quindi su Avanti.
- Completare la procedura guidata compilando i campi come richiesto.
Al termine dell'importazione del file di intestazione C 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 .c.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.