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.