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

Name

dmmres — Create dataset

Description

dmmres creates a dataset with nw data elements in the Dynamic Memory buffer. It performs the same operation as dmmall, but the database manager attributes (unit, name, type) are defined upon creation of the DMM dataset. The size of the dataset is specified in data elements, as opposed to dmmall, where the size is specified in integer*4 words. The identifier ident identifies the portion of allocated memory and it is tied to the allocated memory until the memory is explicitly released. Re-allocation preserves the identifier, although the allocated memory may reside somewhere else in the memory stack. Thus, reference to the allocated memory must always be made by the offset function dmmptr(ident) which is located in the include file memcom.ins.

Specification (F77)

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

type

Dataset type (input), must be I, E, F, or D.

size

Logical number of data elements to be reserved (input).

ident

DMM 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.