AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X | X | X | X | X | X | X | X | X |
Finalidad
Devuelve una cabecera de columna a partir de una tabla de Net.Data.
Formato
@DTW_TB_GETN(tabla, col, nombre)
@DTW_TB_rGETN(tabla, col)
Parámetros
Tabla 137. Parámetros de DTW_TB_GETN
Tipo de datos | Parámetro | Uso | Descripción |
---|---|---|---|
tabla | tabla | IN | La variable de tabla de la macro desde la que se devuelve un nombre de columna. |
entero | col | IN | El número de columna de la columna cuyo nombre ha de devolverse. |
serie | nombre | OUT | Variable que contiene el nombre de la columna especificada en col. |
Códigos de retorno
Tabla 138. Códigos de retorno de DTW_TB_GETN
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. |
1006 | Se ha transmitido una serie literal en una llamada de función para un parámetro que debería haber sido un parámetro de salida. |
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_GETN(), 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: Recupera el nombre de columna de la columna 4
%DEFINE myTable = %TABLE %DEFINE name = "" ... @FillTable(myTable) ... @DTW_TB_GETN(myTable, "4", name)
Ejemplo 2: Recupera el nombre de columna de la última columna de la tabla
%DEFINE myTable = %TABLE ... @FillTable(myTable) ... <p>The column name of the last column is @DTW_TB_rGETN(myTable, @DTW_TB_rCOLS(myTable))</p>