MemCom Reference Manual > MemCom ftn Fortran API > Dynamic Memory Manager (DMM) > mcf_dmm_put_set

Name

mcf_dmm_put_set — Copy data to database

Synopsis

subroutine mcf_dmm_put_set(ident,handle,name,type,size,status)

subroutine mcf_dmm_put_subset(ident,handle,name,type,idiv,size,status)

subroutine mcf_dmm_put_set_pos(ident,handle,name,type,pos,size,status)

integer*4 ident
character*(*) name
character*4 type
mcf_size idiv
mcf_size size
integer*4 status

Description

mcf_dmm_put_set copies the content of the object identified by ident to the database. Unlike in older versions of MemCom the database attributes handle, dataset name, and subdivision index or position of the object must be defined before calling this function. However, these attributes need only be defined if the data object has been created in DMM. If the data object has been loaded with mcf_dmm_get_set or mcf_dmm_load_set the attributes are already defined. A compatibility function with older versions of MemCom is provided with mcf_dmm_put_set_compatibility.

Note that the dataset type is defined when mcf_dmm_put_set is called. The dataset type cannot be changed.

Parameters

ident

DMM identifier of object to be stored on database (output).

handle

Handle of database file to which the dataset is to be written (input).

name

Name of dataset to be written to the database file (input). The string may not exceed the maximum dataset name length.

type

Dataset type associated to ident (input). The character buffer must be dimensioned to 4 characters at least. type will be one of I, J, E, C, F, Z. The type is always defined!

idiv

Subset index (input). idiv must be in the range of 1 to the number of subset (row) in the dataset.

size

Number of data elements to be written (input).

ident

DMM identifier returned by the function (output). In case of an error ident remains undefined.

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.