NDG_ASSO1 - Obtain an identifier for a single existing NDF using a specified parameter

Description:

This routine is equivalent to NDF_ASSOC except that it allows the NDF to be specified using a GRP group expression (for instance, its name may be given within a text file, etc). The first NDF in the group expression is returned. Any other names in the group expression are ignored. Supplemental information describing the separate fields in the NDF specification are also returned.

Invocation:

CALL NDG_ASSO1( PARAM, VERB, MODE, INDF, FIELDS, STATUS )

Arguments:

PARAM = CHARACTER $*$ ( $*$ ) (Given)

Name of the ADAM parameter.

VERB = LOGICAL (Given)

If TRUE then errors which occur whilst accessing supplied NDFs are flushed so that the user can see them before re-prompting for a new NDF ("verbose" mode). Otherwise, they are annulled and a general "Cannot access file xyz" message is displayed before re-prompting.

MODE = CHARACTER $*$ ( $*$ ) (Given)

Type of NDF access required: 'READ', 'UPDATE' or 'WRITE'.

INDF = INTEGER (Returned)

NDF identifier.

FIELDS( 6 ) = CHARACTER $*$ ( $*$ ) (Given)

Each element contains the following on exit:

1. NDF slice specifications
2. HDS paths
3. File types
4. Base file names
5. Directory paths
6. Full NDF specification (this is the returned group - IGRP)

STATUS = INTEGER (Given and Returned)

The global status.