MemCom Reference Manual > MemCom (Old) Fortran77 API > The Dynamic Memory Manager (DMM) > dmmload

Name

dmmload — Load dataset from database

Description

dmmload loads a dataset by data set name from a database to the dynamic memory and returns an identifier ident pointing to the set. The address of the set in memory can be retrieved with the dmmptr function. The set is not loaded from the database if the dataset with the same dataset name already exists in dynamic memory. Instead, the identifier pointing to the set in dynamic memory is returned. To force loading of a set make use of dmmget . To reserve space for a dataset in the Dynamic Memory only, make use of dmmres.

Specification (F77)

subroutine dmmload(handle,name,idiv,size,type,ident,status)
integer*4 handle
characte*(*) name
integer*4 idiv
integer*4 size
chatacer*4 type
integer*4 ident
integer*4 status

Parameters

handle

Database handle (input). The file handle handle may not exceed the maximum number of simultaneously open databases.

name

Dataset name (input). The string may not exceed the maximum dataset name length.

idiv

Subdivision number (input). Ignored if dataset is not assigned to a database by setting handle to 0.

size

Number of data elements to be transferred (input/output). If nw is set to 0 upon input the effective dataset size is returned in nw.

type

Dataset type (input/output). The string must be dimensioned to hold 4 characters. The function accepts the following data types: I, J, E, F, D. If type is set to blank on input the actual precision of the dataset on the database is returned in type.

ident

DMM dataset identifier returned (output).

status

Status code returned (output). A value of 0 indicates normal completion of the operation. A negative value indicates an error. A positive value indicates a warning. See MemCom error codes.