É possível construir uma coleção de mensagens usando Java™ e a classe MbMessageCollection. O uso de uma coleção de mensagens será útil se for necessário agrupar mensagens para análise ou construir a coleção de mensagens para representar uma determinada estrutura de dados, como uma de canal do CICS Transaction Server para z/OS.
Coleção de mensagens é uma mensagem que consiste em um cabeçalho de Propriedades e um elemento de domínio único chamado Coleção. A pasta Coleção contém várias mensagens filhas, cada uma podendo conter uma pasta de Propriedades, vários cabeçalhos (como MQMD) e um corpo. Uma coleção de mensagens pode ter também zero ou mais atributos que são pares nome/valor. O nome de um atributo deve ser exclusivo em uma coleção de mensagens. Um atributo padrão para a coleta de mensagens é um atributo chamado CollectionName.
A figura a seguir mostra o exemplo de uma estrutura de coleção de mensagens.
É possível criar uma coleção de mensagens usando Java e a classe MbMessageCollection, para agrupar mensagens para análise, ou criar uma coleção de mensagens que deve ser construída para representar uma estrutura de dados específica, como uma estrutura de dados de canal do CICS.
Para configurar uma coleção de mensagens usando Java, conclua as etapas a seguir:
TraceOutput: Root ( ['MQROOT' : 0xee3a90]
(0x01000000:Name):Properties = ( ['MQPROPERTYPARSER' : 0xae4370]
(0x03000000:NameValue):myProperty1 = 'propertyData1' (CHARACTER)
(0x03000000:NameValue):myProperty2 = 'propertyData2' (CHARACTER)
)
(0x01000000:Name):Collection = ( ['COLLECTION' : 0x58d0b08]
(0x03000000:NameValue):CollectionName = 'myCollectionName' (CHARACTER)
(0x03000000:NameValue):NAME1 = 'Value1' (CHARACTER)
(0x03000000:NameValue):NAME2 = 12345 (INTEGER)
(0x01000000:Name ):Folder1 = ( ['COLLECTIONFOLDER' : 0xee42e8]
(0x01000000:Name ):Properties = ( ['MQPROPERTYPARSER' : 0xae39e8]
(0x03000000:NameValue):myFolder1Property1 = 'folder1propertyData1' (CHARACTER)
(0x03000000:NameValue):myFolder1Property2 = 'folder1propertyData2' (CHARACTER)
)
(0x01000021:Name+):MRM = ( ['mrm' : 0xdce588]
(0x01000000:Name):msg = (
(0x03000000:NameValue):data = 'myData' (CHARACTER)
)
)
)
(0x01000000:Name ):Folder2 = ( ['COLLECTIONFOLDER' : 0xee3d58]
(0x01000000:Name ):Properties = ( ['MQPROPERTYPARSER' : 0xae4cf8]
(0x03000000:NameValue):myFolder2Property1 = 'folder2propertyData1' (CHARACTER)
(0x03000000:NameValue):myFolder2Property2 = 'folder2propertyData2' (CHARACTER)
)
(0x01000000:Folder):XMLNSC = ( ['xmlnsc' : 0xee2188]
(0x01000000:Folder):msg2 = (
(0x03000000:PCDataField):myData2 = 'myXMLData' (CHARACTER)
)
)
)
)
)