3.5 AIFCLOSE

	MPE documents
	Complete PDF
	Table of Contents
	Index
⇓ Page Bottom
Syntax
Parameters
Operation Notes

⇑ Page Top

Syntax

            REC             I16          I16          I16
 AIFCLOSE ( overall_status, file_number, disposition, sec_code,

            I32
            user_id );
  

Parameters

overall_status

record by reference (required)

Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning. Refer to appendix A for meanings of status values.

Record type: status_type (Refer to appendix B.)

file_number

16-bit signed integer by value (required)

Passes the file number of the file to be closed.

disposition

16-bit signed integer by value (required)

Passes the disposition of the file, valid only for files on disk and magnetic tape. This disposition can be overridden by a file equation.

The disposition options are defined as follows:

Bits(0:12) Reserved for MPE/iX. Set to zero.

Bit (12:1) Disk Space

0	Do not return disk space beyond file EOF.
1	Return disk space beyond file EOF.

Bits (13:3) File domain

000	No change
001	Permanent file
010	Temporary file (rewound)
011	Temporary file (not rewound)
100	Released file

Refer to the description of the FCLOSE intrinsic in the MPE/iX Intrinsics Reference Manual (32650-90028) for more information about this parameter.

sec_code

16-bit signed integer by value (required)

Passes the type of security initially applied for new permanent files.

0	Unrestricted access.
1	Private file creator security.

user_id

32-bit signed integer by value (optional)

The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. If it is not passed, the caller must have previously called AIFACCESSON.

Default: 0