FPUTENV: Como Atribuir um Valor para uma Variável de Ambiente

Como:

Sistemas Operacionais Disponíveis: IBM i (chamado anteriormente de i5/OS), Tandem, UNIX, Windows

Linguagens Disponíveis: Reporting

A função FPUTENV atribui uma string de caracteres a uma variável de ambiente. Utilize FPUTENV para definir valores que são utilizados em algum outro lugar do sistema.

Limite: Não é possível utilizar FPUTENV para definir ou alterar o FOCPRINT, FOCPATH ou USERPATH. Após iniciadas, estas variáveis são armazenadas na memória e não são lidas novamente pelo ambiente.
Topo da página
x
Sintaxe: Como Atribuir um valor para uma variável de ambiente
FPUTENV (varname_length,'varname',value_length, 'value', output)

onde:

varname_length

Inteiro

É o número máximo de caracteres no nome da variável de ambiente.

varname

Alfanumérico

É o nome da variável de ambiente entre aspas simples. O nome deve ser justificado à direita e preenchido com espaços em branco até ao comprimento máximo especificado por varname_length.

value_length

É o comprimento máximo do valor da variável de ambiente.

Observação: A soma de varname_length e value_length não pode exceder 64.

valor

Alfanumérico

É o valor que você deseja atribuir à variável de ambiente. A string deve estar justificada à direita e não pode conter espaços em branco integrados. Strings que contêm espaços em branco integrados serão truncadas no primeiro espaço em branco.

saída

Inteiro

É o código de retorno. Pode ser o nome do campo que contém o resultado ou o formato do valor de saída posto entre aspas simples. Se a variável for definida com sucesso, o código de retorno será 0. Qualquer outro valor indica a presença de uma falha.
Exemplo: Como Atribuir um Valor para uma Variável de Ambiente

FPUTENV atribui o valor FOCUS/Shell à variável PS1 e o armazena em um campo com o formato A12: 

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

A solicitação exibe o seguinte aviso quando o usuário emite o comando shell SH do UNIX:

FOCUS/Shell:
Information Builders