NDG_NDFPR - Obtain an NDF identifier for a new NDF created by propagation from an existing NDF

Description:

The routine returns an NDF identifier for a new NDF created by propagation from an existing NDF. The name of the new NDF is held at a given index within a given group. It is equivalent to NDF_PROP.

Invocation:

CALL NDG_NDFPR( INDF1, CLIST, IGRP, INDEX, INDF2, STATUS )

Arguments:

INDF1 = INTEGER (Given)

Identifier for an existing NDF (or NDF section) to act as a template.

CLIST = CHARACTER $*$ ( $*$ ) (Given)

A comma-separated list of the NDF components which are to be propagated to the new data structure. By default, the HISTORY, LABEL and TITLE components and all extensions are propagated.

IGRP = INTEGER (Given)

A GRP identifier for a group holding the names of NDFs. This will often be created using NDG_ASSOC, but groups created "by hand" using GRP directly (i.e. without the supplemental groups created by NDG_ASSOC) can also be used.

INDEX = INTEGER (Given)

The index within the group at which the name of the NDF to be accessed is stored.

INDF2 = INTEGER (Returned)

Identifier for the new NDF.

STATUS = INTEGER (Given and Returned)

The global status.

Notes:

• If this routine is called with STATUS set, then a value of NDF__NOID will be returned for the INDF2 argument, although no further processing will occur. The same value will also be returned if the routine should fail for any reason. The NDF__NOID constant is defined in the include file NDF_PAR.