FSETMODE

NM and CM callable.

Controls the following access modes of files or devices:

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.

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.

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

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.

Condition Codes

CCE (2): Request granted.
CCG (0): Not returned.
CCL (1): Request denied. An error occurred.

Related Information

Manual: Accessing Files Programmer's Guide

FSETMODE

Technical documentation

» Table of Contents

» Index

Syntax

Parameters

Operation Notes

Condition Codes

Related Information