GRP_SETCS

Establish the case sensitivity of a group

Description:

When a group is created using GRP_NEW, it is initially case sensitive. This routine can be called to make it case insensitive, or to make it case sensitive again.

All names stored within a case sensitive group are used in the same form as they were supplied by the environment or application. If the group is case insensitive the upper case equivalent is used when any reference is made to a name stored within the group, and all comparisons between strings (such as performed within routines GRP_INDEX and GRP_PURGE for instance) related to that group are performed without reference to case.

Note, names are always stored in the form they are given. Any case conversion takes place when the names are read out of the group, not when they are put into the group. This means that groups can be changed at any time from being case insensitive to being case sensitive (or vice-versa).

Invocation

CALL GRP_SETCS( IGRP, SENSIT, STATUS )

Arguments

IGRP = INTEGER (Given)
A GRP identifier for the group.
SENSIT = LOGICAL (Given)
If .TRUE. then the group is made case sensitive. If .FALSE., then the group is made case insensitive.
STATUS = INTEGER (Given and Returned)
The global status.