-MODIFY DDF comando (Db2)

El comando MODIFY DDF modifica el estado y la configuración del servicio de datos distribuidos ( Db2 , DDF) y las estadísticas de las conexiones o subprocesos controlados por el DDF.

Autorización para -MODIFY DDF

Para ejecutar este comando, debe utilizar un conjunto de privilegios del proceso que incluya uno de los siguientes privilegios o autoridades:

autorización SYSOPR
Autorización SYSCTRL
Autorización SYSADM

Db2 los comandos que se emiten desde una consola de z/OS® o TSO SDSF con sesión iniciada pueden comprobarse mediante una autorización de Db2 utilizando ID de autorización principal y secundaria. Inicio del cambio Debe definirse un ID de usuario de z/OS conectado en RACF o un servidor de seguridad similar. fin del cambio

Sintaxis para -MODIFY DDF

Descripciones de opciones para -MODIFY DDF

CONTABILIDAD

Especifica si Db2 genera un registro de seguimiento de la cuenta para cada transacción utilizada por una aplicación cliente distribuida.

Para los hilos distribuidos existentes, la opción ACCTG especificada solo surte efecto después de que el hilo genere un registro de seguimiento de contabilidad en una confirmación o reversión sin recursos abiertos. Hasta entonces, la opción ACCTG previamente guardada para el hilo continúa controlando cuándo genera registros de seguimiento contable.

(sin valor de opción)

Especifica el comportamiento predeterminado.

Cuando esta opción se restablece a su configuración predeterminada, o si la configuración nunca se cambió, Db2 genera un registro de seguimiento contable cuando no existe ningún recurso abierto después de una confirmación o reversión. Si alguno de los siguientes recursos permanece abierto y pendiente, Db2 no genera un registro de seguimiento contable:

Abrir CON RETENCIÓN cursores
Tablas temporales globales declaradas que no se eliminan
Localizadores LOB no publicados
Una confirmación procesada por un procedimiento almacenado cuando se ejecuta con reglas de confirmación en dos fases
Paquetes RELEASE DEALLOCATE asignados (debido a la opción -MODIFY DDF PKGREL(BNDOPT))
Asignado KEEPDYNAMIC SÍ paquetes

Sin embargo, si sólo uno de los dos últimos tipos de recursos anteriores, pero no ambos, están abiertos después de un commit o rollback, Db2 genera una ocurrencia de registro de rastreo contable después de un commit o rollback.

TODOSCOMPROMETIDOS

Cuando se establece esta opción, Db2 genera un registro de seguimiento de la cuenta después de cualquier confirmación o reversión. Sin embargo, Db2 sigue manteniendo el enclave WLM que fue creado por Db2, antes de la transacción inicial solicitada que dejó recursos abiertos. Además, Db2 mantiene la información de modo que cuando el DBAT finaliza después de completar las solicitudes de trabajo de su conexión de cliente, elimina el enclave e informa a WLM de las transacciones que se completaron.

Para utilizar la opción ACCTG(ALLCOMMIT), también debe establecer el valor del parámetro del subsistema CMTSTAT en INACTIVE. De lo contrario, Db2 devuelve el siguiente mensaje para indicar que el comportamiento predeterminado todavía se está utilizando.

DSNL302I ACCTG IS SET TO COMMIT_WITH_NO_OPEN_RESOURCES

ALIAS

Especifica la creación, modificación o eliminación de un alias de ubicación específico. Puede utilizar el comando MODIFICAR DDF con la opción ALIAS para definir y gestionar hasta 40 alias de ubicación de forma dinámica. Puede iniciar, detener, cancelar, cambiar y eliminar alias de ubicación dinámica sin detener DDF ni Db2.

Inicio del cambio El comando MODIFY DDF no puede utilizarse para gestionar alias de ubicación estáticos. Para obtener más información, consulte Alias de ubicación específicos de los miembros. fin del cambio

nombre-alias

Especifica el nombre de un alias para una ubicación DDF. Un alias es una alternativa para el nombre de la ubicación que se puede utilizar para el procesamiento de la conexión.

Importante: Inicio del cambio

Para obtener los mejores resultados, no especifique un alias de ubicación específico de miembro con un nombre que coincida exactamente con el nombre de ubicación actual del subsistema Db2 . De lo contrario, es probable que detener o cancelar el alias provoque resultados impredecibles. fin del cambio

