next up previous
Next: HDS_ERASE - Erase container file
Up: ROUTINE DESCRIPTIONS
Previous: DAT_WHERE - Find position of primitive in HDS file

HDS_COPY - Copy an object to a new container file   

Description:
The routine makes a copy of an HDS object, placing the copy in a new container file (which is created), as the top-level object. The copying operation is recursive; i.e. all sub-components of a structure will also be copied.

Invocation:
CALL HDS_COPY( LOC, FILE, NAME, STATUS )

Arguments:
LOC = CHARACTER * ( DAT__SZLOC ) (Given)
Locator for the object to be copied.
FILE = CHARACTER * ( * ) (Given)
Name of the new container file to be created.
NAME = CHARACTER * ( * ) (Given)
Name which the new top-level object is to have.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • This routine attempts to eliminate unused space during the copying operation and is therefore a useful method of compressing a container file from which components have been deleted.
  • The routine may be used to copy both primitive and structured objects, but cannot be used to make a copy of a cell or a slice.



next up previous
Next: HDS_ERASE - Erase container file
Up: ROUTINE DESCRIPTIONS
Previous: DAT_WHERE - Find position of primitive in HDS 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