FPUTENV: Cómo asignar un valor a una variable de entorno

Cómo:

Sistemas operativos disponibles: IBM i (anteriormente conocido como i5/OS), Tandem, UNIX, Windows

Lenguajes disponibles: informes

La función FPUTENV asigna una cadena de caracteres a una variable de entorno. Use FPUTENV para establecer valores utilizados en otras partes del sistema.

Limitación: No se puede usar FPUTENV para establecer o cambiar FOCPRINT, FOCPATH ni USERPATH; una vez iniciadas, estas variables se retienen en la memoria y no se releen desde el entorno.


Principio de página

x
Sintaxis: Cómo Asignar un valor a una variable de entorno
FPUTENV (varname_length,'varname',value_length, 'value', output)

donde:

varname_length

Número entero

En el número máximo de caracteres en el nombre de la variable de entorno.

varname

Alfanumérico

Es el nombre de la variable de entorno entre comillas simples. El nombre debe estar justificado a la derecha y rellenarse con espacios en blanco, con una longitud máxima especificada por varname_length.

value_length

Es la longitud máxima del valor de la variable de entorno.

Nota: La suma de varname_length y value_length no puede exceder 64.

value

Alfanumérico

Es el valor que desea asignar a la variable de entorno. La cadena debe estar justificada a la derecha y no incluir espacios en blanco insertados. Las cadenas que contengan espacios en blanco quedarán truncadas por el primero.

output

Número entero

Es el código de retorno. Puede ser el nombre del campo que contiene el resultado, o el formato del valor de salida entre comillas simples. Si la variable se ha establecido correctamente, el código de devolución es 0. Cualquier otro valor indica que ha habido un error.



Ejemplo: Cómo asignar un valor a una variable de entorno

FPUTENV asigna el valor de FOCUS/Shell a la variable PS1 y lo almacena en un campo con el formato A12:

-SET &RC = FPUTENV(3,'PS1', 12 'FOCUS/Shell:', 'I4');

La solicitud muestra el siguiente aviso, cuando el usuario emite el comando shell SH de UNIX:

FOCUS/Shell:

WebFOCUS