Incompatibilidades de release SQL y aplicaciones

Acciones a tomar

En Db2 12, antes de establecer el parámetro de subsistema SUBSTR_COMPATIBILITY en CURRENT, identifique las aplicaciones que son incompatibles con este cambio iniciando un rastreo para IFCID 0376 y, a continuación, ejecutando las aplicaciones. Revise la salida de rastreo para los cambios incompatibles con el identificador 14. Corrija las aplicaciones afectadas para que sean compatibles si el parámetro de subsistema SUBSTR_COMPATIBILITY se establece en CURRENT en el futuro.

Acciones a tomar

Acciones a tomar

Identifique y modifique cualquier sentencia SQL existente que contenga más de 16.000 marcadores de parámetro o variables de host.

Acciones a tomar

Cambie la salida esperada para las consultas que hacen referencia a esta columna.

Acciones a tomar

Cambie la salida esperada para las consultas que hacen referencia a esta columna.

Acciones a tomar

Modifique las aplicaciones que utilizan la columna DSVOLSER en la tabla de catálogo SYSCOPY para tolerar la información de punto de comprobación para copias de imagen completas catalogadas y secuenciales. Para obtener detalles, consulte la descripción de DSVOLSER en la Tabla de catálogo SYSCOPY.

Acciones a tomar

Al prepararse para la migración a Db2 12 en Db2 11, puede reducir el cambio y el riesgo de los paquetes que están sujetos a enlaces automáticos en Db2 12. Para ello, vuelva a vincular todos los paquetes que se vincularon por última vez antes de DB2 10 en Db2 11, antes de migrar a Db2 12. Para obtener más información sobre los impactos que las reasignaciones automáticas relacionadas con la migración pueden tener en su entorno de Db2 y las acciones que puede realizar para evitarlas, consulte Reasignar planes y paquetes antiguos en Db2 11 para evitar reasignaciones automáticas perjudiciales en Db2 12.

Acciones a tomar

Para índices en espacios de tabla universales, utilice una REORG en línea para materializar el nuevo valor para el atributo COMPRESS en la sentencia ALTER INDEX.

Explicación

Antes de DB2 10, si un cliente Java llamaba a un procedimiento almacenado de Db2 for z/OS® , los tipos de datos de los argumentos de salida coincidían con los tipos de datos de los argumentos de la instrucción CALL correspondiente. A partir de la versión DB2 10, los tipos de datos de los argumentos de salida coinciden con los tipos de datos de los parámetros en la definición del procedimiento almacenado.

En Db2 12, cuando la compatibilidad de aplicaciones se establece en V10R1, puede establecer el parámetro de subsistema DDF_COMPATIBILITY en SP_PARMS_JV para mantener el comportamiento que existía antes de DB2 10. Sin embargo, cuando la compatibilidad de la aplicación se establece en V11R1 o V12R1M100, o en V12R1M500 o superior, SP_PARMS_JV ya no es compatible.

Acciones a tomar

Efectúe una de las acciones siguientes:

• Actualice el IBM Data Server Driver for JDBC and SQLJ a la versión 3.63 o 4.13, o posterior.
• Modifique los tipos de datos en las llamadas de método CallableStatement.registerOutParameter para que coincidan con los tipos de datos de parámetros en las definiciones de procedimiento almacenado. Puede establecer la compatibilidad de aplicaciones en V10R1 y ejecutar un rastreo para el IFCID 0376 para identificar las aplicaciones afectadas. Los registros de rastreo para esas aplicaciones tienen un valor de campo QW0376FN de 8.

Acciones a tomar

Identifique los paquetes que utilicen UNION o UNION ALL en la cláusula from de una sentencia SELECT INTO y corríjalos según sea necesario. Puede especificar temporalmente que Db2 continúe tolerando la sintaxis no válida NO para el parámetro de subsistema DISALLOW_SEL_INTO_UNION. Sin embargo, este parámetro de subsistema está en desuso y se espera que se elimine en el futuro.

Puede identificar los paquetes afectados mientras DISALLOW_SEL_INTO_UNION está establecido en NO mediante el enlace de paquetes sospechosos en un ID de colección ficticia con EXPLAIN (ONLY) y supervisando los registros de IFCID 0376. Los registros de rastreo para las aplicaciones afectadas tienen un valor de campo QW0376FN de 11.

