GRP_REMOV - Remove all occurrences of a given name from a group

Description:

A new group is created by copying the contents of an existing group, excluding any occurrences of a specified name. Note, a name with a given index in the input group will in general have a different index in the output group. The new group inherits the type, control characters and case sensitivity flag of the old group, but does not inherit any owner/slave relationships (see routine GRP_SOWN). If the input group is no longer required, it should be deleted using GRP_DELET.

Invocation:

CALL GRP_REMOV( IGRP1, NAME, IGRP2, STATUS )

Arguments:

IGRP1 = INTEGER (Given)

A GRP identifier for the input group.

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

The name to be removed. Leading blanks are significant, and case is also significant unless the group has been marked as case insensitive by calling GRP_SETCS.

IGRP2 = INTEGER (Returned)

A GRP identifier for the created group. Returned equal to GRP__NOID if an error occurs.

STATUS = INTEGER (Given and Returned)

The global status.