FSETMODE

NM and CM callable.

Controls the following access modes of files or devices:

               I16V     U16V

   FSETMODE(filenum,modeflags);

filenum

16-bit signed integer by value (required)

Passes the file number of the file whose access modes are to be set.

modeflags

16-bit unsigned integer by value (required)

Passes the access mode option:

Bits

Value/Meaning

15:1

Controls chronological order of user program writes. This mode controls write requests to the file from all writers on the system.

(ASC) Not used for asynchronous serial devices.

(KSAM) Set this bit to zero.




	NOTE: A file placed on the serial write queue remains until the file is purged.

Bits	Value/Meaning
14:1	Controls blocking of program execution until completion of physical write operations. This mode controls writes to `filenum` only from the calling process. 0 Return control to the program from a write request without waiting for completion of the physical write operation 1 Force the program to wait until the physical write operation is completed (the record is posted) (ASC) Not used for asynchronous serial devices. (KSAM) Bit (14:1) only is returned. The possible values are: 1 Activate output verification: All output to the file is verified as physically complete before an `FWRITE, FUPDATE,` or `FREMOVE` intrinsic returns control to the user. When a logical record is written, a CCE (`2`) condition is returned. 0 Deactivate output verification: Output is not verified.
13:1	Controls issuing line feed to a terminal after each terminal read. 0 Issue a line feed at the completion of each read from a terminal. 1 Inhibit issuance of a line feed at the completion of each read from a terminal. (KSAM) Set this bit to zero.
12:1	Reporting tape device automatic error recovery. 0 Do not report automatic error recovery on a tape device. 1 Report tape device automatic error recovery by returning CCL (`1`) to `FREAD` and `FWRITE`. (ASC) Not used for asynchronous serial devices. (KSAM) Set this bit to zero.
0:12	Reserved for the operating system

There are two ways to service a program's write request to a file:

In an order that maximizes overall system throughput, using the normal write queue.
In the order that the program requested the writes, using the serial write queue. Write requests placed on the serial write queue are guaranteed to be completed in chronological order.

FSETMODE intrinsic fails with a CCL condition:

If filenum references a byte stream file.
If FCHECK intrinsic is called to obtain the error code associated with a CCL condition code.

Technical documentation