Utilice el procedimiento siguiente:

1. Emita la siguiente sentencia SQL para generar una lista de mandatos BIND.

   SELECT 'BIND PACKAGE(DUMMYCOL) COPY(' ||
          COLLID || '.' || NAME || ') ' ||
          CASE WHEN(VERSION <> '')
               THEN 'COPYVER(' || VERSION || ') '
               ELSE '' END ||
          'EXPLAIN(ONLY)'
   FROM SYSIBM.SYSPACKSTMT
    WHERE STATEMENT LIKE '%SELECT%INTO%UNION%'
    OR STATEMENT LIKE '%SELECT%UNION%INTO%';

   

   La sentencia genera una salida similar al submandato BIND siguiente:

   BIND PACKAGE(DUMMYCOL) COPY(DSN_DEFAULT_COLLID_PLAY01.PLAY01) EXPLAIN(ONLY)

2. Copie los resultados de la sentencia SELECT en un trabajo de enlace. Si los submandatos BIND tienen más de 72 bytes, es necesario dar formato.
3. Inicie y recopile un rastreo para el IFCID 0376.
4. Ejecute el trabajo de enlace que ha creado.
5. Detenga el rastreo de IFCID 0376 y analice la salida.

Acciones a tomar

En Db2 12, antes de activar el nivel de función 500 o superior, identifique las aplicaciones con esta incompatibilidad iniciando un seguimiento para IFCID 0376 y, a continuación, ejecutando las aplicaciones. Revise la salida de rastreo para los cambios incompatibles con el identificador 1201. Ajuste el proceso de errores para tener en cuenta el cambio en el SQLCODE devuelto de error a aviso.

Acciones a tomar

Revise el valor del parámetro de subsistema BIF_COMPATIBILITY. Si el valor no es CURRENT y tiene aplicaciones que requieren una salida de serie decimal en el formato anterior aDB2 10, puede reescribir sentencias de SQL para utilizar las funciones CHAR9 y VARCHAR9 en su lugar. Este enfoque permite el desarrollo de nuevas aplicaciones que pueden aceptar el formato de serie actual de datos decimales.

Para modificar las aplicaciones para aprovechar las funciones CHAR9, VARCHAR9:

1. Utilice un rastreo IFCID 0376 para identificar aplicaciones que dependen de los formatos anteriores a DB2 10.
2. Vuelva a escribir las sentencias SQL en las aplicaciones identificadas para utilizar las funciones CHAR9 y VARCHAR9 en lugar de las funciones CHAR y VARCHAR.
3. Establezca el valor de BIF_COMPATIBILITY en CURRENT.

Acciones a tomar

Para modificar las aplicaciones para manejar el DB2 10 y el comportamiento posterior para CHAR, VARCHAR y CAST:

1. Identifique las aplicaciones que deben modificarse para manejar este cambio. Ejecute un rastreo para el IFCID 0376 para identificar las aplicaciones afectadas.
2. Asegúrese de que el parámetro de subsistema BIF_COMPATIBILITY está establecido en V9_DECIMAL_VARCHAR.

   Para manejar el cambio sólo para la función CHAR, puede establecer BIF_COMPATIBILITY en V9 y completar los pasos siguientes para la función CHAR.

3. Cambie las aplicaciones afectadas para manejar el DB2 10 y el comportamiento posterior de CHAR y VARCHAR, incluidos los procedimientos almacenados, las funciones definidas por el usuario no incorporadas y los paquetes desencadenantes. Vuelva a escribir las especificaciones CAST afectadas con la función CHAR o VARCHAR adecuada y una CAST en la longitud correcta, si es necesario.
4. Vuelva a enlazar y prepare los paquetes con la opción de reenlace PATH(SYSCURRENT, SYSIBM). La colocación del esquema SYSCURRENT al principio de la vía de acceso de SQL hace que se utilice el DB2 10 y el comportamiento posterior para las funciones incorporadas CHAR y VARCHAR.

   Repita este paso para los procedimientos almacenados nativos (SQLPL) y las funciones escalares de SQL no en línea.

