mcf_db_put_set_pos — Write positional dataset to database file (Fortran API)
subroutine mcf_db_put_set_pos(handle,name,pos,size, buffer,status) integer*4 handle character*(*) name mcf_off pos mcf_size size void buffer(size) integer*4 status
mcf_db_put_set_pos
writes
size
data elements of type i, J, E, D, C, or Z
from buffer
to the dataset
name
residing on the database file identified by
handle
, starting at the relative position
pos
. The data set must exist on the database and
it must have the correct number of subsets and the correct
type.
If the dataset type of the dataset name
is
not equal to the requested data type an error is flagged, .e. these
functions do not convert data.
handle
Handle of database file on which the set to be written resides (input).
name
Name of dataset to which data are written (input). The string may not exceed the maximum dataset name length.
pos
Position relative to the beginning of the set from
which data are being written (input).
idiv
must be in the range of 1 to the
number of subsets.
size
Number of data elements to be written (input).
buffer
Data buffer from which data are transferred to the database (input).
status
Status code returned (output). Upon successful completion of the operation, the status value 0 is returned. A negative value is returned if an error has been detected. A positive value is returned if a warning has been issued.