El alias debe cumplir todos los requisitos siguientes:

No contiene más de 16 caracteres.
Contiene solo letras (excluidos los caracteres alfabéticos extendidos), números o el carácter de subrayado.

ADD

Crea un alias con el nombre especificado.

DELETE

Elimina el alias especificado.

START

Db2 comienza a aceptar solicitudes de conexión al alias especificado si se inicia DDF. Si DDF no se inicia, el alias se marca como apto para iniciarse, y Db2 comienza automáticamente a aceptar solicitudes de conexión al alias cuando se inicia DDF.

Si el subsistema forma parte de un grupo de intercambio de datos, Db2 registra el alias en WLM y Db2 participa en el equilibrio de carga de trabajo de sysplex para las conexiones al alias.

STOP

Db2 deja de aceptar nuevas solicitudes de conexión al alias especificado. Los hilos de acceso a la base de datos existentes que procesan conexiones al alias no se ven afectados. Las conexiones inactivas relacionadas con el alias se cierran.

Un alias detenido se marca como no apto para iniciarse y no se inicia automáticamente cuando se inicia el DDF. Si el subsistema forma parte de un grupo de intercambio de datos, Db2 cancela el registro del alias en WLM y Db2 deja de participar en el equilibrio de carga de trabajo de sysplex para las conexiones al alias.

CANCELAR

Db2 deja de aceptar nuevas solicitudes de conexión al alias especificado. Se cancelan todos los hilos de acceso a la base de datos que procesan conexiones al alias y se cierran las conexiones inactivas relacionadas con el alias.

Un alias cancelado se marca como no apto para el inicio y no se inicia automáticamente cuando se inicia el DDF. Si el subsistema forma parte de un grupo de intercambio de datos, Db2 cancela el registro del alias en WLM y Db2 deja de participar en el equilibrio de carga de trabajo de sysplex para las conexiones al alias.

PUERTO (nombre del puerto )

Añade o reemplaza un puerto existente que puede ser utilizado por DDF para aceptar solicitudes distribuidas para el alias especificado. El valor especificado para el valor del nombre del puerto debe ser un número decimal en el rango de 1 a 65535, incluido 65535, y debe ser diferente de los valores de los puertos de otros alias. Especifique un valor de PUERTO para un alias cuando desee identificar un subconjunto de miembros que comparten datos al que puede dirigirse una solicitud distribuida.

SECPORT (nombre-secport )

Añade o reemplaza un puerto seguro existente que puede ser utilizado por DDF para aceptar solicitudes distribuidas de forma segura mediante el uso de SSL para el alias especificado. El valor especificado para secport-name debe ser un número decimal en el rango de 1 a 65535, incluido 65535, y debe ser diferente de los valores de los puertos de otros alias. Especifique un valor SECPORT para un alias cuando desee identificar un subconjunto de miembros que comparten datos al que puede dirigirse una solicitud distribuida de forma segura.

NPORT

Elimina el puerto de alias, si existe.

NSECPORT

Elimina el puerto seguro de alias, si existe.

IPV4 (dirección IPv4 )

IPv4 Añade o reemplaza una dirección de correo electrónico específica de un miembro para el método INADDR_ANY de acceso de grupo TCP/IP. Los clientes utilizan la dirección cuando utilizan una de las siguientes capacidades para una conexión a un alias de ubicación dinámica:

Equilibrado de cargas de trabajo de sysplex
Protocolos XA para coordinar transacciones distribuidas

Esta dirección debe especificarse en formato decimal con puntos.

Inicio del cambio No especifique IPV4(IPv4-address) si se utiliza el método BINDSPECIFIC para el acceso a grupos TCP/IP. fin del cambio

IPV6 (dirección IPv6 )

IPv6 Añade o reemplaza una dirección de correo electrónico específica de un miembro para el método INADDR_ANY de acceso de grupo TCP/IP. Los clientes utilizan la dirección cuando utilizan una de las siguientes capacidades para una conexión a un alias de ubicación dinámica:

Equilibrado de cargas de trabajo de sysplex
Protocolos XA para coordinar transacciones distribuidas

Esta dirección debe especificarse en formato hexadecimal con dos puntos.

