P.READ - privileged file read.
Usage:
iostat = p.read( buffer, filecode, sector
[, words, errfnc] );
Where:
- buffer
- is a pointer to the memory location where input data
should be placed.
- filecode
- is the TSS filecode that you wish to read. This will
either be one of TSS's filecodes (e.g. #D) or a filecode
returned by DRL JOUT.
- sector
- is the sector within the file where the reading should
start.
- words
- is the number of words to read. If omitted,
"words" defaults to 320.
- errfnc
- is a function that is called with a PRINTF style call if
there is an I/O error while reading the disk. If omitted,
it defaults to .ERROR, which will terminate the program.
- iostat
- is the negative of the major status from the read. A
non-zero value is only returned if you supply an
"errfunc" that does not terminate the program.
Description:
P.READ allows a privileged TSS program to read from a TSS file
code using DRL PDIO. The function is not available in batch.
See Also:
- expl b syslib p.writ
- for the corresponding write routine.
Copyright © 1996, Thinkage Ltd.