Create a new container file and return a primary locator to the top-level object.

CALL HDS_NEW( FILE, NAME, TYPE, NDIM, DIM, LOC, STATUS )

FILE = CHARACTER $\ast$ ( $\ast$ ) (Given)

NAME = CHARACTER $\ast$ ( DAT__SZNAM ) (Given)

TYPE = CHARACTER $\ast$ ( DAT__SZTYP ) (Given)

NDIM = INTEGER (Given)

DIM = INTEGER( NDIM ) (Given)

LOC = CHARACTER $\ast$ ( DAT__SZLOC ) (Returned)

STATUS = INTEGER (Given and Returned)

If a file extension is not specified, ‘.sdf’ is used. If type matches one of the HDS primitive type names a primitive of that type is created, otherwise the object is assumed to be a structure. If the top-level object is a structure array, loc will be associated with the complete array, not the first cell. Thus, new components can only be created through another locator which is explicitly associated with an individual cell (see DAT_CELL).