CONNAME (Nombre de conexión)

Este atributo es el identificador de conexión de comunicaciones. Especifica los enlaces de comunicaciones concretos que tiene que utilizar un canal.

Es opcional para los canales de servidor, a menos que se desencadene el canal de servidor, en cuyo caso debe especificar un nombre de conexión.

Especifique CONNAME como una lista separada por comas de nombres de máquinas para el TRPTYPE indicado. Normalmente, sólo se necesita un nombre de máquina. Puede proporcionar varios nombres de máquinas para configurar varias conexiones con las mismas propiedades. Las conexiones se intentan normalmente en el orden en el que se especifican en la lista de conexiones hasta que se establece una conexión satisfactoriamente. El pedido se modifica para los clientes si se proporciona el atributo CLNTWGHT. Si ninguna conexión es satisfactoria, el canal intenta de nuevo la conexión, según lo determinado por los atributos del canal. Con los canales de cliente, una lista de conexiones proporciona una alternativa a la utilización de grupos de gestores de colas para configurar varias conexiones. Con los canales de mensajes, se utiliza una lista de conexiones para configurar conexiones con las direcciones alternativas de un gestor de colas de varias instancias.

Proporcionar varios nombres de conexión en una lista se soportó por primera vez en IBM® WebSphere® MQ 7.0.1. Cambia la sintaxis del parámetro CONNAME. Los clientes y gestores de colas de versiones anteriores se conectan utilizando el primer nombre de conexión de la lista y no leen el resto de los nombres de conexión de la lista. Para que los clientes y los gestores de colas de versiones anteriores analicen la nueva sintaxis, debe especificar un número de puerto en el primer nombre de conexión de la lista. La especificación de un número de puerto evita problemas al conectarse al canal desde un cliente o gestor de colas que se ejecuta en un nivel anterior a IBM WebSphere MQ 7.0.1.

[UNIX, Linux, Windows, IBM i]En Multiplatforms, el parámetro de nombre de conexión TCP/IP de un canal de clúster receptor es opcional. Si deja el nombre de conexión en blanco, IBM MQ genera automáticamente un nombre de conexión, asumiendo el puerto predeterminado y utilizando la dirección IP actual del sistema. Puede modificar el número de puerto predeterminado y seguir utilizando la dirección IP actual del sistema. Para cada nombre de conexión deje en blanco el nombre de IP y suministre el número de puerto entre paréntesis; por ejemplo:

(1415)
El CONNAME generado siempre está en el formato decimal con puntos (IPv4) o hexadecimal (IPv6), en lugar de en forma de nombre de host DNS alfanumérico.
La longitud máxima del nombre depende de la plataforma:
  • [UNIX, Linux, Windows, IBM i]264 caracteres.
  • [z/OS]48 caracteres (consulte la nota 1).
Si el tipo de transporte es TCP
CONNAME es el nombre de host o la dirección de red de la máquina remota (o la máquina local para canales de clúster receptor). Por ejemplo, (ABC.EXAMPLE.COM), (2001:DB8:0:0:0:0:0:0) o (127.0.0.1). Puede incluir el número de puerto, por ejemplo (MACHINE(123)).
[z/OS]Puede incluir el IP_name de un grupo DNS dinámico o un puerto de entrada de Network Dispatcher .
Si utiliza una dirección IPv6 en una red que sólo da soporte a IPv4, el nombre de conexión no se resuelve. En una red que utiliza IPv4 y IPv6, el nombre de conexión interactúa con la dirección local para determinar qué pila IP se utiliza. Consulte LOCLADDR (Dirección local) para obtener más información.
Si el tipo de transporte es LU 6.2
[UNIX, Linux, Windows, IBM i]Si se especifican TPNAME y MODENAME, proporcione el nombre completo de la LU asociada. Si TPNAME y MODENAME están en blanco, proporcione el nombre de objeto de información complementaria CPI-C para la plataforma específica.
[z/OS]Hay dos formatos en los que especificar el valor:
  • Nombre de unidad lógica
    La información de unidad lógica para el gestor de colas, que comprende el nombre de unidad lógica, el nombre de TP y el nombre de modalidad opcional. Este nombre se puede especificar con uno de estos tres formatos:
    Tabla 1. Formas y unidades de unidad lógica
    Formulario Ejemplo
    nombrelu IGY12355
    nombre de unidad lógica/nombre TP IGY12345/APING
    nombre de unidad lógica/nombre TP/nombre modalidad IGY12345/APINGD/#INTER
    Para el primer formato, el nombre de TP y el nombre de modalidad deben especificarse para los atributos TPNAME y MODENAME; de lo contrario, estos atributos deben estar en blanco. Para los canales de conexión de cliente, sólo se permite el primer formato.
  • Nombre simbólico

    El nombre de destino simbólico para la información de unidad lógica para el gestor de colas, tal como se define en el conjunto de datos de información complementaria. Los atributos TPNAME y MODENAME deben estar en blanco. Tenga en cuenta que, para los canales de clúster receptor, la información complementaria está en los otros gestores de colas del clúster. En este caso, puede ser un nombre que una salida de definición automática de canal puede resolver en la información de unidad lógica adecuada para el gestor de colas local.

El nombre de LU especificado o implícito puede ser el de un grupo de recursos genéricos VTAM.
Si el protocolo de transmisión es NetBIOS
CONNAME es el nombre NetBIOS definido en la máquina remota.
Si el protocolo de transmisión es SPX
CONNAME es una dirección de estilo SPX que consta de una dirección de red de 4 bytes, una dirección de nodo de 6 bytes y un número de socket de 2 bytes. Especifique estos valores en hexadecimal, con las direcciones de red y nodo separadas por un punto y el número de socket entre corchetes. Por ejemplo:

CONNAME('0a0b0c0d.804abcde23a1(5e86)')

Si se omite el número de socket, se utiliza el número de socket SPX de IBM MQ predeterminado. El valor predeterminado es X'5E86'.

Este atributo es válido para los tipos de canal de:
  • Emisor
  • Servidor
  • Peticionario
  • Conexión de cliente
  • Clúster emisor
  • Clúster receptor

Es opcional para los canales de servidor, a menos que se desencadene el canal de servidor, en cuyo caso debe especificar un nombre de conexión.

Nota:
  1. Para las longitudes de nombre, puede solucionar el límite de 48 caracteres de una de las formas siguientes:
    • Configure los servidores DNS para que utilice, por ejemplo, el nombre de host de "myserver" en lugar de "myserver.location.company.com", asegurándose de que puede utilizar el nombre de host abreviado.
    • Utilizar direcciones IP.
  2. La definición del protocolo de transmisión está contenida en TRPTYPE (Tipo de transporte).