Renovación de un entorno de aplicación de WLM para procedimientos almacenados

Al realizar determinados cambios en un procedimiento almacenado o en el procedimiento de inicio JCL para un entorno de aplicación de WLM, es necesario renovar este último.

Antes de empezar

Antes de actualizar un entorno de aplicación WLM, asegúrese de que WLM esté funcionando en modo objetivo.

Acerca de esta tarea

Al actualizar el entorno WLM, se inicia una nueva instancia de cada espacio de direcciones que esté activo para el entorno WLM. Los espacios de direcciones existentes se detienen cuando se completan las solicitudes actuales que se están ejecutando en esos espacios de direcciones.

Actualice el entorno de la aplicación WLM si se da alguna de las siguientes situaciones:

Para los procedimientos externos (incluidos los procedimientos SQL externos), ha cambiado la lógica del procedimiento almacenado, el módulo de carga o la definición CREATE PROCEDURE.
Para un procedimiento almacenado de Java™, ha cambiado las propiedades a las que apunta el conjunto de datos JAVAENV.
Ha cambiado el procedimiento de inicio de JCL para el entorno de aplicación WLM.
Restricción : En algunos casos, actualizar el entorno WLM podría no ser suficiente para incorporar su cambio. Por ejemplo, supongamos que ha cambiado el valor NUMTCB en el JCL. La actualización falla porque WLM no puede iniciar un nuevo espacio de direcciones WLM que tenga un valor NUMTCB diferente al existente. En este caso, debe detener el entorno WLM mientras cambia el procedimiento de inicio JCL y reanudar el entorno cuando haya completado los cambios.

Si crea un procedimiento que utiliza un entorno WLM existente, no es necesario que actualice el entorno WLM.

Procedimiento

Para actualizar un entorno de aplicación WLM para procedimientos almacenados:

Realice una de las acciones siguientes:

Llama al procedimiento almacenado WLM_REFRESH.
Emitir el siguiente comando de z/OS® :
```
VARY WLM,APPLENV=environment-name,REFRESH
```
En este comando, nombre-entorno es el nombre de un entorno de aplicación WLM que está asociado con uno o más procedimientos almacenados. El entorno de la aplicación se actualiza para incorporar los módulos de carga modificados para todos los procedimientos almacenados y las funciones definidas por el usuario en el entorno concreto.

De forma alternativa, cuando realice ciertos cambios en el procedimiento de inicio de JCL, debe poner en reposo y luego reanudar el entorno de la aplicación WLM en lugar de actualizarlo. Para este tipo de cambios, utilice los siguientes z/OS comandos:

Para detener todos los espacios de direcciones de procedimientos almacenados que están asociados con el nombre del entorno de la aplicación WLM, utilice el siguiente z/OS :
```
VARY WLM,APPLENV=name,QUIESCE
```
Los espacios de direcciones se detienen cuando se completan las solicitudes actuales que se están ejecutando en esos espacios de direcciones.
Este comando pone el entorno de la aplicación WLM en estado QUIESCED. Cuando el entorno de aplicación WLM está en estado QUIESCED, las solicitudes de procedimientos almacenados se ponen en cola. Si el entorno de aplicación WLM se reinicia dentro de un tiempo determinado, se ejecutan los procedimientos almacenados. Si no se puede ejecutar un procedimiento almacenado, la instrucción CALL devuelve el código SQL -471 con el código de motivo 00E79002.
Para reiniciar todos los espacios de direcciones de procedimientos almacenados que están asociados con el nombre del entorno de la aplicación WLM, utilice el siguiente z/OS :
```
VARY WLM,APPLENV=name,RESUME
```
Los nuevos espacios de direcciones comienzan cuando se establecen todos los cambios de JCL. Hasta entonces, las solicitudes de trabajo que utilizan los nuevos espacios de direcciones se ponen en cola.

Además, puede utilizar el comando VARY WLM con la opción RESUME cuando el entorno de la aplicación WLM se encuentra en estado STOPPED debido a un fallo. Este estado puede ser el resultado de un fallo al iniciar el espacio de direcciones, o porque WLM detectó cinco terminaciones anormales en 10 minutos. Cuando un entorno de aplicación está en estado STOPPED, WLM no programa la ejecución de procedimientos almacenados en él. Si intenta llamar a un procedimiento almacenado cuando el entorno de la aplicación WLM está en estado STOPPED, la instrucción CALL devuelve el código SQL -471 con el código de razón 00E7900C. Después de corregir la condición que causó el error, debe reiniciar el entorno de la aplicación.