Manual de consulta

DTW_TB_APPENDROW


AIX HP-UX Linux OS/2 OS/390 OS/400 PTX SUN Win NT
X X
X X X X X X

Finalidad

Añade una o más filas al final de una tabla de Net.Data.

Formato

@DTW_TB_APPENDROW(tabla, filas)

Parámetros

Tabla 123. Parámetros de DTW_TB_APPENDROW
Tipo de datos Parámetro Uso Descripción
tabla tabla INOUT La variable de tabla de la macro a la que se agregan filas.
entero filas IN El número de filas a agregar a tabla.

Códigos de retorno

Tabla 124. Códigos de retorno de DTW_TB_APPENDROW
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.
1010 Se han grabado datos en la tabla hasta que se ha llenado y se han desechado los datos restantes.

Notas de utilización

  1. El número de columnas de la tabla debe definirse antes de llamar a DTW_TB_APPENDROW(). 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.
  2. Puede asignar valores a las filas nuevas con la función DTW_TB_SETV() una vez se agreguen filas a la tabla o transmitir la tabla a un entorno de lenguaje para el proceso.
  3. Si hay un límite en el número total de filas que se admite en la tabla y el número de filas a agregar puede ocasionar que se supere el límite, se devuelve un error a quién emite la llamada.

Ejemplos

Ejemplo 1: Agrega diez filas a la tabla

%DEFINE myTable = %TABLE
 
@DTW_TB_APPENDROW(myTable, "10")
 


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]