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 el valor de la variable de entorno especificada.
Formato
@DTW_GETENV(NombreVarEnt, ValorVarEnt)
@DTW_rGETENV(NombreVarEnt)
Parámetros
Tabla 36. Parámetros de DTW_GETENV
Tipo de datos | Parámetro | Uso | Descripción |
---|---|---|---|
serie | NombreVarEnt | IN | Variable o serie literal. |
serie | ValorVarEnt | OUT | El valor de la variable de entorno especificada en NombreVarEnt. Si no se encuentra el valor, se devuelve una cadena de caracteres vacía. |
Códigos de retorno
Tabla 37. Códigos de retorno de DTW_GETENV
Código de retorno | Explicación |
---|---|
-1001 | El servidor no ha podido procesar una petición de Net.Data para asignar memoria. |
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
También puede utilizar la sentencia ENVVAR para hacer referencia a los valores de las variables de entorno. Para obtener más información, consulte el apartado Sentencia ENVVAR.
Ejemplos
Ejemplo 1: Devuelve el valor para la sentencia PATH en el parámetro OUT
@DTW_GETENV(myEnvVarName, myEnvVarValue)
Ejemplo 2: Devuelve el valor para el protocolo del servidor
<p>The server is @DTW_rGETENV("SERVER_PROTOCOL").</p> Devuelve: El servidor es "HTTP/1.0".