ELowell at 22:06, 12 July 2016

2016-07-12T22:06:09Z

← Older revision		Revision as of 22:06, 12 July 2016
Line 1:		Line 1:
	The conventions used on this page are described in [[HLI: Function ~~call list~~#Function call notation conventions\|Function call notation conventions]].		The conventions used on this page are described in [[HLI: Function summary#Function call notation conventions\|Function call notation conventions]].

	==Summary==		==Summary==

ELowell at 21:06, 11 July 2016

2016-07-11T21:06:14Z

← Older revision		Revision as of 21:06, 11 July 2016
Line 1:		Line 1:
			The conventions used on this page are described in [[HLI: Function call list#Function call notation conventions\|Function call notation conventions]].

	==Summary==		==Summary==

ELowell: Created page with " ==Summary==

Description

The IFCLOSE call (CLOSE FILE) closes a Model 204 file or group that is open, or closes all the Model 204 files or groups that are op..."

2016-07-05T20:48:33Z

Created page with " ==Summary== <dl> <dt>Description</dt> <dd>The IFCLOSE call (CLOSE FILE) closes a Model 204 file or group that is open, or closes all the Model 204 files or groups that are op..."

New page

==Summary==
<dl>
<dt>Description</dt>
<dd>The IFCLOSE call (CLOSE FILE) closes a Model 204 file or group that is open, or closes all the Model 204 files or groups that are open on the thread.</dd>
<dt>Thread type</dt>
<dd>multiple cursor IFSTRT, single cursor IFSTRT</dd>
<dt>IFCALL function number</dt>
<dd>12</dd>
</dl>

==Syntax==

IFCLOSE|IFCLOS(RETCODE,FILE_SPEC)

<dl>
<dt>Compile-only form</dt>
<dd>Not available</dd>
<dt>Execute-only form</dt>
<dd>Not available</dd>
</dl>

Specify the parameters in the syntax order shown above.
<table>
<tr class="head">
<th>Parameter</th>
<th>Description</th>
</tr>
<tr>
<td>RETCODE</td>
<td>[O,i,r] The Model 204 return code is the required first parameter. The code is a binary integer value.</td>
</tr>
<tr>
<td>FILE_SPEC</td>
<td>
[I,s,o] The file specification is an optional input parameter for use only with a multiple cursor IFSTRT thread for specifying the name of a particular Model 204 file or group to be closed. Specify the name as a short character string. If a file or group that is not open is specified, the call is unsuccessful and Model 204 returns a completion code equal to 4.

If the file specification parameter is omitted, IFCLOSE closes all files and groups that are open on the thread.
</td>
</tr>
</table>

==Usage notes==

Use the IFCLOSE call to close files or groups that are open on a thread. IFCLOSE indicates that processing against the file or group for the current request is complete. 

The IFCLOSE call is valid on all types of IFSTRT threads. On a single cursor IFSTRT thread, IFCLOSE closes all files or groups that are open. The action is the same on a multiple cursor IFSTRT thread, unless you specify a particular file or group to be closed.
<blockquote class="note">Notes: In group file context, IFCLOSE ends the transaction only if it results in the closing of a file and all files opened outside of the group have been closed. IFCLOSE does not end the transaction if all files in the group are opened singly.
IFCLOSE causes all saved compilations to be discarded.</blockquote>

==Coding example (COBOL)==
WORKING-STORAGE SECTION.
01 CALL-ARGS.
05 RETCODE PIC 9(5) COMP SYNC.
05 FILESPEC PIC X(5) VALUE "CARS;".
.
.
.
PROCEDURE DIVISION.
.
.
.
CALL "IFCLOSE" USING RETCODE, FILESPEC.

Note: This example illustrates the use of the file specification parameter (FILESPEC), which is available for use only with a multiple cursor IFSTRT thread.

[[Category: HLI functions]]

IFCLOSE (HLI function) - Revision history

ELowell at 22:06, 12 July 2016

ELowell at 21:06, 11 July 2016

ELowell: Created page with " ==Summary== Description The IFCLOSE call (CLOSE FILE) closes a Model 204 file or group that is open, or closes all the Model 204 files or groups that are op..."

ELowell: Created page with " ==Summary==

Description

The IFCLOSE call (CLOSE FILE) closes a Model 204 file or group that is open, or closes all the Model 204 files or groups that are op..."