Instructs the Linker to search for an options file with the specified file name. Linker options files are useful for sophisticated Linker operations requiring long argument lists or for options only available from an options file. You can specify more than one options file with the LINK command.

By default, the Linker assumes option files have an extension of .OPT.

The CLUSTER link option is important because its third parameter allows you to define the page-fault-cluster (pfc) for parts of your image. The pfc parameter sets the number of pages to transfer into central memory on a page fault. If the image doesn't contain page-fault-cluster information, the SYSGEN parameter PFCDEFAULT determines the page-fault-cluster size. PFCDEFAULT defaults to a value appropriate for the utilities supplied with VMS. Because of the density of generated code, a typical GT.M application exhibits smaller regions of locality than most VMS utilities. Therefore, investigate whether adjusting the page-fault-cluster for one or more of your production images provides a performance benefit.

If your application is fairly straightforward, use GTMCOLLECT.OPT as your options file. If you need to include your own options file, use GTMCOLLECT.OPT as a guide to the technique for controlling the page fault cluster size. If you create an options file other than GTMCOLLECT.OPT, include it in the Linker argument list with the /OPTION qualifier.

At the first appropriate place in the file, include the cluster options:

        cluster=code,,12,
        cluster=lits,,20,
          

The numbers 12 and 20 are examples, and should be replaced by numbers that your system manager determines provide you with the maximum performance benefit for your application(s).

Near the end of the file include the collect options:

        collect=code,gtm$code
        collect=lits,gtm$literals
          

For a detailed description of option files, refer to the "Options File" chapter in the VMS Linker Reference Manual.