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.