GRP_PUT1 - Put a single name into a group

Description:

The given name is stored in the group in the form in which it is supplied (including any control characters). It overwrites any previous name stored at the specified index. The name can be appended to the end of the group by giving INDEX a value of zero or one greater than the current size of the group. An error is reported if the name is added beyond the end of the group (i.e. if adding the name would result in a gap within the group for which no names would be defined).

Invocation:

CALL GRP_PUT1( IGRP, NAME, INDEX, STATUS )

Arguments:

IGRP = INTEGER (Given)

A GRP identifier for the group.

NAME = CHARACTER $*$ ( $*$ ) (Given)

The name to be stored in the group.

INDEX = INTEGER (Given)

The index at which to store the name. A value of zero causes the names to be appended to the end of the group.

STATUS = INTEGER (Given and Returned)

The global status.