gtpc2m4l | C/C++ Language Support User's Guide |
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
- Specifying an invalid parameter results in a system error with
exit.
- The long life entry detection program is inhibited for all programs
calling longc(LONGC_INDEF).
- Specifying integer value n causes the long life entry detection program to
flag the entry as looping if it is still active approximately (n + 1) minutes
later.
- longc(LONGC_INDEF) can be used by an application program to
inhibit long life entry detection for a specific transaction even though it
was enabled by a previous program.
- The long life detection program sends a message to the system operator
whenever an entry is found to have exceeded its maximum life in the
system.
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.