next up previous
Next: HDS_OPEN - Open container file
Up: ROUTINE DESCRIPTIONS
Previous: HDS_LOCK - Lock container file

HDS_NEW - Create container file   

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

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

Arguments:
FILE = CHARACTER * ( * ) (Given)
Container file name.
NAME = CHARACTER * ( DAT__SZNAM ) (Given)
Object name.
TYPE = CHARACTER * ( DAT__SZTYP ) (Given)
Data type.
NDIM = INTEGER (Given)
Number of dimensions.
DIM = INTEGER( NDIM ) (Given)
Object dimensions (ignored if NDIM is zero).
LOC = CHARACTER * ( DAT__SZLOC ) (Returned)
Object locator.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
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).



next up previous
Next: HDS_OPEN - Open container file
Up: ROUTINE DESCRIPTIONS
Previous: HDS_LOCK - Lock container file

HDS Hierarchical Data System
Starlink User Note 92
R.F. Warren-Smith & M.D. Lawden
23rd February 1999
E-mail:rfws@star.rl.ac.uk

Copyright (C) 1999 Central Laboratory of the Research Councils