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

Name

dmmgets — Load dataset from database

Description

dmmgets loads a contiguous slice of a dataset by dataset name from a database to Dynamic Memory and returns an identifier ident pointing to the set. The address of the set in Dynamic Memory can be retrieved with the dmmptr function. Any dataset with the same name and database unit identifier already residing in Dynamic Memory is ignored. Thus, a dataset can be loaded more than once in Dynamic Memory. To avoid loading copies of a dataset, make use of dmmload (observe, however, that dmmload will not load the dataset if it already exists in Dynamic Memory). To create a dataset in Dynamic Memory, make use of dmmres.

Specification (F77)

subroutine dmmgets(handle,name,ipos,size,type,ident,status)
integer*4 handle
characte*(*) name
integer*4 ipos
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.

ipos

Dataset offset. ipos is counted in number of data elements.

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.