IBM MQ Propiedades de definiciones de servicio

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:

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:
  • Unidireccional significa que un mensaje se envía a una sola dirección.
  • Petición-Respuesta significa que un mensaje se envía y se recibe una respuesta.
Tipo de enlace Especifica la versión de la especificación de 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, Action 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 de destino de cola o de destino de tema de un IRI de IBM MQ , como por ejemplo:

msg/queue/INS.QUOTE.REPLY
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 a este problema es minimizar la cantidad de información de enlace incorporada en una definición de servicio y permitir que la infraestructura subyacente o IBM MQ direccione los mensajes cuando sea posible.
Nombre de tabla de canales Especifica el nombre del archivo de la tabla de canal de cliente que se utiliza para identificar la conexión del canal.
  • Si no se especifica Channel table name, Channel table library se ignora.
  • Si alguna de las variables de entorno MQSERVER o MQCHLTAB se establece en el entorno en el que se ejecuta la aplicación cliente, Channel table name se ignora.
Biblioteca de tablas de canales Especifica la vía de acceso a la tabla de canal del cliente.
  • Si las variables de entorno MQSERVER o MQCHLLIB se establecen en el entorno en el que se ejecuta la aplicación cliente, Channel table library se ignora.
  • Si no se especifica Channel table name, Channel table library se ignora.
Nombre de conexión de canal de cliente Especifica la serie de conexión utilizada cuando un solicitante de servicio realiza una conexión de enlace de cliente MQI de IBM MQ . Para TCP/IP, la conexión tiene el formato de un nombre de host seguido por un número de puerto, por ejemplo:

OS2ROG3(1822)
Si no se especifica el número de puerto, se utilizará un valor predeterminado de 1414.
  • Si se especifica Client channel connection name, también se deben especificar Client channel name y Client channel transport type.
  • Si la variable de entorno MQSERVER o MQCHLTAB se establece en el entorno en el que se ejecuta la aplicación cliente, Client channel connection name se ignora.
Nombre de canal de cliente Especifica el canal utilizado cuando un solicitante de servicio de IBM MQ realiza una conexión de enlace de cliente MQI de IBM MQ .
  • Si se especifica Client channel connection name, también se deben especificar Client channel name y Client channel transport type.
  • Si la variable de entorno MQSERVER o MQCHLTAB se establece en el entorno en el que se ejecuta la aplicación cliente, Client channel name se ignora.
Tipo de transporte de canal de cliente Especifica el tipo de transporte que debe utilizarse cuando un solicitante de servicio de IBM MQ realiza una conexión de enlace de cliente MQI de IBM MQ .
  • Si se especifica Client channel connection name, también se deben especificar Client channel name y Client channel transport type.
  • Si la variable de entorno MQSERVER o MQCHLTAB se establece en el entorno en el que se ejecuta la aplicación cliente, Transport type se ignora.
Es posible seleccionar entre dos valores distintos:
  • TCP. Se utiliza para especificar el protocolo de transporte TCP/IP. Éste es el valor predeterminado.
  • LU62. Se utiliza para especificar el protocolo de transporte LU6.2.

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, esto se puede modelar utilizando los tipos xsd XML incorporados como xsd:string o xsd:int. Para tipos más complejos, se puede importar un tipo de datos desde un archivo externo especificando Import schema file y Import namespace 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 de acuerdo con las directrices del campo Formato.

Propiedades de usuario Especifica los datos definidos por el usuario transportados 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:

<name dt="datatype">value</name>
El elemento dt="datatype" es opcional y, si se omite, se trata como una serie, lo que permite especificar elementos como:

<name>value</name>
Por ejemplo:

<myprop1>value1</myProp1><myprop2>value2</myProp2><myprop3 dt="i4">99</myProp3>
Para más información sobre los tipos de datos y el formato permitidos, véase NameValueData ( MQCHARn ) en IBM Documentation. 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:
  • Sin especificar, lo que significa que no se establece ningún valor, por lo tanto, el valor se toma del valor de Message exchange pattern. Éste es el valor predeterminado.
  • Solicitud que significa que el mensaje es uno que requiere una respuesta. Este valor indica que el servicio utiliza un patrón de intercambio de mensajes de petición-respuesta.
  • Reproducción que significa que el mensaje es una respuesta a una petición.
  • Informe que significa que el mensaje es un informe.
  • Datagrama que significa que el servicio es un intercambio de mensajes unidireccional y no habrá respuesta.
