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

Name

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

Synopsis

subroutine mcf_db_put_set(handle,name,type,size,buffer,status)

subroutine mcf_db_put_set_char(handle,name,buffer,status)

subroutine mcf_db_put_subset(handle,name,type,idiv,size,buffer,status)

subroutine mcf_db_put_subset_char(handle,name,idiv,buffer,status)

integer*4 handle
character*(*) name
character*(*) type
mcf_off idiv
mcf_size size
void buffer(size)
integer*4 status

Description

mcf_db_put_set writes size data elements of type I, J, E, F, C, Z from buffer to the positional dataset name residing on the database file identified by handle. mcf_db_put_set_char writes the complete Fotran character string buffer to the positional dataset name residing on the database file identified by handle. If the dataset does not exist on the database, it is created with size data elements (mcf_db_put_set only).

mcf_db_put_subset writes size data elements of type I, J, E, F, C, Z from buffer to the idiv-th subset of the positional dataset name residing on the database file identified by handle. mcf_db_put_subset_char writes the complete Fotran character string buffer to to the idiv-th subset of the positional dataset name residing on the database file identified by handle.The dataset name must exist on the database.

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.

type

Data type of data to be written (input).

idiv

Subdivision number of dataset to which data are written (input). idiv must be in the range of 1 to the number of subsets of the dataset.

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.