IFFLUSH (HLI function): Difference between revisions
No edit summary |
m (→Usage notes: add link) |
||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
The conventions used on this page are described in [[HLI: Function | The conventions used on this page are described in [[HLI: Function summary#Function call notation conventions|Function call notation conventions]]. | ||
==Summary== | ==Summary== | ||
| Line 43: | Line 43: | ||
Use the IFFLUSH call to control space management for the Model 204 server tables, such as QTBL and STBL, that are occupied by compilations and %variables. You can delete items from storage that are no longer needed and make room for new compilations.</p> | Use the IFFLUSH call to control space management for the Model 204 server tables, such as QTBL and STBL, that are occupied by compilations and %variables. You can delete items from storage that are no longer needed and make room for new compilations.</p> | ||
<p> | <p> | ||
You can use the IFFLUSH call on any type of IFSTRT thread. IFFLUSH is only valid for use with the Compiled IFAM facility. </p> | You can use the IFFLUSH call on any type of IFSTRT thread. IFFLUSH is only valid for use with the [[HLI: IFSTRT processing#Using the compiled IFAM facility|Compiled IFAM facility]]. </p> | ||
===Using IFFLUSH on a multiple cursor IFSTRT thread=== | ===Using IFFLUSH on a multiple cursor IFSTRT thread=== | ||
Latest revision as of 21:21, 25 October 2017
The conventions used on this page are described in Function call notation conventions.
Summary
- Description
- The IFFLUSH call (FLUSH) flushes compilations and %variables from the Model 204 server tables for the current thread.
- Thread type
- multiple cursor IFSTRT, single cursor IFSTRT
- IFCALL function number
- 45
Syntax
IFFLUSH|IFFLSH(RETCODE,NAME_SPEC)
- Compile-only form
- Not available
- Execute-only form
- Not available
Specify the parameters in the syntax order shown above.
| Parameter | Description |
|---|---|
| RETCODE | [O,i,r] The Model 204 return code is a required output parameter. The code is a binary integer value. |
| NAME_SPEC | [I,c,o] The name specification is an optional input parameter which specifies a list of one or more compilation names, or %variables, or both, to be deleted from the server tables. Specify a short character string. Separate names in the list using a comma and end the string with a semicolon.
Note: If the name string is not specified, IFFLUSH deletes all compilations and %variables from the corresponding server tables for the current thread. |
Usage notes
Use the IFFLUSH call to control space management for the Model 204 server tables, such as QTBL and STBL, that are occupied by compilations and %variables. You can delete items from storage that are no longer needed and make room for new compilations.
You can use the IFFLUSH call on any type of IFSTRT thread. IFFLUSH is only valid for use with the Compiled IFAM facility.
Using IFFLUSH on a multiple cursor IFSTRT thread
On a multiple cursor IFSTRT thread, except for IFFTCH, IFUPDT, and IFOCC compilations which may be flushed individually, IFFLUSH does not allow the flushing of individual compilations or %variables.
IFFLUSH flushes everything. If IFFLUSH is coded without a name list (as shown in the example below), it empties the server tables and frees all record sets and CCATEMP pages that are held by the HLI program. On a multiple cursor IFSTRT thread, IFFLUSH operates similarly to an END statement in SOUL.
Coding example (COBOL)
WORKING-STORAGE SECTION. 01 ARGS-FOR-CALL. 05 RETCODE PIC 9(5) COMP SYNC. . . . PROCEDURE DIVISION. . . . CALL "IFFLUSH" USING RETCODE.