AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X | X |
| X | X | X |
| X | X |
Finalidad
Inserta una o más filas en una tabla de Net.Data.
Formato
@DTW_TB_INSERTROW(tabla, fila_después, filas)
Parámetros
Tabla 151. Parámetros de DTW_TB_INSERTROW
Tipo de datos | Parámetro | Uso | Descripción |
---|---|---|---|
tabla | tabla | INOUT | La variable de tabla de la macro en la que van a insertarse las filas. |
entero | fila_después | IN | El número de fila a partir de la cual van a insertarse nuevas filas. Para insertar filas al principio de la tabla, especifique 0. |
entero | filas | IN | El número de filas a insertar en la tabla. |
Códigos de retorno
Tabla 152. Códigos de retorno de DTW_TB_INSERTROW
Código de retorno | Explicación |
---|---|
-1001 | El servidor no ha podido procesar una petición de Net.Data para asignar memoria. |
1001 | Un parámetro de entrada contenía un valor NULL. |
1003 | Se ha transmitido un número incorrecto de parámetros en una llamada de función. |
1004 | Se ha transmitido un parámetro en una llamada de función que debería haber sido una variable de tabla de macro Net.Data, pero era de un tipo de variable diferente. |
1005 | Se ha transmitido un parámetro en una llamada de función que debería haber sido una variable de serie, pero era de un tipo de variable diferente. |
1007 | Un parámetro contiene un valor que no es válido. |
1008 | Un parámetro está fuera de los límites de la tabla. |
Notas de utilización
Antes de llamar a DTW_TB_INSERTROW(), defina el número de columnas en la tabla. Puede establecer el número de columnas con las funciones DTW_TB_SETCOLS() o DTW_TB_INSERTCOL(), o transmitiendo la tabla a un entorno de lenguaje a establecer.
Ejemplos
Ejemplo 1: Inserta una fila detrás de la fila cinco de una tabla
%DEFINE myTable = %TABLE @DTW_TB_INSERTROW(myTable, "5", "1")
Ejemplo 2: Inserta tres filas al principio de una tabla
%DEFINE myTable = %TABLE @DTW_TB_INSERTROW(myTable, "0", "3")