Partimos de una rutina que realiza un CURSOR a una tabla para recuperar todos los registros que cumplan una determinada condición.
Nuestra rutina devolverá la información recuperada al programa llamante a través de una tabla de 10 ocurrencias definida en la linkage.
Vamos con el ejemplo:
Imaginemos que la tabla a la que queremos acceder tiene estos datos:
Siendo CAMPO1 la clave.
En esta versión del uso de cursores mostraremos el uso de la sentencia ROWSET para recuperar los datos.
Trabajaremos con un cursor ROWSET POSITIONING. Este tipo de cursor nos permite recuperar uno o más registros en un solo FETCH.
Definimos un cursor del siguiente modo:
WORKING-STORAGE SECTION.
EXEC SQL
DECLARE CURSOR CUR_TABLA ROWSET POSITIONING FOR
SELECT CAMPO1,
CAMPO2,
CAMPO3,
CAMPO4,
CAMPO5
FROM TABLA1
WHERE CAMPO1 = :CLAVE-CAMPO1
ORDER BY CAMPO1
END-EXEC
01 TBL-FETCH.
05 TBL-CAMPO1 PIC XX OCCURS 100 TIMES.
05 TBL-CAMPO2 PIC XX OCCURS 100 TIMES.
05 TBL-CAMPO3 PIC XX OCCURS 100 TIMES.
05 TBL-CAMPO4 PIC XX OCCURS 100 TIMES.
05 TBL-CAMPO5 PIC XX OCCURS 100 TIMES.
01 HNUM-REGS PIC S9(9) COMP.
IMPORTANTE: La variable HNUM-REGS sera la variable HOST que indicará al FETCH cuantos registros queremos recuperar.
Esta variable tiene que ser binaria (tipo COMP) y además debe estar definida en el nivel de working 01.
En la linkage recibiremos la información de los campos clave.
LINKAGE SECTION.
01 ENTRADA.
05 NUM-REGISTROS PIC 9(4).
05 ENT-CAMPO1 PIC XX.
01 SALIDA.
05 SAL-DATOS OCCURS 10 TIMES.
10 SAL-CAMPO1 PIC XX.
10 SAL-CAMPO2 PIC XX.
10 SAL-CAMPO3 PIC XX.
10 SAL-CAMPO4 PIC XX.
10 SAL-CAMPO5 PIC XX.
En el inicio del programa informamos las variables de acceso al WHERE y realizaremos el OPEN del cursor:
INICIO
IF ENT-CAMPO1 EQUAL SPACES OR LOW-VALUES
DISPLAY 'LA CLAVE ESTA VACIA'
PERFORM 90000-FINAL
END-IF
MOVE ENT-CAMPO1 TO CLAVE-CAMPO1
Si no informa la variable número de registros la informamos con el número máximo de ocurrencias, en este caso 10.
IF NUM-REGISTROS EQUAL ZEROS OR LOW-VALUES
MOVE 10 TO HNUM-REGS
ELSE
MOVE NUM-REGISTROS TO HNUM-REGS
END-IF
EXEC SQL
OPEN CUR_TABLA
END-EXEC
Controlaremos el SQLCODE. Si no fuese cero, tendríamos que dar un error.
IF SQLCODE NOT EQUAL ZEROES
DISPLAY 'ERROR EN EL OPEN CURSOR. EL SQLCODE ES: 'SQLCODE
PERFORM 90000-FINAL
END-IF
En el proceso realizamos un FECTH para recuperar todos los registros marcados por la variable de entrada NUM-REGISTROS(HNUM-REGS) en una tabla interna(TBL-FETCH).
A continuación volcamos la información de nuestra tabla interna en la tabla de salida:
PROCESO
EXEC SQL
FETCH NEXT ROWSET CUR_TABLA FOR :HNUM-REGS ROWS
INTO :TBL-CAMPO1,
:TBL-CAMPO2,
:TBL-CAMPO3,
:TBL-CAMPO4,
:TBL-CAMPO5
END-EXEC
Controlamos el SQLCODE devuelto:
EVALUATE TRUE
WHEN SQLCODE EQUAL ZEROES
DISPLAY 'TODO EN ORDEN'
WHEN SQLCODE EQUAL +100 AND SQLERRD(3) > 0
DISPLAY 'TODO EN ORDEN'
WHEN SQLCODE EQUAL +100 AND SQLERRD(3) = 0
DISPLAY 'NO ENCUENTRO NADA'
PERFORM 90000-FINAL
WHEN OTHER
DISPLAY 'ALGO VA MAL. EL SQLCODE ES: 'SQLCODE
PERFORM 90000-FINAL
END-EVALUATE
La variable de SQL SQLERRD(3) nos informa de cuantos registros se han recuperado en el FETCH (pudiese darse el caso de que nosotros quisiésemos recuperar 30 registros pero en la tabla sólo hubiese 10, el resultado del FETCH sería un SQLCODE=100 pero SQLERRD(3) > 0).
En nuestro caso el número de registros recuperados sería 6.
PERFORM UNTIL IND-REGISTROS GREATER SQLERRD(3)
PERFORM GUARDAR-EN-SAL-DATOS
END-PERFORM
Al terminar, cerraremos el cursor:
EXEC SQL
CLOSE CUR_TABLA
END-EXEC
Controlamos el SQLCODE. Si es distinto de cero daremos un error.
IF SQLCODE NOT EQUAL ZEROES
DISPLAY 'ERROR CERRANDO CURSOR. EL SQLCODE ES: 'SQLCODE
END-IF
Según la tabla de nuestro ejemplo, habríamos guardado en SAL-DATOS todos los registros.
Para finalizar devolvemos el control al programa llamante.
FINAL
GOBACK.
La sentencia ROWSET de DB2 se puede usar con otras instrucciones SQL. Se puede usar con el INSERT / UPDATE / DELETE.
Si alguien está interesado en conocer más sobre el tema, que pregunte sin compromiso : )
Os dejo el programa de ejemplo para descargar.
9 comentarios:
El programa para descargar no es el explicado en el artículo sino un llamado PRLISTA.
Culpa mía. Link actualizado : )
Que tal amigo,,,
Pregunta si en mi caso el número de registros recuperados sería de 30 y mi tabla es de 10, como le haria para recuperar de 10 en 10
Hola Anónimo.
Por un lado, la tabla que te pone el límite de registros a guardar es la tabla de la linkage, que es la que va a devolver la información al programa principal.
Por eso en nuestro ejemplo HNUM-REGS vale 10.
Para recuperar todos los registros de una tabla (ya sean 30 o más) con un ROWSET que recupera de 10 en 10, tendríamos que llamar a la rutina que hace el ROWSET varias veces, es decir:
PERFORM LLAMAR-RUTINA-ROWSET
UNTIL SQLCODE = +100 AND SQLERRD(3) = 0
Reposicionando por la clave del WHERE.
Si tu ROWSET está en un programa principal, lo que estará dentro del bucle será el FETCH y el tratamiento posterior.
gracias por los ejemplos, me he apoyado mucho
Hola, alguien sabe como definir un VARCHAR? necesito que me traiga la longitud de un campo con varchar para procesar la longitud de el archivo de salida pero al vaciar el fetch omite estos 4 campos y el programa me da como longitud parte del dato.
Saludos.
Hola, alguien sabe como definir un VARCHAR? necesito que me traiga la longitud de un campo con varchar para procesar la longitud de el archivo de salida pero al vaciar el fetch omite estos 4 campos y el programa me da como longitud parte del dato.
Saludos.
Hola creo que al bucle le falta ir incrementando la variable WI-NUM-ITEM de uno en uno para copiar las filas recuperadas por el fetch a la tabla de la linkage.
PERFORM UNTIL WI-NUM-ITEM > SQLERRD(3)
*
PERFORM 20300-MOVER-A-SAL-TABLA
*
END-PERFORM
Debería ser:
MOVE 0 TO WI-NUM-ITEM
PERFORM UNTIL WI-NUM-ITEM > SQLERRD(3)
*
PERFORM 20300-MOVER-A-SAL-TABLA
ADD 1 TO WI-NUM-ITEM.
*
END-PERFORM
Sí, pero habría que empezar en 1, no en cero.