Manual de consulta

DTW_TB_SETV


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

Finalidad

Asigna un valor a una columna y fila determinada de una tabla de Net.Data.

Formato

@DTW_TB_SETV(tabla, valor, fila, col)

Parámetros

Tabla 165. Parámetros de DTW_TB_SETV
Tipo de datos Parámetro Uso Descripción
tabla tabla INOUT La variable de tabla de la macro en la que se establecerá un valor de tabla.
serie valor IN Serie de caracteres que se asigna al valor de tabla de la fila y columna especificadas en fila y col.
entero fila IN El número de fila del valor que ha de establecerse.
entero col IN El número de columna del valor que ha de establecerse.

Códigos de retorno

Tabla 166. Códigos de retorno de DTW_TB_SETV
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

  1. Antes de llamar a DTW_TB_SETV(), 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.
  2. Para suprimir un valor de tabla, asigne el valor NULL.

Ejemplos

Ejemplo 1: Asigna un valor a la fila 3 columna 3

%DEFINE myTable = %TABLE
 
@DTW_TB_SETV(myTable, "value3.3", "3", "3")

Ejemplo 2: Suprimir el valor de tabla en la fila 4, columna 2. Esto se hace transmitiendo una variable en la llamada de función que no se ha definido. Por omisión, esta variable tendrá un valor NULL.

%DEFINE myTable = %TABLE
 
@DTW_TB_SETV(myTable, nullVar, "4", "2")


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