FSETMODE

• Issuing carriage return and line feed to terminal after a terminal read.

• Reporting tape automatic error recovery.

• Guaranteeing chronological order of user program write requests.

• Blocking program execution until physical completion of write requests.

NOTE: FSETMODE is ignored for message files

Syntax

            I16V     U16V
  FSETMODE (filenum, modeflags);

Parameters

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.
	0	Do not change the write queue where this file is being accessed.
	1	Access this file through the serial write queue.
	(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.
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.
	This does not work on MPE/XL with SCSI DDS tape drives. (ASC) Not used for asynchronous serial devices. (KSAM) Set this bit to zero.
0:12	Reserved for the operating system.

Operation Notes

• 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.

• If filenum references a byte stream file.

• If FCHECK intrinsic is called to obtain the error code associated with a CCL condition code.

Condition Codes

Related Information