Description:
The group
is searched for the given name, starting at the name with index given by START, and continuing to the
end of the group. If it is found then the corresponding index within the group is returned. If it is not
found, the index is set to zero, but no error status is generated. The search is case sensitive unless
GRP_SETCS has been called to indicate that the group is case insensitive. If the section of the group
searched contains the name more than once then the lowest index is returned.
Invocation
CALL
GRP_INDEX( NAME, IGRP, START, INDEX, STATUS )
Arguments
NAME = CHARACTER
(
)
(Given)
The name to be searched for.
IGRP = INTEGER (Given)
A GRP identifier for the group to
be searched.
START = INTEGER (Given)
The lowest index to be checked.
INDEX = INTEGER
(Returned)
The index of the name within the group. This number is greater than or equal to START if
the name is found, and zero if it is not found.
STATUS = INTEGER (Given and Returned)
The
global status.