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

Name

dmmgetfp — Load dataset from database to DMM

Description

dmmgetfp loads a dataset by dataset name from a database to Dynamic Memory and returns an identifier ident pointing to the set. In contrast to the data type of the set in Dynamic Memory can be forced with th required dataset type parameter. 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 dmmgetfp(handle,name,idiv,size,type,reqtype,ident,status)
integer*4 handle
characte*(*) name
integer*4 idiv
integer*4 size
chatacer*4 type
chatacer*4 reqtype
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.

reqtype

Requested dataset type, i.e the data type to which the data will be converted (input). The string must be dimensioned to hold 4 characters. The function accept the following data types: I, J, E, F, D.

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.