Next: HDS_FLUSH - Flush locator group
Up: ROUTINE DESCRIPTIONS
Previous: HDS_ERASE - Erase container file
HDS_EWILD
- End a wild-card search for HDS container files
- Description:
The routine ends a wild-card search for HDS container files begun
by HDS_WILD, and annuls the wild-card search context used. It
should be called after a wild-card search is complete in order to
release the resources used.
- Invocation:
CALL HDS_EWILD( IWLD, STATUS )
- Arguments:
-
IWLD = INTEGER (Given and Returned)
-
Identifier for the wild-card search context to be annulled, as
returned by HDS_WILD. A value of DAT__NOWLD is returned (as
defined in the include file DAT_PAR).
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
This routine attempts to execute even if STATUS is set on entry,
although no further error report will be made if it subsequently
fails under these circumstances. In particular, it will fail if
the identifier supplied is not initially valid, but this will
only be reported if STATUS is set to SAI__OK on entry.
Next: HDS_FLUSH - Flush locator group
Up: ROUTINE DESCRIPTIONS
Previous: HDS_ERASE - Erase 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