DTC_GET_CACHE_INFO

Retorna o número de blocos de dados (DIBs) alocados em uma cache de dados e o número total de blocos que ela comporta, indicando no valor de retorno se o dimensionamento da cache está correto. É uma função.

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

Função

        DTC_GET_CACHE_INFO
        +-----------------+
INT ----|CACHE   USED_BLKS|---- INT
        |                 |
        |         TOT_BLKS|---- INT
        +-----------------+

A função avalia a cache informada em CACHE — mantida em memória como uma fila de blocos de dados — e devolve em USED_BLKS o número de blocos em uso e em TOT_BLKS o número total de blocos que a cache comporta. Para mais informações sobre a estrutura da cache consulte Estrutura da cache (CACHE).

Parâmetros

Nome	Direção	Tipo	Dimensão	Padrão	Faixa / Unidade	Descrição
CACHE	IN	INT	[*]	—	—	Cache de dados a ser avaliada, mantida em memória como uma fila de blocos de dados.
USED_BLKS	OUT	INT	—	0	—	Número de blocos atualmente utilizados na cache.
TOT_BLKS	OUT	INT	—	0	—	Número total de blocos que a cache comporta.

Retorno / Saídas

A função retorna um INT:

• SUCCESS (0) — o tamanho da cache está correto para armazenar o número total de blocos retornado em TOT_BLKS.

• FAIL (1) — a cache é maior que o número total de blocos retornado, indicando que há espaço adicional na cache que não será utilizado pela aplicação.

Ver também

DTC_MAN, DTC_HOW_MANY_BLOCKS, DTC_GET_BLOCKS