START LISTENER (iniciar un escucha de canal)
Utilice el mandato START LISTENER de MQSC para iniciar un escucha de canal.
Utilización de mandatos MQSC
Para obtener información sobre cómo utilizar los mandatos MQSC, consulte Administración de IBM® MQ utilizando mandatos MQSC.
Puede emitir este mandato desde orígenes CR. Para obtener una explicación de los símbolos de origen, consulte Orígenes desde los que puede emitir mandatos MQSC y PCF en IBM MQ for z/OS®.
Sinónimo: STA LSTR
![[z/OS]](ngzos.gif)
IBM MQ for z/OS
IBM MQ en otras plataformas
Notas de uso
En z/OS:- El servidor de mandatos y el iniciador de canal deben estar en ejecución.
- Si no se especifica IPADDR, el escucha escucha en todas las direcciones IPv4 y IPv6 disponibles.
- Para TCP/IP, es posible escuchar en varias direcciones y combinaciones de puertos.
- Para cada START LISTENER para la solicitud TCP/IP, la combinación de dirección y puerto se añade a la lista de combinaciones en las que el escucha está escuchando actualmente.
- Una petición START LISTENER para TCP/IP falla si especifica lo mismo, o un subconjunto o superconjunto de una combinación existente, de direcciones y puertos en los que un escucha TCP/IP está escuchando actualmente.
- Si está iniciando un escucha en una dirección específica para proporcionar una interfaz segura con un producto de seguridad, por ejemplo un cortafuegos, es importante asegurarse de que no hay ningún enlace con las otras interfaces no seguras del sistema.
Debe inhabilitar el reenvío de IP y el direccionamiento desde otras interfaces no seguras para que los paquetes que llegan a la otra interfaz no se pasen a esta dirección específica.
Consulte la documentación de TCP/IP adecuada para obtener información sobre cómo hacerlo.
- En Multiplatforms, este mandato sólo es válido para los canales para los que el protocolo de transmisión (TRPTYPE) es TCP.
Descripciones de parámetros para START LISTENER
- ( nombre )
- Nombre del escucha que se va a iniciar. Si especifica este parámetro, no puede especificar ningún otro parámetro.
Si no especifica un nombre
(en plataformas que no sean z/OS ), SYSTEM.DEFAULT.LISTENER.TCP se ha iniciado.
Este parámetro no es válido en z/OS.
CMDSCOPE- Este parámetro sólo se aplica a z/OS y especifica cómo se ejecuta el mandato cuando el gestor de colas es miembro de un grupo de compartición de colas.
- ' '
- El mandato se ejecuta en el gestor de colas en el que se ha especificado. Éste es el valor predeterminado.
- nombre-gestcolas
- El mandato se ejecuta en el gestor de colas que especifique, siempre que el gestor de colas esté activo dentro del grupo de compartición de colas.
Puede especificar un nombre de gestor de colas, que no sea el gestor de colas en el que se ha especificado el mandato, sólo si está utilizando un entorno de grupo de compartición de colas y si el servidor de mandatos está habilitado.
INDISP- Especifica la disposición de las transmisiones de entrada que se van a manejar. Los valores posibles son:
- QMGR
- Escuche las transmisiones dirigidas al gestor de colas. Este es el valor predeterminado.
- GRUPO
- Escuche las transmisiones dirigidas al grupo de compartición de colas. Esto sólo está permitido si hay un entorno de gestor de colas compartido.
IPADDR- Dirección IP para TCP/IP especificada en IPv4 decimal con puntos, IPv6 notación hexadecimal o formato alfanumérico. Esto sólo es válido si el protocolo de transmisión (TRPTYPE) es TCP/IP.
Este parámetro sólo es válido en z/OS.
LUNAME ( serie )- El nombre de destino simbólico para la unidad lógica tal como se especifica en el conjunto de datos de información complementaria APPC. (Debe ser la misma LU que se ha especificado para el gestor de colas, utilizando el parámetro LUNAME del mandato ALTER QMGR.)
Este parámetro sólo es válido para canales con un protocolo de transmisión (TRPTYPE) de LU 6.2. Un mandato START LISTENER que especifique TRPTYPE (LU62) también debe especificar el parámetro LUNAME.
Este parámetro sólo es válido en z/OS.
PORT ( número-puerto )- Número de puerto para TCP. Esto sólo es válido si el protocolo de transmisión (TRPTYPE) es TCP.
Este parámetro sólo es válido en z/OS.
TRPTYPE- Tipo de transporte que se va a utilizar. Es opcional.
- TCP
- TCP. Este es el valor predeterminado si no se especifica TRPTYPE.
- LU62
- LU 6.2. SNA
Este parámetro sólo es válido en z/OS.
IGNESTADO- Especifica si el mandato falla si el escucha ya está en ejecución. Los valores posibles son:
- NO
- El mandato falla si el escucha ya está en ejecución. Éste es el valor predeterminado.
- SÍ
- El mandato se ejecuta correctamente independientemente del estado actual del escucha.
