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.