res

Name

resdb, resndb, resrdb, reskdb, restdb — Create dataset

Synopsis

subroutine resdb(handle,name,idiv,nw,type,initval,status)
integer*4 handle
character*(*) name
integer*4 idiv
integer*4 size
character*4 type
integer*4 | integer*8 initval
real*4 | real*8 initval
complex real*4 | complex real*8 initval
integer*4 status

subroutine resndb(handle,name,idiv,size,type,initval,status)
integer*4 handle
character*(*) name
integer*4 idiv
integer*4 size
character*4 type
integer*4 | integer*8 initval
real*4 | real*8 initval
complex real*4 | complex real*8 initval
integer*4 status

subroutine resrdb(handle,name,idiv,size,type,initval,status)
integer*4 handle
character*(*) name
integer*4 idiv
integer*4 size
character*4 type
integer*4 | integer*8 initval
real*4 | real*8 initval
complex real*4 | complex real*8 initval
integer*4 status

subroutine reskdb(handle,name,size,status)
integer*4 handle
character*(*) name
integer*4 size
integer*4 status

subroutine restdb(handle,name,size,status)
integer*4 handle
character*(*) name
integer*4 size
integer*4 status

Description

resdb reserves space on the database for a positional dataset of type I, J, E, C, F, or Z, and it initializes the elements of the with a constant value. Sets with sub-divisions must be reserved by dssdb.

resndb performs the same function as resdb, but it does not abort if the set already exists and the requested size is smaller or equal to the existing size. resndb does not re-initialize the dataset with the preset value.

resrdb performs the same function as resndb, but it re-initializes the set with the preset value.

reskdb reserves space on the database for a dataset of type K.

restdb defines a relational dataset. The size of the table is counted in units of integer*4 words (not bytes!). To define a relational dataset with sub-divisions, call the function dsstdb.

Parameters

handle: Database handle (input). The file handle handle may not exceed the maximum number of simultaneously open databases.
name: Name of dataset (input). The string may not exceed the maximum dataset name length.
idiv: Sub-division number (input). Dummy variable.
size: Size of the dataset to be created (input). The size is expressed in data elements. Note that the size of relational tables, i.e datasets of type $, is specified in integer*4 units (i.e 4 times less than the number of bytes) in order to maintain compatibility with version 6 of MemCom.
type: Dataset type of the set to be created (input). Valid dataset types are I, J, E, F, D, and U.
ival: Preset value of a single element of the dataset to be created (input). All elements of the dataset will be initialized to that preset value. Note that the preset value must correspond to the selected data type!
status: Status code returned (output). Upon successful completion of the operation, the status value 0 is returned. A negative value is returned, if an error has been detected. A positive value is returned, if a warning has been issued. See MemCom error codes.