get relative

La sentencia EGL get relative lee una fila especificada numéricamente en un conjunto de resultados de base de datos relacional. La fila se identifica en relación con la posición del cursor en el conjunto de resultados.

Solo puede utilizar esta sentencia si especificó la opción scroll en la sentencia open relacionada. La opción scroll solo está disponible si está generando salida en Java.


Diagrama de sintaxis para la sentencia get relative
posición
Literal o elemento entero.

Si el valor de posición es positivo, la posición es un incremento de la posición numérica actual en el conjunto de resultados. Si se especifica get relative 2 cuando el cursor está en la primera fila, por ejemplo, se recupera la tercera fila y especificar get relative 1 es equivalente a especificar get next.

Si el valor de posición es negativo, la posición es un decremento de la posición numérica actual en el conjunto de resultados. Si se especifica get relative -2 cuando el cursor está en la tercera fila, por ejemplo, se recupera la primera fila y especificar get relative -1 es equivalente a especificar get previous.

Un valor cero para posición recupera la fila en la posición del cursor que ya es efectiva y equivalente a especificar get current.

nombre de registro
Nombre de un registro SQL.
from IDconjuntoResultados
Un ID que conecta la sentencia get relative con una sentencia open ejecutada anteriormente en el mismo programa. Para obtener detalles, consulte el apartado resultSetID.
into
Inicia una cláusula EGL into, que lista los elementos que recibe valores de una tabla de base de datos relacional.
elemento
Un elemento que recibe el valor de una columna determinada. No especifique un signo de dos puntos (:) ante el nombre del elemento.
Si emite una sentencia get relative para recuperar una fila seleccionada mediante una sentencia open que tiene la opción forUpdate, puede realizar cualquiera de estas acciones:

Una sentencia SQL FETCH representa la sentencia EGL get relative en el código generado. El formato de la sentencia SQL generada no puede cambiarse, excepto para establecer la cláusula INTO.

Si emite una sentencia get relative que intente acceder a una fila que no esté en el conjunto de resultados, el tiempo de ejecución EGL actúa de la forma siguiente:

Por lo general, si se produce un error y el proceso continúa, el cursor permanece abierto, con la posición del cursor inalterada.

Finalmente, al especificar SQL COMMIT o sysLib.commit, el código conserva la posición en el cursor declarado en la sentencia open, pero sólo en caso de que utilice la opción hold en la sentencia open.

Conceptos relacionados
resultSetID
Soporte de SQL

Tareas relacionadas
Diagrama de sintaxis

Consulta relacionada
delete
Manejo de excepciones
execute
get
get absolute
get current
get first
get last
get next
get previous
Sentencias EGL
open
replace

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.