GET_GLOBAL_SELECT

  Fetches information, to be used by TPU or an application layered on
  TPU, about the global selection you specify.

  Syntax

     {integer |
      string  |
      array   |
     UNSPECIFIED} := GET_GLOBAL_SELECT ({PRIMARY | SECONDARY | selection_name},
                                         selection_property)

  Parameters

     integer              The value of the specified global selection
                          property.  The global selection owner returns the
                          value to TPU as an integer if the value is of
                          type integer.

     string               The value of the specified global selection
                          property.  The global selection owner returns the
                          value to TPU as a string if the value is of
                          type string.

     array                An array passing information about a global
                          selection whose contents describe information that
                          is not of a data type supported by TPU.  For
                          example, the array could return information about
                          a pixmap, an icon, or a span.  For more
                          information about the contents of the returned
                          array, see the documentation for DECwindows
                          TPU.

     UNSPECIFIED          A data type indicating that the information
                          requested by the layered application was not
                          available.

     PRIMARY              A keyword indicating that the layered application
                          is requesting information about a property of the
                          PRIMARY global selection.

     SECONDARY            A keyword indicating that the layered application
                          is requesting information about a property of the
                          SECONDARY global selection.

     selection_name       A string identifying the global selection whose
                          property is the subject of the layered
                          application's information request.  Specify the
                          selection name as a string if the layered
                          application needs information about a selection
                          other than the PRIMARY or SECONDARY global
                          selection.

     selection_property   A string specifying the property whose value the
                          layered application wants to know.

  Example

     The following statement fetches the text in the primary global
     selection and assigns it to the variable "string_to_paste".

     string_to_paste := GET_GLOBAL_SELECT (PRIMARY, "STRING");