Inicio del cambio No especifique IPV6(IPv6-address) si se utiliza el método BINDSPECIFIC para el acceso a grupos TCP/IP. fin del cambio

NIPV4

Elimina la dirección alias IPv4, si existe.

NIPV6

Elimina la dirección alias IPv6, si existe.

PKGREL

Especifica si Db2 respeta las opciones de enlace de paquetes que se utilizan para el procesamiento de clientes remotos. Db2 utiliza el comportamiento de la opción COMMIT antes de que se emita el primer comando MODIFY DDF con la opción PKGREL.

Si el parámetro del subsistema CMTSTAT está establecido en ACTIVE, el comando MODIFY DDF con la palabra clave PKGREL no tiene efecto, y Db2 siempre utiliza el comportamiento de la opción COMMIT.

BNDOPT: Las reglas de la opción de enlace de LIBERACIÓN que se especificaron cuando se enlazó el paquete se aplican a cualquier paquete que se utilice para el procesamiento remoto del cliente. El DBAT de alto rendimiento que utiliza una conexión de cliente final se desasigna.
BINDOPT es la opción predeterminada de PKGREL si el parámetro del subsistema CMTSTAT está establecido en INACTIVE.
BNDPOOL: Las reglas de la opción de enlace de LIBERACIÓN que se especificaron cuando se enlazó el paquete se aplican a cualquier paquete que se utilice para el procesamiento remoto del cliente. El DBAT de alto rendimiento que utiliza una conexión de cliente final se agrupa.
COMMIT: Las reglas de la opción RELEASE(COMMIT) bind se aplican a cualquier paquete que se utilice para el procesamiento remoto de clientes.
Si el parámetro del subsistema CMTSTAT está establecido en ACTIVE, Db2 siempre utiliza el comportamiento de esta opción.

SESSIDLE (session-idle-limit )

Especifica el número de minutos que las aplicaciones pueden permanecer inactivas antes de que el token de datos de sesión asociado deje de ser válido debido al tiempo de espera.

session-idle-limit puede ser cualquier número entero entre 0 y 999999. Cuando no se especificó ningún valor, el valor predeterminado es 1440.

Notas de uso para -MODIFY DDF

Cuándo utilizar opciones PKGREL y DBAT de alto rendimiento

Inicio del cambio Durante las horas normales de funcionamiento de producción, puede especificar que DDF utilice las opciones PKGREL(BNDOPT) o PKGREL(BNDPOOL) para especificar que Db2 utilice DBAT de alto rendimiento para dar servicio a las conexiones remotas. Un DBAT de alto rendimiento es un subproceso de acceso a la base de datos que permanece asociado a una conexión remota en los límites de la transacción, en lugar de estar agrupado. Con los DBAT de alto rendimiento, la cantidad de procesamiento de asignación y desasignación se reduce porque la copia del paquete permanece asignada hasta que finaliza el DBAT. Para obtener más información, consulte Activación de DBAT de alto rendimiento. fin del cambio

Para entornos en los que las configuraciones de cliente controlan el uso de paquetes vinculados con la opción RELEASE(DEALLOCATE), BNDOPT podría ser el valor preferido de la opción PKGREL. Para entornos en los que cualquier cliente puede utilizar paquetes vinculados con la opción RELEASE(DEALLOCATE), BNDPOOL podría ser el valor preferido de la opción PKGREL. Cualquiera de las dos opciones ofrece un mejor rendimiento al reducir los costes de la CPU para la asignación y desasignación de paquetes.

Sin embargo, es probable que los paquetes que se ejecutan bajo las reglas de la opción RELEASE(DEALLOCATE) bind permanezcan asignados e impidan actividades de mantenimiento como modificaciones de objetos y operaciones de enlace. Por lo tanto, puede especificar la opción PKGREL(COMMIT) durante los períodos de mantenimiento rutinario y de emergencia. Para obtener más información, consulte Control de la desasignación para DBAT de alto rendimiento.

Efectos retardados de PKGREL(COMMIT)

