Advertisement
INPUT/OUTPUT FUNCTIONS
25.3 -- Device Independent
1/0
Functions
128
The remainder
Or
the IOCB is unchanged.
The sector buffer contains the data
from
the
sectors
read beginning with the
logical sector
whose
number
was
in
IOCLSN.
25.3.9.2
Output logical sectors -- .PUTLS
The
.PUTLS
function writes one or more logical sectors
from a sector buffer to an opened file.
Additional space
ma~
be
allocated
to the file to accommodate the increased space
.,..an
II
i
'T'an"~n-r.
<:.
.
-,---
_
.....
-
..
-_.
The
space
allocation
is
automat i call
y.
The
amount
Or
secondary
allocation
will
depend on the available space;
however, an
attempt
made
to
allocate
the
default number of clusters.
space
is
available
than
the
default~
then
the
available block
~ill
be allocated.
will
be
If
1
es
5
largest
ENTRY PARAMETERS:
x
=
The address of an IOCB which has been
properly reserved and
opened
(1.
e. ,
no
errors
oc~urred)
via the.
RESRV •
and . OPEN functions,
respectively.
IOCDTT must have the
"Sit
bit set
to
one
(sector
lID).
The
mode
rlag (bit
"M") must specify either
the
output
or
the
update
modes
as conrigured
prior to opening the file.
IDCLSN must contain
the
logical
sector
number
that
is
to be written into.
The actual number of sectors
written
depends
on
the
size
of the sector
buffer (see below).
The data sectors
of the file begin with logical sector
zero.
If the
RIB
is to
be
accessed
via
the. PUTLS function,
then IOCLSN
must contain the value
$FFFF.
IOCSBS must contain the starting
address
of
a
sector
buffeT'
containing the
data
to
be
WT'
i tten_
Th
e
sec
tor
burfer
must be an integral number of
sectors
in
size
(see
section
25.3.1.20),
This
buffer
does
not
necessarily have to be the
same
one
used -
to
op
en
th e'
-r
i
1 e.
Th e sec tor
bUrrel' can be in
a
di-r-rerent location
-ror each. PUTLS calli however,
if the
"
sector buffer is to be moved afteT'
a
Page
25-54
Advertisement
