QueryGPTPkg()

The function is used to query information about a given GPT package.

     Function name: QueryGPTPkg
     Inputs:
          gptpkg => Location of package
          key    => value to query
          type   => used for 'key' equals 'Deps' to specify what type
                    of dependency

     Valid values for 'key' are:
          Name        - Returns a scalar with the name of the package
          Type        - Returns a scalar with the type of the package
          Description - Returns a scalar with the description of the package
          Deps        - Returns an array of name-flavor_type package tuples
                        which are the dependents of the given package.
          Setup_Name  - Returns a scalar with the setup name of the package
                        if one exists, undef otherwise
          Version     - Returns a scalar with the version of the package
          Flavor      - Returns a scalar with the flavor of the package

     * If the 'type' arguement is not set when 'key' equals 'Deps', all 
       dependent packages are returned. Otherwise, only packages of dependency
       type 'type' are returned. Valid values for 'type' are:

          pgm_link, lib_link, data_runtime, doc_runtime, compile,
          pgm_runtime, lib_runtime, rtl_runtime, Setup

       Note that dependency listings are not recursive, the array of tuples
       only includes those dependent package explicitly listed in the package.
       In order to recurse that list, the developer should make repeated calls
       to this function with dependent packages.

Examples:

     my $pkgname = GPTAPI::QueryGPTPkg(gptpkg => "client-1.0.tar.gz", 
                                       key         => "Name");
     my $deppkgs = GPTAPI::QueryGPTPkg(gptpkg => "client-1.0.tar.gz", 
                                       key         => "Deps",
                                       type        => "compile");