IFFLUSH (HLI function): Difference between revisions
No edit summary |
No edit summary |
||
| 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== | ||
Revision as of 22:55, 12 July 2016
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.