AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X | X |
| X | X | X |
| X | X |
Finalidad
Asigna un nombre a una cabecera de columna en una tabla de Net.Data.
Formato
@DTW_TB_SETN(tabla, nombre, col)
Parámetros
Tabla 163. Parámetros de DTW_TB_SETN
Tipo de datos | Parámetro | Uso | Descripción |
---|---|---|---|
tabla | tabla | INOUT | La variable de tabla de la macro en la que se establecerá un nombre de columna. |
serie | nombre | IN | Serie de caracteres que se asigna a la cabecera de columna de la columna especificada en col. |
entero | col | IN | El número de columna de la columna cuya cabecera se va a definir. |
Códigos de retorno
Tabla 164. Códigos de retorno de DTW_TB_SETN
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
Ejemplos
Ejemplo 1: Asigna un nombre a las cabeceras de columna de la 1 a la 3
%DEFINE myTable = %TABLE @DTW_TB_SETCOLS(myTable, "3") @DTW_TB_SETN(myTable, "Name", "1") @DTW_TB_SETN(myTable, "Address", "2") @DTW_TB_SETN(myTable, "Phone", "3")
Ejemplo 2: Suprimir la cabecera de columna de la 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_SETN(myTable, nullVar, "2")