ALTER LISTENER (alterar un escucha existente) en Multiplatforms

Utilice el mandato MQSC ALTER LISTENER para modificar los parámetros de una definición de escucha de IBM® MQ existente. Si el escucha ya está en ejecución, los cambios que realice en su definición sólo entrarán en vigor después de la próxima vez que se inicie el escucha.

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.

Los parámetros no especificados en el mandato ALTER LISTENER dan como resultado que los valores existentes para esos parámetros se dejen sin modificar.

Diagrama de sintaxis
Descripciones de parámetros para ALTER LISTENER

Sinónimo: ALT LSTR

ALTERAR ESCUCHA

Notas:

¹ Sólo es válido en Windows.
² Sólo es válido en Windows cuando TRPTYPE es NETBIOS.
³ Es válido cuando TRPTYPE es TCP.
⁴ Válido en Windows cuando TRPTYPE es SPX.
⁵ Sólo es válido en Windows cuando TRPTYPE es LU62.

Descripciones de parámetros para ALTER LISTENER

(nombre-escucha)

Nombre de la definición de escucha de IBM MQ (consulte Reglas para la denominación de objetos de IBM MQ ). Es obligatorio.

El nombre no debe ser el mismo que ninguna otra definición de escucha definida actualmente en este gestor de colas (a menos que se especifique REPLACE ).

ADAPTER(número entero )

Número de adaptador en el que NetBIOS escucha. Este parámetro sólo es válido en Windows cuando TRPTYPE es NETBIOS.

BACKLOG(número entero )

Escriba el número máximo de solicitudes de conexión simultáneas que soporta el escucha.

COMMANDS(número entero )

Número de mandatos que el escucha puede utilizar. Este parámetro sólo es válido en Windows cuando TRPTYPE es NETBIOS.

CONTROL(cadena )

Especifica cómo se debe iniciar el escucha y cómo se debe detener stopped.:

MANUAL: El escucha no debe iniciarse automáticamente ni detenerse automáticamente. Debe controlarse mediante el uso de los mandatos START LISTENER y STOP LISTENER .
QMGR: El escucha que se está definiendo se debe iniciar y detener al mismo tiempo que se inicia y detiene el gestor de colas.
STARTONLY: El escucha debe iniciarse al mismo tiempo que se inicia el gestor de colas, pero no se le solicita que se detenga cuando se detiene el gestor de colas.

DESCR(cadena )

Comentario en texto sin formato. Proporciona información descriptiva sobre el escucha cuando un operador emite el mandato DISPLAY LISTENER (consulte DISPLAY LISTENER (visualizar información de escucha) en Multiplatforms ).

Sólo debe contener caracteres visualizables. La longitud máxima es de 64 caracteres. En una instalación DBCS, contiene caracteres DBCS (sujetos a una longitud máxima de 64 bytes).

Nota: Si se utilizan caracteres que no están en el identificador de juego de caracteres codificados (CCSID) para este gestor de colas, es posible que se conviertan incorrectamente si la información se envía a otro gestor de colas.

IPADDR(cadena )

Dirección IP para el escucha especificado en formato IPv4 decimal con puntos, IPv6 notación hexadecimal o nombre de host alfanumérico. Si no especifica un valor para este parámetro, el escucha escucha en todas las pilas IPv4 y IPv6 configuradas.

LIKE(nombre-del-oyente )

El nombre de un escucha, con parámetros que se utilizan para modelar esta definición.

Este parámetro sólo se aplica al mandato DEFINE LISTENER .

Si este campo no se rellena y no completa los campos de parámetro relacionados con el mandato, los valores se toman de la definición predeterminada para escuchas en este gestor de colas. Esto es equivalente a especificar:

LIKE(SYSTEM.DEFAULT.LISTENER)

Se proporciona un escucha predeterminado, pero se puede modificar mediante la instalación de los valores predeterminados necesarios. Consulte Reglas para la denominación de objetos IBM MQ.

LOCLNAME(cadena )

Nombre local de NETBIOS que el escucha utiliza. Este parámetro sólo es válido en Windows cuando TRPTYPE es NETBIOS.

NTBNAMES(número entero )

Número de nombres que puede utilizar el escucha. Este parámetro sólo es válido en Windows cuando TRPTYPE es NETBIOS.

PORT(número entero )

El número de puerto para TCP/IP. Esto sólo es válido cuando TRPTYPE es TCP. No debe exceder de 65535.

SESSIONS(número entero )

Número de sesiones que el escucha puede utilizar. Este parámetro sólo es válido en Windows cuando TRPTYPE es NETBIOS.

SOCKET(número entero )

Socket SPX en el que escuchar. Esto sólo es válido si TRPTYPE es SPX.

TPNAME(cadena )

Nombre de programa de transacción de LU 6.2 (longitud máxima de 64 caracteres). Este parámetro sólo es válido en Windows cuando TRPTYPE es LU62.

TRPTYPE( cadena )

El protocolo de transmisión que se utilizará:

LU62: LU 6.2. SNA Esto sólo es válido en Windows.
NETBIOS: NetBIOS. Esto sólo es válido en Windows.
SPX: Intercambio de paquetes secuenciado. Esto sólo es válido en Windows.
TCP: TCP/IP.