IFFLUSH (HLI function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
m (→‎Usage notes: add link)
 
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.