SET_SECURITY_ATB

Define o valor do atributo de segurança associado ao grupo especificado, bloqueando os comandos de comunicação vinculados ao grupo conforme a restrição programada. É uma função.

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

Função

         SET_SECURITY_ATB
         +-------------+
USINT ---|GROUP        |--- INT
         |             |
USINT ---|ATB          |
         +-------------+

A função grava, no grupo indicado por GROUP, o atributo de segurança ATB. Os valores de atributo possíveis são:

Valor	Descrição
0	Grupo sem restrição de segurança.
1	Grupo com restrição de segurança liberada por senha.
3	Grupo com restrição de segurança e sem liberação por senha.

Para consultar os grupos e os atributos de segurança disponíveis, acesse Recursos de segurança da aplicação.

Importante

Ao definir um atributo com restrições de segurança, será bloqueado qualquer comando de comunicação associado ao grupo especificado. Na tentativa de comunicação, o mestre que enviou o comando obtém o código de retorno “Comando recusado por restrições de segurança” (HILS.CO_CMD_DENIED).

No caso da utilização de restrições aos comandos de leitura e escrita na base exportada (grupos 2 e 3), na tentativa de comunicação o mestre que enviou o comando obtém o código de retorno “Falha na execução do comando pelo equipamento remoto”.

Nota

Se o equipamento não suportar o recurso de Recursos de segurança da aplicação, a função falha e retorna HILS.RE_NOT_AVA.

Se o número do grupo for inválido ou o atributo for inválido, a função falha e retorna HILS.GL_INV_PAR.

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
GROUP	IN	USINT	—	—	Grupo de segurança associado.
ATB	IN	USINT	—	0, 1, 3	Atributo de bloqueio programado (ver tabela de valores).

Códigos de retorno

A função retorna um INT com o código de resultado. Use os identificadores com o namespace HILS (ex.: HILS.RE_NOT_AVA). Códigos mais comuns desta função:

Código	Identificador	Significado
0	SUCCESS	Atributo de segurança gravado com sucesso.
5	GL_INV_PAR	Número do grupo ou atributo inválido.
24	RE_NOT_AVA	Recurso de segurança não disponível no equipamento.

Lista completa dos códigos de retorno: RET_CODE - Códigos de retorno do firmware G5.

Retorno / Saídas

• INT — código de retorno (zero se sucesso; diferente de zero indica falha).

Pré-condições

• O equipamento deve suportar o recurso Recursos de segurança da aplicação.

• GROUP e ATB devem ser valores válidos.

Observações

• Estão disponíveis na Biblioteca HI_STD dois tipos de dados enumeradores que facilitam a definição de flags associados aos grupos e atributos de segurança; para mais informações acesse Definição de recursos de segurança via flag.

Ver também

GET_SECURITY_ATB

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    ATB : USINT; (* Atributo do grupo obtido *)
END_VAR

(* Exemplo de ativação da função dentro da POU *)

HILS.SET_SECURITY_ATB(GROUP := 4, ATB := 1); (* Habilita segurança do grupo 4 com liberação via senha *)
(* ... *)
ATB := HILS.GET_SECURITY_ATB(GROUP := 4);    (* retorna o atributo de segurança do grupo 4 *)
(* ... *)