Crear una colección de mensajes utilizando ESQL

Una colección de mensajes puede construirse utilizando ESQL. El uso de una colección de mensajes es útil si los mensajes deben agruparse para el análisis, o si la colección de mensajes debe construirse para representar una estructura de datos determinada, como una estructura de datos de canal CICS® Transaction Server for z/OS® .

Antes de empezar

Cree una aplicación, biblioteca o proyecto de integración.
Para obtener información general, consulte Recopilaciones de mensajes.

Acerca de esta tarea

Una colección de mensajes es un mensaje que consta de una cabecera Propiedades y un elemento de dominio único denominado Colección. La carpeta Colección contiene un número de mensajes hijo, cada uno de los cuales puede contener un carpeta Propiedades, un número de cabeceras (por ejemplo MQMD) y un cuerpo. Una colección de mensajes también puede tener cero o más atributos de tipo par nombre/valor. El nombre de un atributo debe ser único dentro de una colección de mensajes. Un atributo estándar para la colección de mensajes es un atributo denominado CollectionName.

La figura siguiente muestra un ejemplo de una estructura de la colección de mensajes.

Este es un diagrama del árbol para una colección de mensajes. Su contenido se describe en el texto circundante.

Puede crear una colección de mensajes utilizando ESQL para agrupar mensajes para el análisis, o crear una colección de mensajes que debe construirse para representar una estructura de datos determinada, como una estructura de datos de canal CICS .

Para configurar una colección de mensajes utilizando ESQL, realice los pasos siguientes:

Procedimiento

Cree una carpeta Propiedades para la colección utilizando la siguiente sentencia ESQL:
```
CREATE FIRSTCHILD of OutputRoot domain 'Properties' NAME 'Properties';
```
Cree el elemento de dominio Collection utilizando la sentencia siguiente:
```
CREATE LASTCHILD OF OutputRoot DOMAIN 'Collection';
```
Como con las carpetas de mensajes, el elemento de dominio es siempre el último hijo del mensaje.
Utilice la sentencia siguiente para establecer un atributo en la colección denominada CollectionName:
```
SET OutputRoot.Collection.CollectionName = 'myCollectionName';
```

El ESQL siguiente muestra un procedimiento de ejemplo para crear un mensaje dentro de la colección:

SET OutputRoot.Collection.foldername.Properties.MessageSet     = set;
SET OutputRoot.Collection.foldername.Properties.MessageType    = type;
SET OutputRoot.Collection.foldername.Properties.MessageFormat  = format;
SET OutputRoot.Collection.foldername.Properties.Encoding       = encoding;
SET OutputRoot.Collection.foldername.Properties.CodedCharSetId = ccsid;

SET OutputRoot.Collection.foldername.domain.content=some data;