This general macro allows an ECB-controlled program to set or reset the
maximum allowed lifetime of the current entry in the system.
Format
Notes:
- symbol1
- label
- A symbolic name can be assigned to the macro statement.
- symbol1
- This specifies the life-time for the ECB.
- INDEF
- ECB may exist indefinitely (long life entry detection will be inhibited
for this entry).
- CLEAR
- Reset long life entry detection fields, the entry will be given a maximum
life (from the time that the LONGC CLEAR was issued) of 1 minute.
- xxx
- From 1 to 254, set the maximum life time of the entry in minutes.
Entry Requirements
R9 must contain the address of the ECB being processed.
Return Conditions
- Control is returned to the instruction following the macro
expansion.
- The condition code and general purpose registers will not be
changed.
Programming Considerations
- The LONGC macro is restricted to ECB-controlled programs.
- The ECB reference register (R9) must contain the address of the ECB
issuing the LONGC macro.
- LONGC CLEAR or LONGC xxx require 8 bytes of storage.
- LONGC INDEF requires 4 bytes of storage.
- The long life entry detection program is inhibited for all entries that do
not issue LONGC CLEAR or LONGC xxx.
- LONGC xxx will cause the long life entry detection program to flag the
entry as "looping" if it is still active in the system approximately
xxx + 1 minutes later.
- LONGC CLEAR is equivalent to LONGC 0 (LONGC 0 is invalid).
- LONGC CLEAR or LONGC xxx should be used to enable long life entry
detection for applications that require this support, preferably by the
application's input message editor.
- LONGC INDEF can be used by an application program to inhibit long life
entry detection for a specific transaction, even though it has been enabled by
a previous program.
- The long life entry detection program sends a message to the system
operator whenever an entry is found to have exceeded its maximum life in the
system.
Examples
None.