Function:     GDS_HANDLE

Purpose:      Obtain a GDS set handle.

Category:     GDS

File:         gdsd_basic.c

Author:       J.P. Terlouw

Use:          CHARACTER GDS_HANDLE (            Return    CHARACTER*(*)
                                     SET,       Input     CHARACTER*(*)
                                     ERR )      Input     INTEGER

              GDS_HANDLE  Returns the set handle.            character*(*)
              SET         Name of set for which the handle is wanted.
              ERR         Error return code.
              
Description:  GDS_HANDLE translates a setname into a 'set handle'.
              A set handle is a special kind of set identifier which
              can be used instead of a set name in every GDS call as long
              as the set is open. The advantage of using a set handle
              instead of a set name is that set handles are more efficient
              because a number of string comparisons can be bypassed.

Updates:      Mar  2, 1994: JPT, Document created.