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")