 | |  |  |  |  |
| | | | | |
dmmget — Load dataset from database
dmmget loads a dataset by data set 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.
subroutine dmmget(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
handleDatabase handle (input). The file handle
handle may not exceed the maximum number of
simultaneously open databases.
nameDataset name (input). The string may not exceed the maximum dataset name length.
idivSubdivision number (input). Ignored if the dataset is
not assigned to a database by setting
handle to 0.
sizeNumber of data elements to be transferred
(input/output). If nw is set to 0 upon
input the effective dataset size is returned in
nw.
typeDataset 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.
identDMM dataset identifier returned (output).
statusStatus 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.