tpf_ecbmc_set_lsetname: Adjust resource limits in the ECB to values in a named limit set

This function adjusts the resource limits in the current entry control block (ECB) to those of a named limit set.

Last updated

#include <tpf/sysapi.h>
int tpf_ecbmc_set_lsetname(char *lsetname)

lsetname: A pointer to a 1- to 8-character string that contains the name of the named limit set of resource limits that you want to set for the ECB.

A value of 0.

A value of -1 is returned if the specified named limit set is not found.

If the resource value is set to zero, the monitoring of that resource is stopped.
If the tpf_ecbmc_set_lsetname function is processed, only the values in the named limit set that have been defined will be set in the ECB..
If the tpf_ecbmc_set_lsetname function is processed and the first level or second level indication has already been met, the tpf_ecbmc_set_lsetname function call does not change the first or second level indication. For example, if the first level for FIND requests is 100 and this ECB has processed 110 FIND requests, the first level was already reached. A tpf_ecbmc_set_lsetname function call now changes the first level for FIND requests to 150. If the ECB reaches 150 FIND requests, the first level action is not processed again.
If an ECB is part of a group ECB resource monitoring set and the ECB issues the tpf_ecbmc_set_lsetname function to change the named limit set, the ECB is removed from the group.
To enable group ECB resource monitoring, the following conditions must be met:
- An ECB issues the tpf_ecbmc_set_lsetname function.
- Group ECB resource monitoring is enabled for the specified named limit set.
- The initial ECB creates a child ECB.

The following example sets the RLT values for the ECB to the current values of the named limit set UTIL0001.

char lsetname[9];

#include <tpf/sysapi.h>
⋮
strcopy (lsetname,"UTIL0001")
rc = tpf_ecbmc_set_lsetname(lsetname);
⋮