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