next up previous 207
Next: NDG_GTSUP - Get supplemental information for an NDF
Up: Routines for accessing groups of NDFs
Previous: NDG_CREP1 - Create a single new primitive NDF using a specified parameter


NDG_CREXP - Store the names of a specified group of NDF to be created

Description:
The supplied group expression is parsed (using the facilities of the GRP routine GRP_GROUP, see SUN/150) to produce a list of explicit NDF names. No check is made to see if these NDFs exist or not, and any wild-cards in the NDF names are ignored. The names are appended to the group identified by IGRP. If IGRP has the value GRP__NOID on entry, then a new group is created and IGRP is returned holding the new group identifier.

If IGRP0 holds a valid group identifier on entry, then the group identified by IGRP0 is used as the basis for any modification element contained in the supplied group expression. If IGRP0 holds an invalid identifier (such as GRP__NOID) on entry then modification elements are included literally in the output group.


Invocation:
CALL NDG_CREXP( GRPEXP, IGRP0, IGRP, SIZE, FLAG, STATUS )

Arguments:

GRPEXP = CHARACTER$*$($*$) (Given)
The group expression specifying the NDF names to be stored in the group.
IGRP0 = INTEGER (Given)
The GRP identifier for the group to be used as the basis for any modification elements.
IGRP = INTEGER (Given and Returned)
The GRP identifier for the group to which the supplied NDF names are to be appended.
SIZE = INTEGER (Returned)
The total number of NDF names in the returned group.
FLAG = LOGICAL (Returned)
If the group expression was terminated by the GRP "flag" character, then FLAG is returned .TRUE. Otherwise it is returned .FALSE. Retuned .FALSE. if an error occurs.
STATUS = INTEGER (Given and Returned)
The global status.



next up previous 207
Next: NDG_GTSUP - Get supplemental information for an NDF
Up: Routines for accessing groups of NDFs
Previous: NDG_CREP1 - Create a single new primitive NDF using a specified parameter

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