MemCom Reference Manual > MemCom ftn Fortran API > Database Manager (DB) > mcf_db_put_set_pos

Name

mcf_db_put_set_pos — Write positional dataset to database file (Fortran API)

Synopsis

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

Description

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.

Parameters

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.