GRP_GET - Returns a set of names contained in a group

Description:

The names with indices between INDEX and INDEX$+$SIZE-1 (inclusive) contained in the given group are returned. An error is reported if the bounds of the group are exceeded, and STATUS is returned equal to GRP__OUTBN. If the group is case insensitive (as established by a call to GRP_SETCS) then the names are converted to upper case before being returned.

Invocation:

CALL GRP_GET( IGRP, INDEX, SIZE, NAMES, STATUS )

Arguments:

IGRP = INTEGER (Given)

A GRP identifier for the group.

INDEX = INTEGER (Given)

The lowest index for which the corresponding name is required.

SIZE = INTEGER (Given)

The number of names required.

NAMES( SIZE ) = CHARACTER $*$ ( $*$ ) (Returned)

The names held at the given positions in the group. The corresponding character variables should have declared length specified by the symbolic constant GRP__SZNAM. If the declared length is shorter than this, the returned names may be truncated, but no error is reported.

STATUS = INTEGER (Given and Returned)

The global status.