Next: NDG_NDFAS - Obtain an NDF identifier for an existing NDF
Up: Routines for accessing groups of NDFs
Previous: NDG_GTSUP - Get supplemental information for an NDF
NDF_MOREG
- Search for NDFs within the extensions of a supplied NDF
- Description:
- Each extension within the supplied NDF is searched to see if it
contains any NDFs. The paths to any such NDFs are appended to the
end of the supplied group (a new group is created if none is
supplied). NDF identifiers for particular members of the group can
be obtained using NDG_NDFAS.
- Invocation:
- CALL NDF_MOREG( INDF, IGRP, SIZE, STATUS )
- Arguments:
-
-
INDF = INTEGER (Given)
-
The identifier for the NDF to be searched.
-
IGRP = INTEGER (Given and Returned)
-
The identifier of the group in which NDF names are to be
stored. A new group is created if the supplied value is GRP__NOID.
It should be deleted when no longer needed using GRP_DELET.
-
SIZE = INTEGER (Returned)
-
The total number of NDF names in the returned group IGRP.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
- Each element in the returned group contains a full specification
for an NDF. Several other groups are created by this routine, and
are associated with the returned group by means of a GRP "owner-slave"
relationship. These supplemental groups are automatically deleted
when the returned group is deleted using GRP_DELET. The returned
group should not be altered using GRP directly because corresponding
changes may need to be made to the supplemental groups. Routines
NDG_SETSZ, NDG_GTSUP and NDG_PTSUP are provided to manipulate the
entire chain of groups. The full chain (starting from the head) is
as follows:
- NDF slice specifications
- HDS paths
- File types
- Base file names
- Directory paths
- Full NDF specification (this is the returned group IGRP)
Next: NDG_NDFAS - Obtain an NDF identifier for an existing NDF
Up: Routines for accessing groups of NDFs
Previous: NDG_GTSUP - Get supplemental information for an NDF
NDG [1ex
Starlink User Note 2
D.S. Berry
M.B. Taylor
22nd October 2009
E-mail:ussc@star.rl.ac.uk
Copyright © 2000 Council for the Central Laboratory of the Research Councils