VMS Help  —  LINK  GSMATCH
    Sets match control parameters for a shareable image and specifies
    the match algorithm. This option allows you to control whether
    executable images that link with a shareable image must be
    relinked each time the shareable image is updated and relinked.

    Format

      GSMATCH=keyword,major-id,minor-id

      GSMATCH=EQUAL,link-time-derived-major-id,link-time-derived-minor-id
      (default)

1  –  Option Values

 keyword

    Identifies the match algorithm used by the image activator.
    Specify one of the following keywords:

    Keyword     Meaning

    EQUAL       Directs the image activator to allow the image to map
                to the referenced shareable image when one condition
                is met:

                o  the major and minor ID for the shareable image, as
                   saved at link time in the image file, are equal to
                   the IDs found in the actual shareable image file
                   at activation time.

    LEQUAL      Directs the image activator to allow the image to map
                to the referenced shareable image when two conditions
                are met:

                o  the major ID for the shareable image, as saved at
                   link time in the image file, is equal to the major
                   ID found in the actual shareable image file at
                   activation time

                o  the minor ID for the shareable image, as saved at
                   link time in the image file, is less than or equal
                   to the minor ID found in the actual shareable
                   image file at activation time.

    ALWAYS      Directs the image activator to unconditionally allow
                the image to map to the referenced shareable image:

                o  regardless of the values of the major and minor
                   ID for the shareable image, as saved at link time
                   in the image file, and the values of the IDs found
                   in the actual shareable image file at activation
                   time.

                   Note that you must still specify values for the
                   major ID and minor ID parameters to satisfy the
                   requirements of the option syntax.

 major-id

    Specifies the major identification number.

 minor-id

    Specifies the minor identification number.

    When a shareable image is created without specifying a GSMATCH=
    option, the linker by default creates one. It sets the EQUAL
    match control and uses portions of the image creation time, as
    a binary value, for the major and minor IDs. In general this
    is sufficient to set a unique value for the IDs each time the
    shareable image is linked. On I64, the linker uses bits 40
    through 54 of the binary time value for the major ID and bits
    8 through 39 for the minor ID. On Alpha and VAX, the linker uses
    bits 32 through 46 of the binary time value for the major ID and
    bits 16 through 31 for the minor ID.
Close Help