HP 3000 Manuals HP 3000 Manuals
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.
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.
Table 4-9. (cont.)
Bits Value/Meaning
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
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
Intrinsics None
Commands None
Manuals Accessing Files Programmer's Guide (32650-90017)