Manual de consulta

DTW_SETENV


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

Finalidad

Asigna una variable de entorno con un valor específico y devuelve el valor anterior.

Formato

@DTW_SETENV(NombreVarEnt, ValorVarEnt, ValorAnt)

@DTW_rSETENV(NombreVarEnt, ValorVarEnt)

Parámetros

Tabla 54. Parámetros de DTW_SETENV
Tipo de datos Parámetro Uso Descripción
serie NombreVarEnt IN Variable o serie literal que representa la variable de entorno.
serie ValorVarEnt IN Variable o serie literal con el valor al que se asigna la variable de entorno.
serie ValorAnt OUT Variable que contiene el valor anterior de la variable de entorno.

Códigos de retorno

Tabla 55. Códigos de retorno de DTW_SETENV
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.
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.

Notas de utilización

Si no se encuentra un valor anterior para la variable de entorno, se devuelve una serie vacía.

Ejemplos

Ejemplo 1: Devuelve el valor para la vía de acceso anterior

@DTW_SETENV("PATH", "myPath", prevValue)

Ejemplo 2: Devuelve el valor para la vía de acceso anterior y asigna el valor para el valor de PATH

@DTW_rSETENV("PATH", "myPath")


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