IFFLUSH (HLI function)

From m204wiki
Revision as of 22:55, 12 July 2016 by ELowell (talk | contribs)
Jump to navigation Jump to search

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.