SET_SYSVAR

Define o valor da variável de sistema associada ao endereço especificado; caso o endereço seja inválido ou não suporte escrita, atualiza o código de falha do ambiente. É uma função.

Biblioteca: HI_STD · Namespace: HILS · Tipo: função

Função

           SET_SYSVAR
         +-------------+
UINT ----|ADDR         |
         |             |
 INT ----|VAL          |
         +-------------+

Nota

Se o endereço especificado for inválido ou não suportar escrita, a função atualiza o código de falha do ambiente. Este código de falha pode ser obtido através da função GET_SYSTEM_ERR.

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
ADDR	IN	UINT	0	—	Endereço da variável de sistema a ser definida.
VAL	IN	INT	0	—	Valor a ser atribuído à variável de sistema.

Retorno / Saídas

Nenhum.

Observações

Em caso de falha (endereço inválido ou somente-leitura), a função não sinaliza erro diretamente; consulte GET_SYSTEM_ERR para obter o código de falha do ambiente.

Ver também

GET_SYSTEM_ERR, GET_SYSVAR

Exemplo

Código ST

(* Exemplo de ativação da função dentro da POU *)
(* ... *)
HILS.SET_SYSVAR(ADDR := 58, VAL := -180);   (* define um "Time zone" de -180 minutos para o relógio *)
(* ... *)