ALTER PROCESS (modificar una definición de proceso existente)

Utilice el mandato MQSC ALTER PROCESS para modificar los parámetros de una definición de proceso IBM® MQ existente.

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.

[z/OS] 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®.

Sinónimo: ALT PRO

ALTER PROCESS

Notas:

¹ Sólo es válido en z/OS cuando el gestor de colas es miembro de un grupo de compartición de colas.
² Sólo es válido en z/OS.

Descripciones de parámetros para ALTER PROCESS

nombre-proceso

Nombre de la definición de proceso de IBM MQ (consulte Reglas para la denominación de objetos de IBM MQ ). Se necesita nombre-proceso .

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

APPLICID(cadena )

El nombre de la aplicación que se va a iniciar. Normalmente, el nombre puede ser un nombre de archivo completo de un objeto ejecutable. La calificación del nombre de archivo es especialmente importante si tiene varias instalaciones de IBM MQ , para asegurarse de que se ejecuta la versión correcta de la aplicación. La longitud máxima es de 256 caracteres.

Para una aplicación CICS® , el nombre es un ID de transacción CICS , y para una aplicación IMS es un ID de transacción IMS .

[z/OS] En z/OS, para colas distribuidas, debe ser "CSQX start".

APPLTYPE(cadena )

El tipo de aplicación que se ha de iniciar. Los tipos de aplicación válidos son:

integer: Un tipo de aplicación definido por el sistema en el rango de cero a 65 535 o un tipo de aplicación definido por el usuario en el rango de 65 536 a 999 999 999 999.

Para determinados valores del rango del sistema, se puede especificar un parámetro de la lista siguiente en lugar de un valor numérico:

CICS: Representa una transacción CICS .
IMS: Representa una transacción IMS .
MVS: Representa una aplicación z/OS (por lotes o TSO).
NOTESAGENT: Representa un agente de Lotus Notes .
OS400: Representa una aplicación IBM i .
UNIX: Representa una aplicación Linux® o AIX® .
WINDOWS: Representa una aplicación Windows .
WLM: Representa una aplicación del gestor de carga de trabajo de z/OS .
DEF: La especificación de DEF hace que el tipo de aplicación predeterminado para la plataforma en la que se interpreta el mandato se almacene en la definición de proceso. La instalación no puede cambiar este valor predeterminado. Si la plataforma da soporte a clientes, el valor predeterminado se interpreta como el tipo de aplicación predeterminado del servidor.

Utilice sólo tipos de aplicación (distintos de los tipos definidos por el usuario) que estén soportados en la plataforma en la que se ejecuta el mandato:

En z/OS : se admiten CICS, IMS, MVS, UNIX, WINDOWS, WLM, y DEF
En IBM i : se admiten OS400, CICS, y DEF
En AIX and Linux : se admiten UNIX, WINDOWS, CICS, y DEF
En Windows, UNIX, WINDOWS, CICS, y DEF son compatibles

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.
En un entorno de colas compartidas, puede proporcionar un nombre de gestor de colas diferente del que está utilizando para especificar el mandato. El servidor de mandatos debe estar 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 es el mismo que entrar el mandato en cada gestor de colas del grupo de compartición de colas.

DESCR(cadena )

Comentario en texto sin formato. Proporciona información descriptiva sobre el objeto cuando un operador emite el mandato DISPLAY PROCESS .

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: Utilice caracteres del identificador de juego de caracteres codificados (CCSID) para este gestor de colas. Es posible que otros caracteres se conviertan incorrectamente si la información se envía a otro gestor de colas.

ENVRDATA(cadena )

Serie de caracteres que contiene información de entorno perteneciente a la aplicación que se va a iniciar. La longitud máxima es de 128 caracteres.

El significado de ENVRDATA lo determina la aplicación de supervisor desencadenante. El supervisor desencadenante proporcionado por IBM MQ añade ENVRDATA a la lista de parámetros pasada a la aplicación iniciada. La lista de parámetros consta de la estructura MQTMC2 , seguida de un espacio en blanco, seguida de ENVRDATA con los espacios en blanco finales eliminados.

Nota:

En z/OS, ENVRDATA no es utilizado por las aplicaciones de supervisor desencadenante proporcionadas por IBM MQ.
En z/OS, si APPLTYPE es WLM, los valores por defecto para los campos ServiceName y ServiceStep de la cabecera de información de trabajo (MQWIH) pueden suministrarse en ENVRDATA. El formato debe ser:
```
SERVICENAME=servname,SERVICESTEP=stepname
```
donde:

SERVICENAME=

es los primeros 12 caracteres de ENVRDATA.

servname

es un nombre de servicio de 32 caracteres. Puede contener espacios en blanco intercalados o cualquier otro dato, y tener espacios en blanco finales. Se copia en MQWIH tal cual.

SERVICESTEP=

es los siguientes 13 caracteres de ENVRDATA.

stepname

es un nombre de paso de servicio de 1 a 8 caracteres. Se copia tal cual en MQWIH y se rellena a ocho caracteres con espacios en blanco.

Si el formato es incorrecto, los campos de MQWIH se establecen en espacios en blanco.
En AIX and Linux, ENVRDATA se puede establecer en el carácter ampersand para que la aplicación iniciada se ejecute en segundo plano.

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). Cualquier objeto que resida en el repositorio compartido, o cualquier objeto definido utilizando un mandato que tenga los parámetros QSGDISP(QMGR), no se verá afectado 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). En el conjunto de páginas del gestor de colas que ejecuta el mandato, este mandato sólo modifica una copia local del objeto. Si el mandato es satisfactorio, se genera el mandato siguiente. `DEFINE PROCESS(process-name) REPLACE QSGDISP(COPY)` El mandato 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.
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.

USERDATA(cadena )

Serie de caracteres que contiene información de usuario perteneciente a la aplicación definida en el APPLICID que se va a iniciar. La longitud máxima es de 128 caracteres.

El significado de USERDATA lo determina la aplicación de supervisor desencadenante. El supervisor desencadenante proporcionado por IBM MQ simplemente pasa USERDATA a la aplicación iniciada como parte de la lista de parámetros. La lista de parámetros consta de la estructura MQTMC2 (que contiene USERDATA), seguida de un espacio en blanco, seguida de ENVRDATA con los espacios en blanco finales eliminados.

Para los agentes de canal de mensajes IBM MQ , el formato de este campo es un nombre de canal de hasta 20 caracteres. Consulte Gestión de objetos para desencadenamiento para obtener información sobre lo que APPLICID debe proporcionar a los agentes de canal de mensajes.

[Windows] Para Microsoft Windows, la serie de caracteres no debe contener comillas dobles si la definición de proceso se va a pasar a runmqtrm.