ALTER NAMELIST (alterar una lista de nombres)
Utilice el mandato MQSC ALTER NAMELIST para modificar una lista de nombres. Esta lista suele ser una lista de nombres de clúster o nombres de cola.
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 NAMELIST dan como resultado que los valores existentes para esos parámetros se dejen sin modificar.
![[z/OS]](ngzos.gif)
Puede emitir este mandato desde orígenes 2CR. 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®.
Notas de uso
La finalización satisfactoria del mandato no significa que la acción se haya completado. Para comprobar la finalización verdadera, consulte el paso ALTER NAMELIST en Comprobación de que los mandatos asíncronos para redes distribuidas han finalizado.
Descripciones de parámetros para ALTER NAMELIST
- (nombre)
- Nombre de la lista.
El nombre no debe ser el mismo que cualquier otro nombre de lista de nombres definido actualmente en este gestor de colas (a menos que se especifique REPLACE o ALTER ). Consulte Reglas para la denominación de objetos IBM MQ.
- 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.CMDSCOPE debe estar en blanco, o el gestor de colas local, si QSGDISP está configurado como GROUP.
- ' '
- El mandato se ejecuta en el gestor de colas en el que se ha especificado.
- 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 distinto del gestor de colas en que se haya entrado el mandato, solamente si está utilizando un entorno de colas compartidas y si el servidor de mandatos está habilitado.
- *
- El mandato se ejecuta en el gestor de colas local y también se pasa a cada gestor de colas activo del grupo de compartición de colas. El efecto de especificar * es el mismo que especificar el mandato en cada gestor de colas del grupo de compartición de colas.
- DESCR (serie)
- Comentario en texto sin formato. Proporciona información descriptiva sobre la lista de nombres cuando un operador emite el mandato DISPLAY
NAMELIST (consulte DISPLAY NAMELIST (visualizar una lista de nombres) ).
Debe contener sólo 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. - NAMES (nombre, ...)
- Lista de nombres.
Los nombres pueden ser de cualquier tipo, pero deben cumplir las reglas para denominar objetos IBM MQ , con una longitud máxima de 48 caracteres.
Una lista vacía es válida: especifique NAMES(). El número máximo de nombres en la lista es 256.
- NLTYPE de
- Indica el tipo de nombres en la lista de nombres.
Este parámetro sólo es válido en z/OS.
- Ninguna
- Los nombres no son de ningún tipo en particular.
- QUEUE o Q
- Una lista de nombres que contiene una lista de nombres de cola.
- CLÚSTER
- Una lista de nombres que está asociada a la agrupación en clúster, que contiene una lista de los nombres de clúster.
- AUTHINFO
- Esta lista de nombres está asociada con TLS y contiene una lista de nombres de objeto de información de autenticación.
Las listas de nombres utilizadas para la agrupación en clúster deben tener NLTYPE(CLUSTER) o NLTYPE(NONE).
Las listas de nombres utilizadas para TLS deben tener NLTYPE(AUTHINFO).
- QSGDISP
- Este
parámetro se aplica únicamente a z/OS.
Especifica la disposición del objeto al que está aplicando el mandato (es decir, dónde está definido y cómo se comporta).
Tabla 1. Comportamiento para cada uno de los valores de QSGDISP QSGDISP ALTER COPY La definición de objeto reside en el conjunto de páginas del gestor de colas que ejecuta el mandato. El objeto se ha definido utilizando un mandato que tenía los parámetros QSGDISP(COPY). Los objetos que residen en el repositorio compartido, o los objetos definidos utilizando un mandato con los parámetros QSGDISP(QMGR), no se ven afectados por este mandato. GROUP La definición de objeto reside en el repositorio compartido. El objeto se ha definido utilizando un mandato que tenía los parámetros QSGDISP(GROUP). Cualquier objeto que resida en el conjunto de páginas del gestor de colas que ejecuta el mandato (excepto una copia local del objeto) no resulta afectado por este mandato. Si el mandato es satisfactorio, se genera el mandato siguiente y se envía a todos los gestores de colas activos del grupo de compartición de colas para intentar renovar las copias locales en el conjunto de páginas cero:
El ALTER para el objeto de grupo entra en vigor independientemente de si el mandato generado con QSGDISP(COPY) falla.DEFINE NAMELIST(name) REPLACE QSGDISP(COPY)PRIVATE El objeto reside en el conjunto de páginas del gestor de colas que ejecuta el mandato y se ha definido con QSGDISP(QMGR) o QSGDISP(COPY). Cualquier objeto que resida en el repositorio compartido no resultará afectado. QMGR La definición de objeto reside en el conjunto de páginas del gestor de colas que ejecuta el mandato. El objeto se ha definido utilizando un mandato que tenía los parámetros QSGDISP(QMGR). Los objetos que residen en el repositorio compartido, o las copias locales de un objeto de ese tipo, no se ven afectados por este mandato.