5. Para las vistas que hacen referencia a estas conversiones o funciones incorporadas, determine si es necesario cambiar la vista para que tenga la salida esperada. Descarte y vuelva a crear las vistas con la opción de reenlace PATH(SYSCURRENT, SYSIBM), sólo si es necesario. Vuelva a enlazar cualquier aplicación que haga referencia a las vistas con la opción PATH(SYSCURRENT, SYSIBM) para utilizar DB2 10 y las funciones incorporadas posteriores CHAR y VARCHAR. Repita este paso para las funciones escalares de SQL en línea.
6. Para tablas de consulta materializadas o índices en expresiones que hacen referencia a estas conversiones o funciones incorporadas, descarte y vuelva a crear las tablas de consulta materializada o los índices en expresiones con la opción de reenlace PATH(SYSCURRENT, SYSIBM). Emita la sentencia REFRESH TABLE para las tablas de consulta materializada. Vuelva a enlazar las aplicaciones que hagan referencia a las tablas de consulta materializada o los índices en expresiones con la opción PATH(SYSCURRENT, SYSIBM) para utilizar DB2 10 y las funciones incorporadas posteriores CHAR y VARCHAR.
7. Cambie el valor del parámetro de subsistema BIF_COMPATIBILITY a CURRENT. Cuando el valor del parámetro de subsistema es CURRENT, las nuevas aplicaciones, los reenlaces y las sentencias CREATE utilizan DB2 10 y el comportamiento posterior CHAR, VARCHAR y CAST.

Las tablas de consulta materializada y los índices basados en expresiones utilizan el comportamiento de CHAR, VARCHAR y CAST que se especifica durante su creación. Si una sentencia de referencia tiene un comportamiento diferente especificado por el parámetro BIF_COMPATIBILITY o una ruta diferente, no se utiliza la tabla de consulta materializada o el índice basado en expresiones.

Acciones a tomar

Comprueba si los datos mixtos EBCDIC especificados para el argumento de expresión de cadena de una función incorporada RTRIM, TRIM, LTRIM o STRIP son válidos y resuelve los datos no válidos.

En datos mixtos válidos, las partes de doble byte de las series de entrada empiezan por X'0E' (carácter de desplazamiento desde teclado estándar), finalizan con X'0F' (carácter de desplazamiento a teclado estándar) y tienen un número par de bytes entre los caracteres X'0E' y X'0F'. Los datos que no cumplen estos criterios son datos mixtos no válidos. Cuando se especifican datos mixtos no válidos para el argumento expresión-serie de una función incorporada RTRIM, TRIM, LTRIM o STRIP, se devuelve SQLCODE -171 en algunos casos. Si Db2 recorta los caracteres especificados antes de que llegue a una parte no válida de una cadena mixta, la operación de recorte se realiza correctamente.

Establecer una compatibilidad de aplicación de V12R1M100 o inferior (si se aplica PTF para APAR PH25783 ) podría evitar el error mientras resuelve los datos no válidos. En los niveles inferiores de compatibilidad de la aplicación, Db2 12 intenta tolerar los datos mixtos no válidos identificados por la nueva comprobación de validación, y permite que la operación de recorte se complete si es posible. Sin embargo, si Db2 sigue sin poder realizar la operación de recorte, se emite SQLCODE -171.

Acciones a tomar

Si una aplicación contiene sentencias SQL que invocan funciones escalares externas definidas por el usuario, y una de esas sentencias SQL es rechazada con SQLCODE -904 y código de razón 00E70082, aumente el valor del parámetro del subsistema MAX_UDF o cambie la aplicación para que ejecute menos funciones simultáneamente en un hilo de ejecución ( Db2 ).

Acciones a tomar

Compruebe si sus aplicaciones utilizan las siguientes palabras reservadas de SQL:

• FL 504 SERVIDOR_ACTUAL
• FL 504 ZONA_HORARIA_ACTUAL
• LIMIT
• OFFSET

Ajuste las aplicaciones que utilicen estas palabras cambiando la palabra reservada por un identificador delimitado o utilizando una palabra que no esté reservada en Db2 12. Para ver la lista completa, consulte Palabras reservadas en Db2 for z/OS.

Acciones a tomar

Para continuar ejecutando una función definida por el usuario con el mismo nombre o firma que una nueva función o firma incorporada, califique el nombre de la función definida por el usuario existente en la aplicación. Para obtener más información sobre cómo Db2 resuelve referencias calificadas y no calificadas a funciones, consulte Resolución de funciones.