J.WRITE - write absolute disk.

Usage:

iostat = j.write( buffer, device, sector
                 [, words, errfnc] );

Where:

buffer

is a pointer to where the data is to be written from.

device

defines the device to write to. "device" can either be the BCD device name (e.g. `st1`), or it can be the negative of the SCT address of the device.

sector

is the sector where the write starts.

words

is the number of words to write. If omitted, "words" defaults to 320.

errfnc

is called with a PRINTF style call if there is an I/O error while writing the disk. If omitted, it defaults to .ERROR, which will terminate the program.

iostat

is the negative of the major status from the write. A non-zero value is only returned if an "errfnc" is supplied that does not terminate the program.

Description:

J.WRITE allows a privileged program to write any portion of an online disk except the label sectors (llink 0).

In TSS, there are restrictions on the JOUT PAT used for the actual write. Because of this, J.WRITE may issue several shorter writes to satisfy an single call to J.WRITE.

See Also:

expl b syslib jio

for an overview of the JIO routines.

Copyright © 2000, Thinkage Ltd.