Puede declarar componentes de registro MQ en un archivo fuente de EGL. Para obtener una visón
general de ese archivo, consulte el apartado Formato fuente EGL.
Para obtener una visión general de la forma en que EGL interactúa con
MQSeries,
consulte el apartado Soporte de
MQSeries.
A continuación se ofrece un ejemplo de componente de registro MQ:
Record MQRecordPart type mqRecord
{
queueName = "myQueue"
}
10 myField01 CHAR(2);
10 myField02 CHAR(78);
end
El diagrama de sintaxis de un componente de registro MQ es el siguiente:
- Record nombreComponenteRegistro mqRecord
- Identifica el componente como de tipo mqRecord y especifica el nombre.
Para conocer las normas, consulte el apartado Convenios de denominación.
- queueName = "nombreColaMsg"
- El nombre de la cola de mensajes, que es el nombre de la cola lógica y, generalmente, no el
nombre de la cola física. Para obtener detalles acerca del formato de la entrada, consulte el apartado Propiedades de registros MQ.
- getOptionsRecord = "obtenerNombreRegistro"
- Identifica una variable de programa (un registro básico) utilizada como registro de opciones get. Para obtener detalles, consulte el apartado Registros de opciones para registros MQ. Esta propiedad era anteriormente la propiedad getOptions.
- putOptionsRecord = "ponerNombreRegistro"
- Identifica una variable de programa (un registro básico) utilizada como registro de opciones put. Para obtener detalles, consulte el apartado Registros de opciones para registros MQ. Esta propiedad era anteriormente la propiedad putOptions.
- openOptionsRecord = "abrirNombreRegistro"
- Identifica una variable de programa (un registro básico) utilizada como registro de opciones open. Para obtener detalles, consulte el apartado Registros de opciones para registros MQ. Esta propiedad era anteriormente la propiedad openOptions.
- msgDescriptorRecord = "nombreRegDescMsg"
- Identifica una variable de programa (un registro básico) utilizada como descriptor de mensajes. Para obtener detalles, consulte el apartado Registros de opciones para registros MQ. Esta propiedad era anteriormente la propiedad msgDescriptor.
- queueDescriptorRecord = "nombreRegDescColas"
- Identifica una variable de programa (un registro básico) utilizada como descriptor de colas. Para obtener detalles, consulte el apartado Registros de opciones para registros MQ. Esta propiedad era anteriormente la propiedad queueDescriptor.
- includeMsgInTransaction = yes, incluirMsgEnTransacción =
no
- Si esta propiedad se establece en yes (valor por omisión), cada
uno de los mensajes específicos de registro se incorpora en una transacción, y el código puede comprometer
o retrotraer dicha transacción. Para obtener detalles acerca de las implicaciones de su elección, consulte el apartado
Soporte de
MQSeries.
- openQueueExclusive = no, openQueueExclusive
= yes
- Si esta propiedad se establece en yes, el código tiene la capacidad exclusiva de leer la cola de mensajes; de lo contrario, otros programas podrán leer la cola.
El valor por omisión es no. Esta propiedad es equivalente a la opción de
MQSeries
MQOO_INPUT_EXCLUSIVE.
- lengthItem = "campoLongitud"
- El campo de longitud, tal como se describe en Propiedades de registro MQ.
- numElementsItem = "campoNúmElementos"
- El campo de número de elementos, tal como se describe en Propiedades de registro MQ.
- campoEstructura
- Un campo de estructura, como se describe en la sección Elemento de estructura en formato
fuente EGL.