 |
» |
|
|
|
Allows files to be saved across account boundaries.
Syntax | |
REC I16 I16 I16 I32
AIFCLOSE (overall_status, file_number, disposition, sec_code, 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
Operation Notes | |
If AIFCLOSE fails, either a bad file number was specified, another file
with the same name already exists, an illegal disposition (5,6,7) was passed,
or any outstanding write I/Os may have failed. Use FCHECK to determine the
reason AIFCLOSE failed.
|