Si no se especifica ningún valor, el valor se establecerá en función del Patrón de intercambio de mensajes.
Persistence Especifica si el mensaje es permanente o no y corresponde al campo Permanencia en la estructura MQMD. Los tres valores posibles son:
  • No permanente que significa que los mensajes no son permanentes.
  • Permanente que significa que los mensajes son permanentes.
  • Cola predeterminada que significa que el gestor de colas determina la permanencia del mensaje a partir de la definición del destino en el que se haya puesto el mensaje. Éste es el valor predeterminado.
ID de mensaje Especifica el identificador de mensaje que corresponde al campo MsgId en la estructura MQMD.

El ID de mensaje permite que determinadas aplicaciones IBM MQ especializadas se describan como servicios (por ejemplo: aplicaciones que comparten una cola de entrada y seleccionan los mensajes destinados a ellas basándose en un valor 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.

Prioridad 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.

Encoding Especifica la codificación numérica de los datos del mensaje, que corresponde al campo Codificación de la estructura MQMD:
  • Entero le permite seleccionar Normal o Invertido
  • Decimal le permite seleccionar Normal o Invertido
  • Flotante le permite seleccionar Normal, Invertido o S390
  • Mnemónico especifica el mnemónico de 3 caracteres basado en los otros valores seleccionados. R = Invertido, N = Normal y 3 = S390.
  • Valor especifica el valor numérico de las selecciones y mnemónico.
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:
  • ID de mensaje nuevo indica que si se ha generado un informe o una respuesta como resultado de este mensaje, se generará un nuevo valor msgId para el informe o el mensaje de respuesta.
  • ID de mensaje de paso indica que si se genera un informe o una respuesta como resultado de este mensaje, el valor msgId de este mensaje se copiará en el valor msgId del informe o del mensaje de respuesta.
  • Copiar el ID de mensaje en el ID de correlación indica que si se genera un informe o una respuesta como resultado de este mensaje, el valor msgId de este mensaje se copiará en el valor correlId del informe o del mensaje de respuesta.
  • ID de correlación de paso indica que si se genera un informe o respuesta como resultado de este mensaje, el correlId de este mensaje se copia en el correlId del informe o del mensaje de respuesta.

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 la partícula de destino de cola o de destino de tema de un URI de IBM MQ , como por ejemplo:

msg/queue/INS.QUOTE.REPLY
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 a este problema es minimizar la cantidad de información de enlace incorporada en una definición de servicio y permitir que la infraestructura subyacente o IBM MQ direccione los mensajes cuando sea posible.
Nombre de tabla de canales Especifica el nombre del archivo de la tabla de canal de cliente que se utiliza para identificar la conexión del canal.
  • Si no se especifica Channel table name, Channel table library se ignora.
  • Si alguna de las variables de entorno MQSERVER o MQCHLTAB se establece en el entorno en el que se ejecuta la aplicación cliente, Channel table name se ignora.
Biblioteca de tablas de canales Especifica la vía de acceso a la tabla de canal del cliente.
  • Si las variables de entorno MQSERVER o MQCHLLIB se establecen en el entorno en el que se ejecuta la aplicación cliente, Channel table library se ignora.
  • Si no se especifica Channel table name, Channel table library se ignora.
Nombre de canal de cliente Especifica la serie de conexión utilizada cuando un solicitante de servicio realiza una conexión de enlace de cliente MQI de IBM MQ . Para TCP/IP, la conexión tiene el formato de un nombre de host seguido por un número de puerto, por ejemplo:

OS2ROG3(1822)
Si no se especifica el número de puerto, se utilizará un valor predeterminado de 1414.
  • Si se especifica Client channel connection name, también se deben especificar Client channel name y Client channel transport type.
  • Si la variable de entorno MQSERVER o MQCHLTAB se establece en el entorno en el que se ejecuta la aplicación cliente, Client channel connection name se ignora.
Nombre de conexión de canal de cliente Especifica el canal utilizado cuando un solicitante de servicio de IBM MQ realiza una conexión de enlace de cliente MQI de IBM MQ .
  • Si se especifica Client channel connection name, también se deben especificar Client channel name y Client channel transport type.
  • Si la variable de entorno MQSERVER o MQCHLTAB se establece en el entorno en el que se ejecuta la aplicación cliente, Client channel name se ignora.
Tipo de transporte de canal de cliente Especifica el tipo de transporte que debe utilizarse cuando un solicitante de servicio de IBM MQ realiza una conexión de enlace de cliente MQI de IBM MQ .
  • Si se especifica Client channel connection name, también se deben especificar Client channel name y Client channel transport type.
  • Si la variable de entorno MQSERVER o MQCHLTAB se establece en el entorno en el que se ejecuta la aplicación cliente, Transport type se ignora.
Es posible seleccionar entre dos valores distintos:
  • TCP. Se utiliza para especificar el protocolo de transporte TCP/IP. Éste es el valor predeterminado.
  • LU62. Se utiliza para especificar el protocolo de transporte LU6.2.

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 de acuerdo con las directrices del campo Formato.

Propiedades de usuario Especifica los datos definidos por el usuario transportados 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:

<name dt="datatype">value</name>
El elemento dt="datatype" es opcional y, si se omite, se trata como una serie, lo que permite especificar elementos como:

<name>value</name>
Por ejemplo:

<myprop1>value1</myProp1><myprop2>value2</myProp2><myprop3 dt="i4">99</myProp3>
Para más información sobre los tipos de datos y el formato permitidos, véase NameValueData ( MQCHARn ) en IBM Documentation. 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:
  • Sin especificar, lo que significa que no se establece ningún valor, por lo tanto, el valor se toma del valor de Message exchange pattern. Éste es el valor predeterminado.
  • Solicitud que significa que el mensaje es uno que requiere una respuesta. Este valor indica que el servicio utiliza un patrón de intercambio de mensajes de petición-respuesta.
  • Reproducción que significa que el mensaje es una respuesta a una petición.
  • Informe que significa que el mensaje es un informe.
  • Datagrama que significa que el servicio es un intercambio de mensajes unidireccional y no habrá respuesta.
Si no se especifica ningún valor, el valor se establecerá en función del Patrón de intercambio de mensajes.
Persistence Especifica si el mensaje es permanente o no y corresponde al campo Permanencia en la estructura MQMD. Los tres valores posibles son:
  • No permanente que significa que los mensajes no son permanentes.
  • Permanente que significa que los mensajes son permanentes.
  • Cola predeterminada que significa que el gestor de colas determina la permanencia del mensaje a partir de la definición del destino en el que se haya puesto el mensaje. Éste es el valor predeterminado.
ID de mensaje Especifica el identificador de mensaje que corresponde al campo MsgId en la estructura MQMD.

El ID de mensaje permite que determinadas aplicaciones IBM MQ especializadas se describan como servicios (por ejemplo: aplicaciones que comparten una cola de entrada y seleccionan los mensajes destinados a ellas basándose en un valor 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.

Prioridad 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.

Encoding Especifica la codificación numérica de los datos del mensaje, que corresponde al campo Codificación de la estructura MQMD:
  • Entero le permite seleccionar Normal o Invertido
  • Decimal le permite seleccionar Normal o Invertido
  • Flotante le permite seleccionar Normal, Invertido o S390
  • Mnemónico especifica el mnemónico de 3 caracteres basado en los otros valores seleccionados. R = Invertido, N = Normal y 3 = S390.
  • Valor especifica el valor numérico de las selecciones y mnemónico.
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:
  • ID de mensaje nuevo indica que se han generado informes o respuestas como resultado de este mensaje; e genera un msgId nuevo para el informe o el mensaje de respuesta.
  • ID de mensaje de paso indica que si se genera un informe o una respuesta como resultado de este mensaje, el valor msgId de este mensaje se copiará en el valor msgId del informe o del mensaje de respuesta.
  • Copiar el ID de mensaje en el ID de correlación indica que si se genera un informe o una respuesta como resultado de este mensaje, el valor msgId de este mensaje se copiará en el valor correlId del informe o del mensaje de respuesta.
  • ID de correlación de paso indica que si se genera un informe o respuesta como resultado de este mensaje, el correlId de este mensaje se copia en el correlId del informe o del mensaje de respuesta.