Using KSAM/XL and KSAM 64 (32650-90886)

Chapter 9 77
KSAM Intrinsics
FCONTROL
FCONTROL
Performs various control operations on a file or on the device where the file resides,
including:
• Verifying I/O.
• Reading the hardware status word for the device where the file resides.
• Setting a terminal's timeout interval.
• Repositioning a file at its beginning.
• Writing an end-of-file marker.
Syntax
I16V I16V *
FCONTROL(
filenum,itemnum,item );
Parameters
filenum 16-bit signed integer by value (required)
Passes the file number of the file for which the control operation is to be
performed.
itemnum 32-bit signed integer by value (required)
Specifies which operation is to be performed. (Refer to Table 9-1.)
item type varies (required)
Passes/returns a value associated with a control operation as indicated by
the corresponding
itemnum parameter. (Refer to Table 9-1.)
This parameter is ignored, but must be specified to satisfy internal
requirements.
Table 9-1. FCONTROL Itemnum/Item Values
Itemnum Mnemonic Item Description
0 U16 General device control:
The value specified is passed to the appropriate device driver. A value
from the driver is returned in item . Not valid for spooled device files.
Not applicable to KSAM files.
1 U16 Carriage control (CCTL):
Not applicable to KSAM files.