Cuando se emite el comando MODIFY DDF y se especifica la opción PKGREL(COMMIT), los efectos no son inmediatos. Después de que se emita el comando, cualquier hilo de acceso a la base de datos que estuviera ejecutando paquetes RELEASE(DEALLOCATE) se termina cuando la conexión se vuelve inactiva. En la siguiente unidad de trabajo del cliente, se crea un nuevo hilo de acceso a la base de datos en modo RELEASE(COMMIT). Cualquier DBAT que permanezca activo a la espera de una nueva solicitud de unidad de trabajo de su cliente debido a las reglas RELEASE(DEALLOCATE) es terminado por la tarea de servicio DDF que se ejecuta cada 2 minutos. Por lo tanto, en aproximadamente 2 minutos, todos los hilos de acceso a la base de datos se ejecutan bajo las reglas de la opción de enlace RELEASE(COMMIT).

Cambios en los atributos de alias

Los atributos de un alias existente solo pueden modificarse cuando el alias está desactivado. Los atributos de alias modificados surten efecto cuando se inicia el alias. De forma predeterminada, los alias creados por la utilidad DSNJU003 se inician y los alias creados por el comando MODIFY DDF se detienen. DSNJU004 no imprime ninguna información para los alias creados por el comando MODIFY DDF. Puede utilizar el resultado del comando DISPLAY DDF para encontrar el estado de los alias creados por el comando MODIFY DDF.

Db2 Cómo utiliza Tiffany & Co. los valores de IPV4 y IPV6

Db2 no activa las direcciones IP que especifique con los parámetros IPV4 o IPV6. Los clientes utilizan esas direcciones únicamente con fines de enrutamiento. Db2 no exige que las direcciones sean direcciones IP virtuales dinámicas (DVIPAs). Las direcciones IP se utilizan para acceder a la red DVIPA que presta servicio al grupo de intercambio de datos Db2 . Puede especificar las direcciones IP en el comando MODIFY DDF solo después de que se ejecute DSNJU003 con el parámetro IPV4 o IVP6 para especificar una dirección de ubicación específica del miembro. Las direcciones IP especificadas se devuelven en la lista de servidores ponderados de WLM cuando los clientes se conectan a un alias de ubicación dinámica, en función de las siguientes condiciones:

Si el cliente que se conecta utiliza una dirección IPv6, la lista de servidores contiene las direcciones IP de alias que se especificaron con los parámetros IPV4 y IPV6 del comando MODIFY DDF. Si no se especificó una dirección IPv4 en el comando MODIFY DDF, se devuelve en su lugar la dirección IP de ubicación que se especificó mediante la palabra clave IPV4 de la utilidad DSNJU003. Del mismo modo, si no se especifica una dirección IPv6 en el comando MODIFY DDF, se devuelve en su lugar la dirección IP de ubicación que se especificó mediante la palabra clave IPV6 de la utilidad DSNJU003.
Si el cliente que se conecta utiliza una dirección IPv4, la lista de servidores contiene la dirección IP del alias que se especificó con el parámetro IPV4 del comando MODIFY DDF. Si no se especificó una dirección IPv4 en el comando MODIFY DDF, se devuelve en su lugar la dirección IP de ubicación que se especificó mediante la palabra clave IPV4 de la utilidad DSNJU003.

Vinculación de un puerto de alias de ubicación a una dirección IP diferente para un subsistema independiente Db2

Un subsistema de Db2 que no sea miembro de un grupo de intercambio de datos de Db2 puede crear un único socket de escucha para un puerto de alias de ubicación solicitando que el socket esté vinculado a INADDR_ANY. Si una declaración PORT de " PROFILE.TCPIP " también especifica una dirección IP en el parámetro BIND para el puerto de alias, entonces TCP/IP vincula el socket de escucha a la dirección especificada.

En la mayoría de los casos, si el parámetro BIND de la declaración PORT especifica una dirección IP para el puerto de alias, debe especificar la misma dirección IP que Db2 muestra para TCPPORT o SECPORT en el mensaje DSNL084I en la salida del comando DISPLAY DDF.

Sin embargo, si el parámetro BIND de la declaración PORT para el puerto de alias especifica una dirección IP diferente a la que Db2 muestra para su TCPPORT o SECPORT principal, entonces TCP/IP vincula el socket de escucha de alias a la dirección IP que se especificó en el parámetro BIND de la declaración PORT. El resultado es que el puerto del alias solo se puede alcanzar dirigiéndose a esa dirección IP específica. Db2 no aprende ni muestra ninguna información sobre la dirección IP del puerto del alias.