dmmres — Create dataset
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.
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
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.
typeDataset type (input), must be I,
E, F, or
D.
sizeLogical number of data elements to be reserved (input).
identDMM 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.