gtpc2m4lC/C++ Language Support User's Guide

longc-Set Entry Maximum Existence Time

This function allows the ECB-controlled program to set or reset the maximum allowed lifetime of the current entry in the system.

Format

#include   <tpfapi.h>
void longc(unsigned int longc_req);

longc_req
One of the following, specifying the lifetime for the ECB:

LONGC_INDEF
requests that the ECB be allowed to exist indefinitely.

LONGC_CLEAR
requests that the long life entry detection fields be reset. The entry is given a maximum life of one additional minute.

n
where n is an integer in the range of 1-254, indicating the desired maximum lifetime of the entry in minutes.

Normal Return

Void.

Error Return

Not applicable.

Programming Considerations

Examples

The following example requests long life ECB detection to be inhibited for the current entry.

#include <tpfapi.h>

  ·
  ·
  ·
longc(LONGC_INDEF); /* Inhibit long life entry detection */

Related Information

None.