Propiedades de definición de servicio de IBM MQ
Puede definir propiedades y atributos para definiciones de servicio al crear una nueva definición de servicio, o al editar una definición de servicio existente.
Algunos atributos solamente estarán disponibles cuando la definición de servicio sea de un tipo de enlace específico o un patrón de intercambio de mensajes específico. Siga estos enlaces para ver las propiedades para las páginas de propiedades individuales de una definición de servicio:
- General
- Operación
- Destino de entrada
- Esquema de mensaje de entrada
- Cabecera de mensaje de entrada
- Destino de salida
- Esquema de mensaje de salida
- Cabecera de mensaje de salida
Para cada atributo, hay una breve descripción de los casos en los que posiblemente tenga que configurar el atributo.
Página General
En la tabla siguiente se listan los atributos que puede establecer en la página General del diálogo de Propiedades de definición de servicio.
Atributo | Descripción |
---|---|
Espacio de nombres | Especifica el espacio de nombres para el servicio. Ya hay asignado un valore predeterminado temporal. |
Nombre | Un nombre exclusivo para la definición de servicio nueva. El nombre de la definición de servicio no es sensible a mayúsculas y minúsculas, sino que se conserva un nombre de definición de servicio con mayúsculas y minúsculas. |
Patrón de intercambio de mensajes | El patrón de intercambio de mensajes describe la dirección de los mensajes enviados y recibidos durante la invocación de un servicio.
Hoy dos selecciones posibles:
|
Tipo de enlace | Especifica la versión de la especificación de la definición de servicio de IBM® MQ. |
Comentario | Especifique un comentario para anotar el servicio en el archivo WSDL. |
Página de operación
En la tabla siguiente se listan los atributos que puede establecer en la página Operación del diálogo de Propiedades de definición de servicio. Cada definición de servicio tiene una sola operación.
Atributo | Descripción |
---|---|
Nombre de operación | Especifica el nombre de la operación. Esta propiedad debe tener un valor para crear una definición de servicio. |
Acción | La utiliza el proveedor de servicios para asignar solicitudes de servicio. Por ejemplo: si se permite desplegar diversos servidores utilizando un destino único, se permitirá que un proveedor de servicios despache las peticiones que lleguen a su destino adecuadamente. Cuando el tipo de enlace es MQ, Acción especifica targetAction. |
Comentario | Especifique un comentario para anotar la operación en el archivo WSDL. |
Página de destino de entrada
En la tabla siguiente se listan los atributos que puede establecer en la página Destino de entrada del diálogo de Propiedades de definición de servicio. Las páginas de entrada definen los detalles del mensaje que espera el servicio y el destino de donde se va a desplegar.
Atributo | Descripción |
---|---|
Nombre de destino de entrada | Especifica el nombre de la cola de destino o el tema de destino al cual se envía la petición, por ejemplo: La partícula cola-dest o tema-dest de un IRI de IBM MQ, como por ejemplo:
|
Nombre del gestor de colas de destino | Especifica el nombre del gestor de colas de destino. |
Gestor de colas de conexión | Especifica el nombre del gestor de colas al cual se conecta el servicio solicitante. Corresponde al parámetro QmgrName que se utiliza en las llamadas MQCONN() y MQCONNX(). |
Propiedades de conexión del cliente | Las propiedades de conexión del cliente especifican enlaces detallados que pueden incluir información sobre cómo se enlaza un solicitante de servicio con una máquina o canal específico. En algunas circunstancias, resulta útil poder especificar enlaces de cliente y nombres de canal, pero si se excede en el volumen de especificaciones, el servicio podría verse restringido. Una solución para este problema es minimizar la cantidad de información de enlace que se incorpora a una definición de servicio y permitir que la infraestructura subyacente o IBM MQ direcciones los mensajes siempre que sea posible. |
Nombre de tabla de canal | Especifica el nombre del archivo de la tabla de canal de cliente que se utiliza para identificar la conexión del canal.
|
Biblioteca de tabla de canal | Especifica la vía de acceso a la tabla de canal del cliente.
|
Nombre de conexión del canal de cliente | Especifica la serie de conexión que se utiliza cuando un solicitante de servicio realiza una conexión de enlace de cliente IBM MQ MQI. Para TCP/IP, la conexión tiene el formato de un nombre de host seguido por un número de puerto, por ejemplo:
Si no se especifica el número de puerto, se utilizará un valor predeterminado de 1414.
|
Nombre del canal de cliente | Especifica el canal que se utiliza cuando un solicitante de servicio de IBM MQ realiza una conexión de enlace de cliente de IBM MQ MQI.
|
Tipo de transporte del canal de cliente | Especifica el tipo de transporte que se utiliza cuando un solicitante de servicio de IBM MQ realiza una conexión de enlace de cliente IBM MQ MQI.
|
Página de esquema del mensaje de entrada
En la tabla siguiente se listan los atributos que puede establecer en la página Esquema del mensaje de entrada del diálogo de Propiedades de definición de servicio. Permiten definir el esquema de la carga útil del mensaje.
Atributo | Descripción |
---|---|
Tipo de datos de entrada | Especifica el tipo de datos de entrada que se esperan. Para tipos simples, se pueden modelar utilizando los tipos xsd de XML incorporado, como por ejemplo, xsd:string o xsd:int .
Para tipos más completos, un tipo de datos se puede importar de un archivo externo especificando el Archivo de esquema de importación y el Espacio de nombres de importación para el tipo de datos. |
Archivo de esquema de importación | Especifica el archivo de esquema que se debe importar. |
Espacio de nombres de importación | Especifica el espacio de nombres que se debe importar. |
Página de cabecera del mensaje de entrada
En la tabla siguiente se listan los atributos que puede establecer en la página Cabecera del mensaje de entrada del diálogo de Propiedades de definición de servicio. Las páginas de entrada definen los detalles del mensaje que espera el servicio y el destino de donde se va a desplegar. Algunas propiedades no solamente se aplican a definiciones de servicios de un tipo de enlaces MQ.
Atributo | Descripción |
---|---|
CCSID | Especifica el ID de juego de caracteres codificado que corresponde al campo CodedCharSetId en la estructura MQMD. Si no se especifica este valor, el solicitante de servicio y el proveedor de servicios utilizarán el valor que corresponda al juego de caracteres de los datos del mensaje. |
Formato | Especifica el nombre de formato de los datos del mensaje. Esta propiedad corresponde al campo de formato MQRFH2 o al campo de formato MQMD si no hay ningún MQRFH2. El valor debe ser una serie de caracteres entre 0 y 8 caracteres de largo formada por caracteres de la A a la Z y del 0 al 9. El Formato se puede establecer en cualquier valor según las directrices de Campo Formato. |
Propiedades de usuario | Especifica los datos definidos por el usuario que se incluían en los mensajes de servicio de IBM MQ. Los valores se deben especificar en el formato permitido para elementos de la carpeta RFH2; en una serie de tripletes codificados mediante una sintaxis del tipo XML, como por ejemplo:
El elemento dt="datatype "
es opcional y, si se omite, se tratará como una serie, permitiendo especificar elementos como:
Por ejemplo:
Puede obtener información adicional sobre los tipos de datos y los formatos permitidos consultando NameValueData ( MQCHARn ) en IBM Knowledge Center.
No se recomienda incluir propiedades sensibles a la seguridad como, por ejemplo, ID de usuario o contraseñas. |
Tipo de mensaje | Especifica el tipo de mensaje que se envía.
Esta propiedad corresponde a MsgType en la estructura MQMD.
Los cinco valores
posibles son:
|
Persistencia | Especifica si el mensaje es permanente o no y corresponde al campo Permanencia en la estructura MQMD. Los tres valores
posibles son:
|
ID del mensaje | Especifica el identificador de mensaje que corresponde al campo MsgId en la estructura MQMD. El ID de mensaje permite que ciertas aplicaciones especializadas de IBM MQ se describan como servicios (por ejemplo: aplicaciones que comparten una cola de entrada y seleccionan los mensajes dirigidos a las mismas según un valor de msgId predefinido). Los valores de msgIds predefinidos en las definiciones de servicio pueden generar problemas como por ejemplo cuando un patrón de intercambio de mensajes de tipo petición-respuesta devuelve el msgId de petición. El ID de mensaje puede ser una serie de caracteres o un valor binario. Los valores binarios deber ser una serie de hasta 24 pares de valores hexadecimales de dos caracteres.Pulse Editar para abrir un diálogo y especificar un valor como texto o bytes. |
ID de correlación | Especifica el ID de correlación que corresponde al campo CorrelId en la estructura
MQMD. El ID de correlación puede ser una serie de caracteres o un valor binario. Los valores binarios deber ser una serie de hasta 24 pares de valores hexadecimales de dos caracteres. Pulse Editar para abrir un diálogo y especificar un valor como texto o bytes. |
Caducidad | Especifica la duración del mensaje. Debe ser un entero firmado y se mide en décimas de segundo. El rango de Caducidad está entre 1 y 2.147.483.647. El valor especial de Sin límite se utiliza para indicar que el mensaje no caduca. El valor de -1 se graba en el archivo WSDL. Un valor de Sin especificar significa que no se graba ningún valoren el archivo WSDL. Éste es el valor predeterminado. |
Priority | Especifica la prioridad asociada al mensaje y corresponde al campo prioridad de la estructura MQMD.
Se debe especificar como un entero entre 0 y 9, siendo 0 la prioridad más baja y 9 la prioridad más alta. Un valor especial Sin límite se utiliza para indicar que la prioridad del mensaje se toma de la definición de la primera cola en la que se coloca el mensaje. El valor de -1 se graba en el archivo WSDL. Un valor de Sin especificar significa que no se graba ningún valoren el archivo WSDL. Éste es el valor predeterminado. |
Codificación | Especifica la codificación numérica de los datos del mensaje, que corresponde al campo Codificación de la estructura MQMD:
|
Opciones de informe | Especifica cómo establece el proveedor de servicios el mensaje y los identificadores de correlación en el mensaje de respuesta o en el mensaje de error.
Esta propiedad corresponde al campo Informe de la estructura MQMD.
Hay cuatro valores posibles:
|
Página de destino de salida
En la tabla siguiente se listan los atributos que puede establecer en la página Destino de salida del diálogo de Propiedades de definición de servicio. Las páginas de salida definen los detalles del mensaje que enviará el servicio como respuesta al mensaje de entrada y el destino en el que se colocará. El nombre de destino de salida debe llevar el prefijo 'msg/queue/' para colas, o 'msg/topic/' para temas.
Atributo | Descripción |
---|---|
Nombre de destino de salida | Especifica el nombre de la cola de destino o el tema de destino al cual se envía el mensaje de respuesta y corresponde a los campos ReplyToQ y ReplyToQMgr de la estructura MQMD. El nombre de destino debe tener el formato de partícula
cola-dest o tema-dest de un URI de IBM MQ, como por ejemplo:
|
Nombre del gestor de colas de destino | Especifica el nombre del gestor de colas de destino. |
Gestor de colas de conexión | Especifica el nombre del gestor de colas al cual se conecta el servicio solicitante. Corresponde al parámetro QmgrName que se utiliza en las llamadas MQCONN() y MQCONNX(). |
Propiedades de conexión del cliente | Las propiedades de conexión del cliente especifican enlaces detallados que pueden incluir información sobre cómo se enlaza un solicitante de servicio con una máquina o canal específico. En algunas circunstancias, resulta útil poder especificar enlaces de cliente y nombres de canal, pero si se excede en el volumen de especificaciones, el servicio podría verse restringido. Una solución para este problema es minimizar la cantidad de información de enlace que se incorpora a una definición de servicio y permitir que la infraestructura subyacente o IBM MQ direcciones los mensajes siempre que sea posible. |
Nombre de tabla de canal | Especifica el nombre del archivo de la tabla de canal de cliente que se utiliza para identificar la conexión del canal.
|
Biblioteca de tabla de canal | Especifica la vía de acceso a la tabla de canal del cliente.
|
Nombre del canal de cliente | Especifica la serie de conexión que se utiliza cuando un solicitante de servicio realiza una conexión de enlace de cliente IBM MQ MQI. Para TCP/IP, la conexión tiene el formato de un nombre de host seguido por un número de puerto, por ejemplo:
Si no se especifica el número de puerto, se utilizará un valor predeterminado de 1414.
|
Nombre de conexión del canal de cliente | Especifica el canal que se utiliza cuando un solicitante de servicio de IBM MQ realiza una conexión de enlace de cliente de IBM MQ MQI.
|
Tipo de transporte del canal de cliente | Especifica el tipo de transporte que se utiliza cuando un solicitante de servicio de IBM MQ realiza una conexión de enlace de cliente IBM MQ MQI.
|
Página de esquema del mensaje de salida
En la tabla siguiente se listan los atributos que puede establecer en la página Esquema del mensaje de salida del diálogo de Propiedades de definición de servicio. Permiten definir el esquema de la carga útil del mensaje.
Atributo | Descripción |
---|---|
Tipo de datos de salida | Especifica el tipo de datos de salida que se esperan. |
Archivo de esquema de importación | Especifica el archivo de esquema que se debe importar |
Espacio de nombres de importación | Especifica el espacio de nombres que se debe importar |
Página de cabecera del mensaje de salida
En la tabla siguiente se listan los atributos que puede establecer en la página Cabecera del mensaje de salida del diálogo de Propiedades de definición de servicio. Las páginas de salida definen los detalles del mensaje que enviará el servicio como respuesta al mensaje de entrada y el destino en el que se colocará. Algunas propiedades no solamente se aplican a definiciones de servicios de un tipo de enlaces MQ.
Atributo | Descripción |
---|---|
CCSID | Especifica el ID de juego de caracteres codificado que corresponde al campo CodedCharSetId en la estructura MQMD. Si no se especifica este valor, el solicitante de servicio y el proveedor de servicios utilizarán el valor que corresponda al juego de caracteres de los datos del mensaje. |
Formato | Especifica el nombre de formato de los datos del mensaje. Esta propiedad corresponde al campo de formato MQRFH2 o al campo de formato MQMD si no hay ningún MQRFH2. El valor debe ser una serie de caracteres entre 0 y 8 caracteres de largo formada por caracteres de la A a la Z y del 0 al 9. El Formato se puede establecer en cualquier valor según las directrices de Campo Formato. |
Propiedades de usuario | Especifica los datos definidos por el usuario que se incluían en los mensajes de servicio de IBM MQ. Los valores se deben especificar en el formato permitido para elementos de la carpeta RFH2; en una serie de tripletes codificados mediante una sintaxis del tipo XML, como por ejemplo:
El elemento dt="datatype "
es opcional y, si se omite, se tratará como una serie, permitiendo especificar elementos como:
Por ejemplo:
Puede obtener información adicional sobre los tipos de datos y los formatos permitidos consultando NameValueData ( MQCHARn ) en IBM Knowledge Center.
No se recomienda incluir propiedades sensibles a la seguridad como, por ejemplo, ID de usuario o contraseñas. |
Tipo de mensaje | Especifica el tipo de mensaje que se envía.
Esta propiedad corresponde a MsgType en la estructura MQMD.
Los cinco valores
posibles son:
|
Persistencia | Especifica si el mensaje es permanente o no y corresponde al campo Permanencia en la estructura MQMD. Los tres valores
posibles son:
|
ID del mensaje | Especifica el identificador de mensaje que corresponde al campo MsgId en la estructura MQMD. El ID de mensaje permite que ciertas aplicaciones especializadas de IBM MQ se describan como servicios (por ejemplo: aplicaciones que comparten una cola de entrada y seleccionan los mensajes dirigidos a las mismas según un valor de msgId predefinido). Los valores de msgIds predefinidos en las definiciones de servicio pueden generar problemas como por ejemplo cuando un patrón de intercambio de mensajes de tipo petición-respuesta devuelve el msgId de petición. El ID de mensaje puede ser una serie de caracteres o un valor binario. Los valores binarios deber ser una serie de hasta 24 pares de valores hexadecimales de dos caracteres.Pulse Editar para abrir un diálogo y especificar un valor como texto o bytes. |
ID de correlación | Especifica el ID de correlación que corresponde al campo CorrelId en la estructura
MQMD. El ID de correlación puede ser una serie de caracteres o un valor binario. Los valores binarios deber ser una serie de hasta 24 pares de valores hexadecimales de dos caracteres. Pulse Editar para abrir un diálogo y especificar un valor como texto o bytes. |
Caducidad | Especifica la duración del mensaje. Debe ser un entero firmado y se mide en décimas de segundo. El rango de Caducidad está entre 1 y 2.147.483.647. El valor especial de Sin límite se utiliza para indicar que el mensaje no caduca. El valor de -1 se graba en el archivo WSDL. Un valor de Sin especificar significa que no se graba ningún valoren el archivo WSDL. Éste es el valor predeterminado. |
Priority | Especifica la prioridad asociada al mensaje y corresponde al campo de prioridad de la estructura MQMD.
Se debe especificar como un entero entre 0 y 9, siendo 0 la prioridad más baja y 9 la prioridad más alta. Un valor especial Sin límite se utiliza para indicar que la prioridad del mensaje se toma de la definición de la primera cola en la que se coloca el mensaje. El valor de -1 se graba en el archivo WSDL. Un valor de Sin especificar significa que no se graba ningún valoren el archivo WSDL. Éste es el valor predeterminado. |
Codificación | Especifica la codificación numérica de los datos del mensaje, que corresponde al campo Codificación de la estructura MQMD:
|
Opciones de informe | Especifica cómo establece el proveedor de servicios el mensaje y los identificadores de correlación en el mensaje de respuesta o en el mensaje de error.
Esta propiedad corresponde al campo Informe de la estructura MQMD.
Hay cuatro valores posibles:
|